You are viewing a potentially older version of this package. View all versions.
TVFLabs-CustomSideDeck-2.2.2 icon

CustomSideDeck

Change the side deck to something other than squirrels! Lots of options for making your own side deck with JSON Loader (or C#). v2.0: Custom card backs! Works with Side Deck Selector!

By TVFLabs
Date uploaded a week ago
Version 2.2.2
Download link TVFLabs-CustomSideDeck-2.2.2.zip
Downloads 726
Dependency string TVFLabs-CustomSideDeck-2.2.2

This mod requires the following mods to function

API_dev-API-2.22.3 icon
API_dev-API

The de-facto standard core API for all Inscryption mods. This lets you create new cards, abilities, challenges, map nodes, starter decks, and more.

Preferred version: 2.22.3

README

TVFLabs's Custom Side Deck

This mod lets you change the side deck to something other than squirrels, and allows changing the number of cards in the side deck, having more than one type of card in the side deck, having cards be selected when starting the run, and even displaying custom card backs.

About the Side Deck Selector mod

This mod should work alongside Side Deck Selector for the most part, but you should be aware of a few things:

  • CustomSideDeck and Side Deck Selector will both display their own separate side deck selection screen when starting a run. Side Deck Selector's screen will show up first, then CustomSideDeck's screen will appear when you choose a Side Deck Selector side deck.
  • No matter what side deck you choose from Side Deck Selector, the CustomSideDeck side deck you select will take priority.
  • CustomSideDeck's side deck selection screen will display side decks from Side Deck Selector, but not the other way around.
  • The side deck choice node added by Side Deck Selector's challenge hasn't been tested with CustomSideDeck, but I doubt it would work at all.
  • Currently, CustomSideDeck doesn't support changing your side deck partway through a run. Aside from that, though, I'm fairly sure every other feature in Side Deck Selector exists in CustomSideDeck as well.
  • Side Deck Selector works with P03 in Kaycee's Mod, but CustomSideDeck does not.

Config options

  • GenerateDefaultCardBacks:
    • How the mod should handle side deck card backs for side decks that don't add their own custom card back. If enabled, automatically generates a unique card back based on the side deck's main card's portrait. Otherwise, the default squirrel back will be used.
      • I personally like the way this looks, but a lot of people hated it so it's off by default now.
  • GenerateAquaVersions
    • Whether to automatically add an Aqua version of all custom side decks.
      • This one is very buggy, and I'd recommend keeping it disabled. But it's there if you want to use it.
  • ShowAquaSideDecksWhenSquirrelFishChallengeDisabled
    • Whether or not Aquasquirrels and custom side decks marked as CSDIsAqua should be shown as options even when the Squirrel Fish challenge isn't on.
      • This does not affect which side decks are available when Squirrel Fish is enabled.

How to use (with JSON Loader):

Basic Side Deck:

"extensionProperties": {
  "CSDIsSideDeck": "true",
  "CSDSideDeckType": "Basic"
}

Basic side decks work like most side decks: they have 10 copies of one type of card.

Set Count Side Deck:

"extensionProperties": {
  "CSDIsSideDeck": "true",
  "CSDSideDeckType": "SetCount",
  "CSDNumCards": "3"
}

Set Count side decks are like Basic ones, except that you can set the number of cards in the deck using the CSDNumCards extension property.

Configurable Side Deck:

"extensionProperties": {
  "CSDIsSideDeck": "true",
  "CSDSideDeckType": "Configurable",
  "CSDNumCards": "10",
  "CSDNumOptions": "4",
  "CSDOption1": "Squirrel",
  "CSDOption2": "Bee",
  "CSDOption3": "Rabbit",
  "CSDOption4": "Geck"
}

Configurable side decks allow the player to choose which cards to put in the side deck before they start the run. Clicking on a card in the Configure Side Deck screen cycles through the options. There are CSDNumCards cards in the deck, each of which can be any of the CSDOptions. Make sure that the number of CSDOption properties is the same as the value of CSDNumOptions, or it won't work.

Advanced Side Deck:

"extensionProperties": {
  "CSDIsSideDeck": "true",
  "CSDSideDeckType": "Advanced",
  "CSDNumCards": "5",
  "CSDCard1": "Squirrel",
  "CSDCard2": "Bee",
  "CSDCard3": "Rabbit",
  "CSDCard4": "self",
  "CSDCard5": "conf",
  "CSDNumOptions": "2",
  "CSDOption1": "Cat",
  "CSDOption2": "Goat"
}

Advanced side decks can do everything that the other types of side decks can, and they also allow setting a specific amount of each type of card. In any of the CSDCard properties, you can enter the name of a card directly, or, alternatively, you can enter self or conf. CSDCards set to self will be the card the extension properties are on, while CSDCards set to conf will act like the cards in a Configurable side deck. Make sure that the number of CSDCard properties is the same as the value of CSDNumCards, and that the number of CSDOption properties is the same as the value of CSDNumOptions or it won't work.

Bonus Properties:

"extensionProperties": {
  "CSDIsSideDeck": "true",
  "CSDSideDeckType": "Basic",
  "CSDCardBack": "AquaBee_back.png",
  "CSDIsAqua": "true",
  "CSDChallengePoints": "-5"
}

These properties can be used by any kind of side deck. When CSDCardBack is set to a 125 by 190 pixel PNG file, that image will render in place of the standard side deck back. Check the mod's folder for a template image. There are a few default images available. Instead of the path to a PNG file, you can choose to use these:

  • squirrel will use the Squirrel side deck back from the base game
  • bee will use the Bee side deck back from the base game
  • aquasquirrel will use the Aquasquirrel side deck back (which is just the Waterborne card back)
  • blank will use a generic blank back with no icon
  • gen will make a side deck back automatically based on the main card's portrait

If CSDIsAqua is set to true, the side deck will be selectable when the Squirrel Fish challenge is enabled. You can use this to make Aquasquirrel-style variants of your custom side decks.

The value of CSDChallengePoints will be added to the player's challenge points when they use the side deck in a run.

CHANGELOG

2.2.2

  • Fixed the default side deck back being blank instead of the squirrel back

2.2.1

  • Hotfix for a few bugs in the last version

2.2.0

  • Added squirrel, bee, aquasquirrel, blank and generated default card back options
  • Added CSDChallengePoints extension property that, when set, will add (or subtract) that number of challenge points when the side deck is used
  • Fixed a bug with scrolling

2.1.0:

  • Added a config option to determine how to handle a side deck with no custom card back
  • Added a config option to enable generating Aqua versions for non-CSDIsAqua side decks
  • Added a config option to choose whether CSDIsAqua side decks should appear if the Squirrel Fish challenge is disabled
  • Fixed a few error messages

2.0.0:

  • This version should be fully backwards compatible with previous versions, but if you run into any issues, let me know
  • Added CSDCardBack extension property -- when set to a 125 x 190 png file, your side deck will display that image on the card's backs
  • If no custom back is supplied, one will be automatically generated based on your main card's portrait
  • Added CSDIsAqua extension property
  • When the Squirrel Fish challenge is enabled, only side decks with CSDIsAqua set to true can be selected
  • Select Side Deck screen now scrolls faster
  • Now actually actually works with Side Deck Selector (for real this time, I swear)
  • That is to say, Side Deck Selector side decks should be selectable in this mod's side deck selection screen
  • Fixed spamming errors in the console when a non-configurable side deck was chosen

1.2.0:

  • Now actually works with Side Deck Selector
  • Fixed softlock when loading a run
  • Squirrels are now the initial side deck

1.1.0:

  • Can now be installed alongside Side Deck Selector
  • Now detects Side Deck Selector side decks and adds them to the list of available side decks
  • Added border to selected side deck

1.0.0:

  • Uploaded to Thunderstore