KCM Deck Builder

Build your own starter deck for Kaycee's Mod from inside the game.

A - BUILD CUSTOM DECK - menu item appears on the Select Starter Deck screen. It opens a deck builder styled like the Kaycee's Mod menus, with the real Act 1 card art. Pick your cards, press START WITH THIS DECK, and choose your challenges as usual.

The custom deck is a separate starter deck with its own icon. The game's own starter decks still work exactly as before.

Features

• In-game deck builder with Act 1 card faces: costs, sigils, stats, rare and gold cards.
• Filters: ALL, PELTS, BOSS, OTHER, BLOOD, BONES, FREE, RARE, and MODDED when card packs are installed.
• Search by name or sigil. Type "airborne" to find every card with Airborne.
• Sort by cost, attack, health or name. Your deck shows its total blood, bones, attack and health.
• Card packs. Cards from other mods (JSONLoader packs, Lobotomy Mod and others) show up with their art and sigils in their own MODDED tab.
• Share codes. COPY CODE puts your deck in the clipboard as a short code (KCM:...) to post anywhere; PASTE CODE loads one.
• Saved decks. Name and save your decks, then load them again from the DECKS list.
• Random deck. Press RANDOM for 3 random regular cards (one of them always costs 1 blood) plus 2 Rabbit Pelts. Press again to reroll.
• In-game settings. Change the card limit, the copy limit, unlocked-only and boss/special cards from the SETTINGS page.
• Pelts. Start with Rabbit, Wolf or Golden Pelts and trade them at the first-node Trader.
• Boss cards you can't normally get: Bait Bucket, Gold Nugget, Leaping Trap, Pack Mule, Skeleton Crew, Zombie Parrot and Strange Frog.
• Other cards you can't normally draft: Boulder, Stump, Dam, Frozen Opossum, The Smoke and more.
• Your picks only. No catch-up cards are added with the custom deck (no extra pelts, Opossum or Ring Worm after early losses). Cards other mods add at the start of a run are kept.
• First-node Trader. If your custom deck has pelts, the Trader on the first node is always there.
• No pointless lecture. Leshy skips the "were you expecting more pelts?" punishment lines, since the custom deck gets no catch-up cards anyway.
• Feels like the game. A real menu item to open it, the game's own cursor with its trail, the pointer hand, menu click sounds and blinking highlights.
• Unlocks respected. Only cards you have unlocked are offered (configurable).
• Same deck on retry. Restarting after a loss keeps your custom deck.

Screenshots

The BUILD CUSTOM DECK menu item on the starter deck screen

Cards from card packs in their own tab

Search by sigil, sort by attack or health

Saved decks and share codes

Settings, right in the builder

Your run starts with exactly the cards you picked

Pelts in your deck? The Trader is waiting on the first node

Rules (config)

Also on the SETTINGS page in the builder. File: BepInEx/config/emre.inscryption.kcmdeckbuilder.cfg

The deck is saved in the same file (Cards = ...). A list of valid card IDs is written to BepInEx/config/KCMDeckBuilder_cards.txt when you open the builder. Saved decks live in BepInEx/config/KCMDeckBuilder_decks.txt.

Compatibility

• Requires the Inscryption API (installed automatically by mod managers). The custom deck is registered with the API's starter deck manager, like other starter deck mods.
• Your game save never stores the custom deck: the choice is kept in the API's modded save, and the game's save says "Vanilla". Removing the mod is safe.
• Tested with JSONLoader card packs and the Lobotomy Mod. A card from another mod with broken data is left out instead of breaking the builder.
• Tested on the Epic version. The Steam version uses the same game code.

Installation

Use r2modman / Thunderstore Mod Manager; it installs the Inscryption API too. To install by hand, install BepInEx and the Inscryption API, then copy KCMDeckBuilder.dll into BepInEx/plugins.

About

Made with AI assistance. Designed, reviewed and tested by me in the game.

2.1.1

• Fix: with a custom deck that has no pelts, the Trader no longer appears on the first map node. The game puts it there to sell the extra pelts it gives after early losses; the custom deck doesn't get those pelts, so now the Trader comes only when your own deck has pelts.
• Fix: giving up a custom deck run no longer counts toward the game's early-loss counter, so it no longer makes the normal starter decks start with fewer pelts (Opossum and Ring Worm instead). Runs with the normal decks work exactly as before.

2.1.0

• PACK button: with several card mods installed, show the cards of one mod at a time, or only the base game's. Works together with the filter tabs, search and sort.
• Hover a card to see a box beside it with its cost, stats and every sigil (icon, name and rulebook text), special attack icons such as Ants or Mirror, its tribes and the mod it comes from. The search box finds tribes too ("bird", "insect"). The card ID list (KCMDeckBuilder_cards.txt) has a mod column too.
• Deleting a saved deck now asks first: X turns into a DELETE? button for a few seconds.
• Lighter on the game: next to no work outside the builder, long deck lists only draw the rows you can see, and texts are no longer rebuilt every frame.
• Code cleanup: the source is split by responsibility and the share code format has tests.

2.0.0

• Now built on the Inscryption API, which is a new dependency. The custom deck is a real starter deck with its own icon on the deck screen, and the "custom deck selected" choice is kept in the API's modded save. The game's own save still never stores the custom deck.
• Card pack support: cards from other mods get their own MODDED tab with their art and sigils. Tested with JSONLoader packs and the Lobotomy Mod.
• Share codes: COPY CODE / PASTE CODE on the DECKS page.
• In-game SETTINGS page for the card limit, copy limit, unlocked-only and boss/special cards.
• Search also finds sigils, a SORT button (cost, attack, health, name), and deck totals under your deck.
• The builder opens from a real Kaycee's Mod menu item on the starter deck screen.
• Much faster drawing: only the visible cards are drawn and card data is read once, which matters with large card packs.
• Hardened against unusual cards from other mods: a card that can't be read is left out, and an unexpected error closes the builder instead of leaving a black screen.
• Fixed names disappearing at the bottom of a scrolled list, and the in-deck count badge covering card names.

1.1.1

• Fixed: catch-up cards could still end up in a custom deck run. The game's catch-up rule is now switched off while a custom run is created, so you start with exactly your picks, and cards other mods add at the start of a run are kept.
• Opening the Kaycee's Mod menu no longer freezes for about a second. The mod used to load the game's starter decks early there; the card ID list is now written when you open the builder instead.
• The log now shows how long the mod takes to load and to open the builder.
• Noted in the README that the mod was made with AI assistance.

1.1.0

• RANDOM button: 3 random regular cards (at least one costs 1 blood) + 2 Rabbit Pelts.
• Saved decks: name your deck, save it, and load or delete it later from the DECKS list.
• The builder now uses the game's own cursor (with its trail and pointer hand), plays the menu click sound on hover and blinks highlighted buttons like the game's menus.
• Safer save handling: the mod's hooks can no longer interrupt a save, a load or a new run if something goes wrong, and a corrupt save file no longer sends the game into a crash loop.
• Fixed text spilling outside long lists when they scroll.
• Fixed the boss card list in the README.

1.0.1

• Fix: card names and stats could show in a tiny fallback font if the game hadn't loaded the card font yet (e.g. with the Inscryption API installed). The font is now loaded directly.
• Leshy no longer plays the "were you expecting more pelts?" punishment lines with a custom deck, since it gets no catch-up cards.
• Screenshots in the README.

1.0.0

• First release.