|
| 1 | + |
| 2 | +# API |
| 3 | +## Inscryption API made by Cyantist |
| 4 | + |
| 5 | +This plugin is a BepInEx plugin made for Inscryption as an API. |
| 6 | +It can currently: |
| 7 | +- Create custom cards and inject them into the card pool |
| 8 | +- Modify existing cards in the card pool |
| 9 | +- Create custom abilities and inject them into the ability pool |
| 10 | +- Create custom regions |
| 11 | + |
| 12 | +## Installation (automated) |
| 13 | +This is the recommended way to install the API on the game. |
| 14 | + |
| 15 | +- Download and install [Thunderstore Mod Manager](https://www.overwolf.com/app/Thunderstore-Thunderstore_Mod_Manager) or [r2modman](https://timberborn.thunderstore.io/package/ebkr/r2modman/) |
| 16 | +- Click Install with Mod Manager button on top of the [page](https://inscryption.thunderstore.io/package/BepInEx/BepInExPack_Inscryption/) |
| 17 | +- Run the game via the mod manager |
| 18 | + |
| 19 | +## Installation (manual) |
| 20 | +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. |
| 21 | + |
| 22 | +To install Inscryption API you simply need to copy **API.dll** from [releases](https://github.com/ScottWilson0903/InscryptionAPI/releases) to **Inscryption/BepInEx/plugins**. |
| 23 | + |
| 24 | +An example Mod utilising this plugin can be found [here](https://github.com/ScottWilson0903/InscryptionExampleMod). |
| 25 | + |
| 26 | +## Debugging |
| 27 | +The easiest way to check if the plugin is working properly or to debug an error is to enable the console. This can be done by changing |
| 28 | +``` |
| 29 | +[Logging.Console] |
| 30 | +\## Enables showing a console for log output. |
| 31 | +\# Setting type: Boolean |
| 32 | +\# Default value: false |
| 33 | +Enabled = false |
| 34 | +``` |
| 35 | +to |
| 36 | +``` |
| 37 | +[Logging.Console] |
| 38 | +\## Enables showing a console for log output. |
| 39 | +\# Setting type: Boolean |
| 40 | +\# Default value: false |
| 41 | +Enabled = true |
| 42 | +``` |
| 43 | +in **Inscryption/BepInEx/Config/BepInEx/cfg** |
| 44 | +___ |
| 45 | +If you want help debugging you can find me on the [Inscryption Modding Discord](https://discord.gg/QrJEF5Denm) or on [Daniel Mullins Discord](https://discord.com/invite/danielmullinsgames) as Cyantist. |
| 46 | + |
| 47 | +## Development |
| 48 | +At the moment I am working on: |
| 49 | + |
| 50 | + - Adding comments |
| 51 | + - Documentation |
| 52 | + - Custom special abilities |
| 53 | + |
| 54 | +The next planned features for this plugin are: |
| 55 | + |
| 56 | + - Extending the loader to handle and load custom ~~abilities,~~ boons and items. |
| 57 | + |
| 58 | +## Contribution |
| 59 | +### How can you help? |
| 60 | +Use the plugin and report bugs you find! Lots of traits won't be designed to work well together and may cause bugs or crashes. At the very least we can document this. Ideally we can create generic patches for them. |
| 61 | +### But really, I want to help develop this mod |
| 62 | +Great! I'm more than happy to accept help. Either make a pull request or come join us over in the [Inscryption Modding Discord](https://discord.gg/QrJEF5Denm). |
| 63 | +### Can I donate? |
| 64 | +Donations are totally not needed, this is a passion project before anything else. If you do still want to donate though, you can buy me a coffee on [ko-fi](https://ko-fi.com/madcyantist). |
| 65 | + |
| 66 | +## Contributors |
| 67 | +- Windows10CE |
0 commit comments