How to modify or create a Card and Tag

What is a Card?

In-game characters, items, special statuses, etc., can all be represented as cards.
Cards serve as carriers for tags.

How to create a new card?

All cards are configured in the cards.json table
In the cards table, create a new card with an unused 7-digit ID starting with 2

Data structure for the cards table

{
    "2000001": { //Create a new unused id with a 7-digit starting with 2
        "id":  2000001,//Same as above
        "name": "Arzu", //Name of the card
        "title": "The Chosen One", //Title of the card
        "text": "You, a poor soul caught in the Sultan's Game.", //Description of the card
        "pops": [],//Parameter must remain but unused (no need to set)
        "card_favour": "",//Parameter must remain but unused (no need to set)
        "type": "char", // Card type; currently available types are char, sudan, and item
        "tips": "",//Parameter must remain but unused (no need to set)
        "rare": 3,//Card rarity; 1-4 correspond to Stone, Bronze, Silver, and Gold
        "resource": ["cards/2000001","cards/2000001_1","cards/2000001_2"],
        // Available card faces for the current card; the first face is displayed by default
        // Can switch to the first face by setting "specify current card=image":0
        // Can switch to the second face by setting "specify current card=image":1
        // Can switch to the third face by setting "specify current card=imag":2
        "tag": { // Tags the card possesses by default
            "Physique": 3, //Format: "tag name": value
            "Charisma": 2,
            "Wisdom": 1,
            “Male": 1,
            “Noble": 1,
            "Protagonist": 1,
            "Combat": 2,
            "Sociability": 1,
            "Owned": 1,
            "Support": 1
        },
        "card_vanishing": 0, 
        //Card lifecycle; the card is removed when the lifecycle ends
        "vanish": { //Deathrattle; actions executed when the card is removed
            "over": 13 //Triggers the corresponding ending
        },
        "equips": [ 
        // Equipment slots available for the current card; options include Weapon, Attire, Accessory, and Beast Taming; multiple can be configured
            "Weapon",
            "Attire",
            "Accessory"
        ],
        "is_only": 1 // Indicates whether the card is unique
    },
        "post_rite":[ //Additional actions executed when the card is used in a ritual; configured by designers as needed
            {
                "condition": {      
                },
                "result_text": "Arzu arrives",
                "result": 
                {
                    "self+Physique": 1//+1 Physique after using in any rite
                },
                "action": {
                }
            }
        ]
}

What is a Tag?

Tag is bound to cards, and used for checks or special functions
Chinese tag names are often directly used for checks, sobetter not modify existing Chinese tag names

How to create a new tag?

All cards are configured in the tag.json table
In the tags table, create a new card with an unused 7-digit ID starting with 3

Data structure for the tags table

{
	"physique": { // English tag name; must be unique
        "id": 3000001, //In the tags table, create a new card with an unused 7-digit ID starting with 3
         "name": "体魄", //Tag name; uses Chinese directly
        "code": "physique", //English tag name; must be unique
        "type": "buff", 
        // Currently divided into buff and attribute
        // Stackable properties use buff; state identifiers use attribute
        "text": "Strength, agility, and endurance. It measures overall physical fitness.",
        // Description text
        "tips": "",//Comments for designer
        "resource": "tag_1",
        // Tag icon; corresponds to the resource name of the icon. Resources are placed in the required file path of the mod
        "can_add": 1,
        // Sets whether the tag can stack; 1 means stackable, 0 means non-stackable. Non-stackable tags remain at 1 regardless of additions
        "can_visible": 1,
        // Sets whether the tag is visible to players; 1 means visible, 0 means invisible
        "can_inherit": 1,
        // Sets whether the tag can be inherited by equipped cards; 1 means yes, 0 means no
        // Designer uses this parameter to apply weapon card attributes to the equipped character
        "can_nagative_and_zero": 1,
        // Sets whether negative values are meaningful for the tag; 1 means yes, 0 means no
        // If set 1, then the tag supports negative values; otherwise, the minimum value is 0
        "fail_tag": [],,//Parameter must remain but unused (no need to set)
        "tag_vanishing": 0,//Parameter must remain but unused (no need to set)
        "tag_sfx": "",
        // Used to add special effects to cards with this tag
        // Editing is currently restricted
        "tag_rank": 99, // Display order of the tag on cards; higher numbers appear first
        "attributes": {}
    },
    "lock_152": {
        "id": 3020261,
        "name": "The Tamed",
        "code": "lock_152",
        "type": "attribute",
        "text": "Those bridled and tamed accomplish nothing.",
        "tips": "",
        "resource": "tag_0",
        "can_add": 0,
        "can_visible": 1,
        "can_inherit": 0,
        "can_nagative_and_zero": 0,
        "fail_tag": [],
        "tag_vanishing": 0,
        "tag_sfx": "hurt",
        "tag_rank": 10,
        "attributes": {
            "adsorption specified": 1 
   // If adsorption specified is configured, cards with this tag can only be placed in ritual slots that require this tag and cannot be used in other ritual slots
        }
    },
}

Tags with Exclusive Functions

Owned/Follower: Cards with this tag become playable cards in hand for the player.
Equipment: Cards with this tag are defined as "equipment." Tags related to equipment slot types must also be configured to enable equipping/unequipping.
- For example, a Dagger card must have both the Equipment and Weapon tags to be equipped/unequipped by a character.
Weapon/Attire/Accessory/Beast Taming: Tags corresponding to equipment slot types. When combined with the "Equipment" tag, they allow cards to be equipped to cards with matching slots.