Have you installed too many card mods and want your runs through Kaycee's Mod to be a little more streamlined? This is the mod for you.
This mod adds a screen to the setup of each run through Kaycee's Mod. It allows you to toggle which cards will or will not appear in the upcoming run through the use of 'packs.' Mods that use this API can register themselves as packs, and players can turn each pack on or off as they wish.
This mod uses the API's concept of a "mod prefix" on each card to identify which card belongs to which pack.
Encounter pack management beta: This version of the mod is the beta for "encounter packs," which organizes mod-added regions and encounters into packs in the same way that cards get organized into packs. This replaces the mod's default mechanism for activating and deactivating encounters (where encounters were turned off/on based on which card packs were turned off/on). By default, this beta is on; to turn it off, you need to edit the mod's config file and set the EncounterPackManagementBeta flag to false.
When you deactivate a pack for a run through Kaycee's Mod, this mod will temporarily remove all metacategories from all cards in that pack. This will prevent the card from appearing in card choice nodes, trader nodes, rare card selection nodes, etc. However, other references to these cards (such as Evolve or Ice Cube) will remain.
If the encounter beta is turned on (default): A second screen has been added to show encounters that have been added by mods you've installed. These mods are also organized into packs, just like the cards. Toggling off an encounter pack will remove all encounters in that pack from each region they would have otherwise appeared in. If this would leave the region with zero encounters, all base-game encounters are reinstated.
If the encounter beta is turned off: This mod will try to remove encounters from each region that contain excluded cards. However, most card pack mods don't come with encounters, which means that a lot of pack combinations will result in not having any valid encounters. In this situation, the mod reverts to using the game's default encounters.
Packs are discovered by looking at the entire card pool and seeing what cards belong to which prefix. Each card is grouped with its prefix, and assigned a Pack based on that prefix. The game will create a default pack art and attempt to create a default description for every pack of cards it discovers, but mod creators can build their own pack descriptions and pack arts as well.
All of the cards that come with the base game are also assigned to their own packs. By default, these packs only appear in runs for that region, but you can make all packs appear in all regions using the "CrossOverAllPacks" setting in the configuration file.
This mod comes with pack definitions and custom art for the following mods:
Regions and encounters are a little tricky. The API does not enforce any sort of naming convention, although it does track which mod created each region in the form of the mod guid (there is no such tracking for encounters).
Encounter packs are currently only tested and known to support Leshy and P03. Grimora and Magnificus are not yet supported during the beta period.
As with most mods, you need BepInEx installed.
You will also need the API installed.
The zip file should be structured in the same way as your Inscryption root directory. Just drop the 'BepInEx' folder into your Inscryption directory and you're golden.
This cannot be stressed enough. This mod relies on the mod prefix to sort out which cards belong to which pack, so it is your responsibility to make sure that you've selected a mod prefix for your cards and that all your cards use it.
Packs can be belong to any number of "metacategories" which define which scribe they are valid for.
The metacategories are:
public enum PackInfo.PackMetacategory
{
LeshyPack = 0,
P03Pack = 1,
GrimoraPack = 2,
MagnificusPack = 3
}
If you use JSON Loader to build your cards, it's really easy to add a pack definition to your mod. Here's what you need to do:
{
"Title": "Incredible Card Expansion",
"Description": "This card pack is full of cards that will blow your mind.",
"ModPrefix": "boom",
"PackArt": "Artwork/boom_pack.png",
"ValidFor": ["LeshyPack"]
}
You can also create a card pack using this API directly. All you need to do is ask the PackManager to create a PackInfo object for the mod prefix associated with your cards.
using Infiniscryption.PackManagement;
public static void CreatePack()
{
PackInfo incrediPack = PackManager.GetPackInfo<PackInfo>("boom");
incrediPack.Title = "Incredible Card Expansion";
incrediPack.SetTexture(TextureHelper.GetImageAsTexture("Artwork/boom_pack.png");
incrediPack.Description = "This card pack is full of cards that will blow your mind.";
incrediPack.ValidFor.Add(PackInfo.PackMetacategory.LeshyPack);
}
It is strongly recommended however that you do not create a hard dependency between your card pack and this API. Instead, you can create a soft dependency using the following pattern:
private void Start() // Do this in your Plugin.cs file
{
if (Chainloader.PluginInfos.ContainsKey("zorro.inscryption.infiniscryption.packmanager"))
CreatePack()
}
Using this pattern will allow you to create the pack when the user has installed the Pack Manager API, but will not force the user to have installed that API if they do not want it.
You can put the following placeholders into the description of your pack to help dynamically generate the text that will appear when the user hovers over it on the screen:
Each pack has a completely optional "ValidFor" property, which is a list of CardTemples. This is meant to allow you to indicate which zones/biomes the card pack is valid for. By default, the game only has a single zone available in Kaycee's Mod. That zone is Leshy's Cabin, which is the Nature zone. However, other mods, such as "P03 for Kaycee's Mod" or "Grimora Mod", may add other playable zones. The pack definition includes the idea of "ValidFor" in order to provide some amount of future-proofing.
Because cards can only belong to a single temple, the Pack Manager automatically sets the card temple for all cards in any given pack to match the type of KCM run that has been started (assuming that pack is set to be valid for that run type). Most of the time this will be a Leshy run, so all cards will automatically be given the Nature temple. However, if you are starting a Grimora run, all cards in the pack will be given the Undead temple; if you are starting a P03 run, they will be given the Tech temple, etc. In the end, the original temple of the card no longer matters - only the metacategory of the pack itself matters.
But what if you want the temples to matter? In other words, you want to define a single pack but still use the original card templates as filter criteria. Cards with the Wizard temple would only apply to Magnificus, cards with the Tech temple would only apply to P03, etc. To do this, you simply need to set the SplitPackByCardTemple property to true on the PackInfo object. This will apply an additional filter to your pack such that only the cards with the appropriate temple will be counted.
There's an example of this: my side decks mod can't allow the SideDeck metacategory to be removed. To do this, you need to add a 'protected metacategory.' Here is the relevant snippet of code from my side decks mod. Notice how I wrapped the call to the pack manager in a separate method surrounded by a try-catch. This prevents a soft lock if the player hasn't installed the Pack Manager.
private static void RegisterMetacategoriesInner()
{
PackManager.AddProtectedMetacategory(SideDeckManager.SIDE_DECK);
}
private void Start() // Do this in your Plugin.cs file
{
if (Chainloader.PluginInfos.ContainsKey("zorro.inscryption.infiniscryption.packmanager"))
RegisterMetacategoriesInner();
}
The filtering mechanism for encounters/regions uses two different (and mutually exclusive) techniques. You can either use a common prefix for all of your encounters and regions, or use your mod's GUID as the identier.
If you define your pack using a card prefix key, all of your regions and encounters must start with the same prefix. In this example, the encounter prefix is BOOM:
EncounterManager.New("BOOM_IncredibleEncounterOne", addToPool: true);
As above, you can define your encounters using a JSON file with the extension .jlenc:
{
"Title": "Incredible Encounters",
"Description": "This pack is full of encounters that will blow your mind.",
"ModPrefix": "boom",
"PackArt": "Artwork/boom_encounter_pack.png",
"ValidFor": ["LeshyPack"]
}
The API for encounter packs looks the same as it does for card packs; the class is just different:
using Infiniscryption.PackManagement;
public static void CreatePack()
{
EncounterPackInfo incrediPack = PackManager.GetPackInfo<EncounterPackInfo>("boom");
incrediPack.Title = "Incredible Encounters";
incrediPack.SetTexture(TextureHelper.GetImageAsTexture("Artwork/boom_encounter_pack.png");
incrediPack.Description = "This pack is full of encounters that will blow your mind.";
incrediPack.ValidFor.Add(PackInfo.PackMetacategory.LeshyPack);
}
You can also define your encounter/region packs using your mod guid. If you do this, all regions/encounters defined in your mod will be included in the pack. This only works if your plugin loads after the Pack Manager plugin, which you can ensure by making the Pack Manager plugin a dependency of your plugin:
[BepInPlugin("boom.inscryption.guid", "Incredble Mod", "1.6.9")]
[BepInDependency("zorro.inscryption.infiniscryption.packmanager")]
public class BoomPlugin : BaseUnityPlugin
{
private void Awake()
{
// Add regions and encounters
}
}
To use the mod guid as the identifier for your pack, just put your mod guid in the ModPrefix field and use a JSON file with the extension .jlenc:
{
"Title": "Incredible Encounters",
"Description": "This pack is full of encounters that will blow your mind.",
"ModPrefix": "boom.inscryption.guid",
"PackArt": "Artwork/boom_encounter_pack.png",
"ValidFor": ["LeshyPack"]
}
To use the mod guid as the identifier for your pack, just put your mod guid in the ModPrefix field. The API for encounter packs looks the same as it does for card packs; the class is just different:
using Infiniscryption.PackManagement;
public static void CreatePack()
{
EncounterPackInfo incrediPack = PackManager.GetPackInfo<EncounterPackInfo>("boom.inscryption.guid");
incrediPack.Title = "Incredible Encounters";
incrediPack.SetTexture(TextureHelper.GetImageAsTexture("Artwork/boom_encounter_pack.png");
incrediPack.Description = "This pack is full of encounters that will blow your mind.";
incrediPack.ValidFor.Add(PackInfo.PackMetacategory.LeshyPack);
}
Template (blank/empty) pack arts are included in this package.
For encounter packs: if your mod also includes a card pack, and the prefix for your encounter pack is the same as the prefix for your card pack, this mod will automatically create pack art for your encounters pack based on the art for your card pack.