Using Archetype API - Gremious/StS-ArchetypeAPI GitHub Wiki

        if (Loader.isModLoaded("archetypeapi")) {
            // The first line is for custom characters only:
            setCharacterDefaultNumOfCards(TheDefault.Enums.THE_DEFAULT, 71); 
            loadArchetypes("yourModResources/localization/eng/ArchetypeAPIJsons/");
        }

        if (Loader.isModLoaded("archetypeapi")) {
            setCharacterDefaultNumOfCards(TheDefault.Enums.THE_DEFAULT, 71);
            // Necessary for custom characters only
            // It takes your AbstractPlayer.PlayerClass and the amount of cards you want to load as a base.
            // For example, if you have 150 cards but want every run to have ~75, put 75
            // If you skip this line it'll default to the max amount of cards your mod has.
            // ONLY FOR CUSTOM CHARACTERS. Don't override the Ironclad/Defect/Silent - I already set those.
            // Keep in mind that's it's not actually "75" cards usally, as starter cards don't count.
            // (Silent and defect is 71, Ironclad is 72)

            loadArchetypes("yourModResources/localization/eng/ArchetypeAPIJsons/");
        }

{
  "CHARACTER": "THE_SILENT", // The character enum for the class you're adding this archetype to.
  "NAME": "Cool Poison Expac",  // The name of the archetype as shown on the selection card.
  "ARCHETYPE_NAME": "Poison", // The name of the basegame archetype you are expanding. 
  // If making a brand new one, put your own unique name in here.
  // Other mods can put that name to expand *your* archetype too.
  // When rolled randomly, ones with the same names include each-other.
  // You can check the json names of the base classes in the resource fodler of this mod to find the correct names.
  // DO NOT ADD SINGLE TAG IF EXPANDING BASE-GAME ARCHETYPES. Just having the same name is enough.
  "CARD_TYPE": "SKILL", // The selection cards' type.
  "IMG": "myModResources/images/cards/Card.png", // The selection cards' image.
  //  if you wish to use basegame images, put, for exmaple, "green/skill/adrenaline",
  "TAGS": [
    "SINGLE" // The tags of this archetype. VERY IMPORTANT. All of them are detailed below as well as in the tag patch. 
  // DO NOT ADD SINGLE TAG IF EXPANDING BASE-GAME ARCHETYPES. Just having the same name is enough. This is just an exmaple of how to write them.
  ],
  "FEATURES": [ 
   // The selection card has a tooltip that shows a couple of card names (usually 3, 1 of each rarity). Add them here.
    "myModID:CardOfThisArchetype1",
    "myModID:CardOfThisArchetype3",
    "myModID:CardOfThisArchetype4",
  ],
  "CARD_IDS": [ // The ID's of your cards!
    "myModID:CardOfThisArchetype1",
    "myModID:CardOfThisArchetype2",
    "myModID:CardOfThisArchetype3",
    "myModID:CardOfThisArchetype4"
    .
    .
    .
  ]
}

public class ArchetypeCardTags {
    // Though these are card tags, you don't actually put them on any card yourself. These are put in your jsons.

    @SpireEnum
    public static AbstractCard.CardTags BASIC; // IMPORTANT!!!
    // For custom characters, this is the tag for the pool of non-archetype cards,
    // or, cards you want always included.
    // THE ARCHETYPE TAGGED WITH THIS WILL *ALWAYS* BE ADDED TO THE CARDPOOL WHEN ROLLED RANDOMLY.
    // YOU MUST HAVE AT LEAST 1 ARCHETYPE CARD TAGGED WITH THIS FOR A CUSTOM CHARACTER!
    // This is also to make sure you load at least a minimal number of cards and for smoother playing.
    // If a player selects too little cards manually, card from here will be randomly chosen to fill the gaps.

    @SpireEnum
    public static AbstractCard.CardTags SINGLE; // IMPORTANT!!!
    // For single/core archetypes. Cards that add unique archetypes and nothing more.
    // KEEP IN MIND THAT IF THE PLAYER DOESN'T HAVE THE "CHOOSE ARCHETYPES ON RUN START" OPTION SELECTED,
    // ONLY CARDS TAGGED WITH THIS WILL BE IN THE RANDOM AUTO-SELECT POOL. TAG YOUR CARDS!
    // ALL BASEGAME ARCHETYPES ARE PRE-TAGGED. DO NOT ADD SINGLE TAG IF EXPANDING BASE-GAME ARCHETYPES.
    // Just having the same name is enough.

    // This is to prevent OPTIONS/MIXES from being randomly selected in place of an actual archetype:

    @SpireEnum
    public static AbstractCard.CardTags INCLUDE_SUPPORT;
    // If you are adding *new* orb archetypes, tag them with this. This API checks for this tag to know
    // whether or not it can add the "Orb Support" archetype to the pool.
    // That archetype would not be added if you don't roll any orbs.

    @SpireEnum
    public static AbstractCard.CardTags SUPPORT;
    // SUPPORT is excluded from the RNG selection pool unless a card with INCLUDE_SUPPORT is rolled as an archetype.
    // There are cards that support Defect Orbs but would be useless if the player has NO orbs in the game (Focus cards for example).
    // Of course, if you are making a custom character that uses MECHANIC and SUPPORT_MECHANIC - feel free to use these tags too.

    @SpireEnum
    public static AbstractCard.CardTags CUSTOM_MIX;
    // For exmaple, an option card that says "Poison + Discard" and adds a specific selection of only cards in those archetypes to a run.
    // Or maybe "Nothing but Claw and Double-tap.". Or "Strenght ironclad + Shiv silent".
    // This is for fun custom mixes of cards that should not show up when randomly drafting archetypes
    // but should show if players choose to select it.

    @SpireEnum
    public static AbstractCard.CardTags OPTION;
    // For a card that doesn't add an archetype to the pool itself, but perhaps edits it in some other way
    // For exmaple "Upgrade all poison cards if any" or something like that.

    // The latter 2 tags aren't currently utilized, but exist for future-proofing.

}