You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+40-18Lines changed: 40 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,28 +17,47 @@ It can currently create and modify:
17
17
- Totem Tops
18
18
- Consumable Items
19
19
- Gramophone Tracks
20
+
- Slot Modifications
20
21
- Talking Cards
21
22
- Custom Costs
23
+
- Custom Rulebook Pages
24
+
- Rulebook Redirects/Hyperlinks
22
25
- And much more!
23
26
24
27
Additionally, a number of quality-of-life patches from the community are included with each release.
25
28
26
-
## Installation (automated)
27
-
This is the recommended way to install the API on the game.
28
-
29
-
- Download and install [Thunderstore Mod Manager](https://www.overwolf.com/app/Thunderstore-Thunderstore_Mod_Manager) or [r2modman](https://timberborn.thunderstore.io/package/ebkr/r2modman/).
30
-
- Click the **Install with Mod Manager** button on the top of [BepInEx's](https://thunderstore.io/package/download/BepInEx/BepInExPack_Inscryption/5.4.1902/) page.
31
-
- Run the game via the mod manager.
32
-
33
-
## Installation (manual)
34
-
To install this plugin first you need to install BepInEx as a mod loader for Inscryption. A guide to do this can be found [here](https://docs.bepinex.dev/articles/user_guide/installation/index.html#where-to-download-bepinex). Inscryption needs the 86x (32 bit) mono version.
35
-
You also need to install [MonoMod Loader Inscryption](https://inscryption.thunderstore.io/package/BepInEx/MonoMod_Loader_Inscryption/).
36
-
37
-
- Copy the 'plugins' folder into 'BepInEx/plugins'.
38
-
- Copy the 'monomod' folder into 'BepInEx/monomod'.
39
-
(If any of these folders do not exist, just create them.)
40
-
41
-
An example Mod utilising this plugin can be found [here](https://github.com/debugman18/InscryptionExampleMod).
29
+
### Installing with a Mod Manager (recommended)
30
+
1. Download and install [Thunderstore Mod Manager](https://www.overwolf.com/app/Thunderstore-Thunderstore_Mod_Manager) or [r2modman](https://Timberborn.thunderstore.io/package/ebkr/r2modman/).
31
+
2. Click the **Install with Mod Manager** button on the top of [BepInEx's](https://thunderstore.io/package/download/BepInEx/BepInExPack_Inscryption/5.4.1902/) page.
32
+
3. Run the game via the mod manager.
33
+
34
+
### Installing Manually
35
+
1. Install [BepInEx](https://thunderstore.io/package/download/BepInEx/BepInExPack_Inscryption/5.4.1902/) by pressing 'Manual Download' and extract the contents into a folder. **Do not extract into the game folder!**
36
+
2. Move the contents of the 'BepInExPack_Inscryption' folder into the game folder (where the game executable is).
37
+
3. Run the game. If everything was done correctly, you will see the BepInEx console appear on your desktop. Close the game after it finishes loading.
38
+
4. Install [MonoModLoader](https://inscryption.thunderstore.io/package/BepInEx/MonoMod_Loader_Inscryption/) and extract the contents into a folder.
39
+
5. Move the contents of the 'patchers' folder into 'BepInEx/patchers' (If any of the mentioned BepInEx folders don't exist, just create them).
40
+
6. Install [Inscryption API](https://inscryption.thunderstore.io/package/API_dev/API/) and extract the contents into a folder.
41
+
7. Move the contents of the 'plugins' folder into 'BepInEx/plugins' and the contents of the 'monomod' folder into the 'BepInEx/monomod' folder.
42
+
8. Run the game again. If everything runs correctly, a message will appear in the console telling you that the API was loaded.
43
+
44
+
### Installing on the Steam Deck
45
+
1. Download [r2modman](https://Timberborn.thunderstore.io/package/ebkr/r2modman/) on the Steam Deck’s Desktop Mode and open it from its download using its `AppImage` file.
46
+
2. Download the mods you plan on using and their dependencies..
47
+
3. Go to the setting of the profile you are using for the mods and click `Browse Profile Folder`.
48
+
4. Copy the BepInEx folder, then go to Steam and open Inscryption's Properties menu
49
+
5. Go to `Installed Files` click `Browse` to open the folder containing Inscryption's local files; paste the BepInEx folder there.
50
+
6. Enter Gaming Mode and check 'Force the use of a specific Steam Play compatibility tool' in the Properties menu under `Compatibility`.
51
+
7. Go to the launch parameters and enter `WINEDLLOVERRIDES=“winhttp.dll=n,b” %command%`.
52
+
8. Open Inscryption. If everything was done correctly, you should see a console appear on your screen.
53
+
54
+
### Mac & Linux
55
+
1. Follow the steps here first: [Installing BepInEx](https://docs.bepinex.dev/articles/user_guide/installation/index.html?tabs=tabid-nix)
56
+
2. Next do steps 4-8 of the Manual Installation
57
+
3. Your game should be setup for inscryption modding now
58
+
59
+
An example mod utilising this plugin can be found [here](https://github.com/debugman18/InscryptionExampleMod),
60
+
and the modding wiki and documentation can be found [here](https://inscryptionmodding.github.io/InscryptionAPI/wiki/index.html).
42
61
43
62
## Modded Save File
44
63
With this API installed, an additional 'modded save file' will be created by the game. This file will be found in the 'BepInEx' subdirectory, and contains all save data created by mods that use this API. This file will not automatically be synced to the cloud by Steam.
@@ -76,7 +95,7 @@ Displays targets for attacks made with the sniper sigil in Act 1.
76
95
## Act 1 Sentry Fixes by WhistleWind
77
96
Fixes a number of bugs caused by the Sentry ability being used in Act 1.
78
97
79
-
## Multi-Act Sigil Compatability Fixes by WhistleWind
98
+
## Multi-Act Sigil Compatibility Fixes by WhistleWind
80
99
Fixes a number of sigils to be usable in all Acts. Sigils include: Mental Gemnastics, Tidal Lock, Hoarder, Vessel Printer, Amorphous, Handy.
81
100
82
101
## Fledgling Sigil Fixes by WhistleWind
@@ -85,6 +104,9 @@ Fixes Fledgling in Act 2 to show the correct number of turns until a card evolve
85
104
## OverridePixelAbilityIcons by WhistleWind
86
105
Fixes the OverrideAbilityIcon method to work in Act 2.
87
106
107
+
## Temporary Mod Fixes by WhistleWind
108
+
- Fixes issues related to using temporary mods in Act 2 or to add custom decals
109
+
88
110
# Using the API
89
111
90
112
Inscryption API 2.0 tries to have you use the original game's objects as much as possible. For example, there are no more 'NewCard' and 'CustomCard' objects; instead, you are responsible to create CardInfo objects yourself and add them.
@@ -97,7 +119,7 @@ For more information, please check out the wiki: https://inscryptionmodding.gith
97
119
### How can you help?
98
120
Use the plugin and report bugs you find! Ping us on the [Inscryption Modding Discord](https://discord.gg/QrJEF5Denm) server in the api channel with what you find.
99
121
100
-
### But really, I want to help develop this mod
122
+
### But really, I want to help develop this mod!
101
123
Great! We're more than happy to accept help. Either make a pull request to the API's [GitHub page](https://github.com/InscryptionModding/InscryptionAPI) or come join us over in the [Inscryption Modding Discord](https://discord.gg/QrJEF5Denm).
0 commit comments