FAQ - Gremious/StS-ArchetypeAPI GitHub Wiki

1. What if my card fits into several archetypes? e.g. "Discard 3 cards, apply 3 Poison to all enemies, gain 3 Shivs."

  • Add it to all of them. Duplicates are cleared, so you can fit a card in as many jsons as you want.

2. What if my card doesn't fit into any archetype? e.g. "Deal 9 damage 2 times."

  • Add it to the "Basic" Archetype - it is the catch-all archetype for all 'standard' cards.

3. I'm just expanding a basegame archetype with some additional cards. Do I still need to specify Card type/Image/etc."

  • Yes. Every single archetype, even small support ones, get their own "selection card" with the name, image and card type, in case players want to personally select only cards from your mod. Do not ommit json fields or else it will crash.

4. I am expanding existing basegame archetypes. Do I need to tag them the same way?

  • No. Basegame archetypes are already pre-tagged, so simply leave the tag field empty, e.g. "TAGS": [],.

All you have to do is make sure you used an identical archetype name i.e. "Poison", for "My Mod's Poison Expac". Don't tag it Single, as you will effectively double the chance poison will be roled if you do so. If you're making a brand new type of poison, (e.g. replay the spire's necrotic poison) consider making it a brand new archetype instead.

5. I am adding brand new archetypes to existing characters. Do I need to tag them?

  • Yes, normally this would just be "SINGLE" and nothing else. If you're adding new orbs to the Defect, remember to add the "INCLUDE_SUPPORT" tag.

6. My custom character has a bunch of cards. How do I know I didn't miss putting any of them in the jsons?

  • Start a run with them after enabling ArchAPI and search for the following log:

    12:08:34.628 INFO effects.RandomArchetypeEffect> This character has cards not registered with archetype API. Those cards are: [Card 1, Card 2, Card 3]

If you can't find it or it's empty - you've added all the cards!

7. What is support/include support?

  • When you start a new game, Archetype API starts grabbing random archetypes. Every time it does so, it checkes whether it grabbed one tagged SUPPORT (e.g. Focus Cards archetype for the Defect). If it did, it'll check if it had previously grabbed one with the tag INCLUDE_SUPPORT (e.g. any orb archetype). If it did - the SUPPORT archetype will be added. If not, it'll be re-rolled.