What is Ending (over)

• Involves CG, descriptions, and epilogues for game endings
• Activating an ending means the current game has concluded

How to create a new ending (over)

• All endings are configured in the over.json table
• In the over table, create an unused number between 1–999 as the ending id

Data structure for the over table

{
    "1": { // Ending id (must be an unused number between 1-999)
        "name": “Walking with the Tiger", //Ending name
        "sub_name": "You died from provoking the Sultan.", //Short description under the ending name
        "text": "Not funny. The Sultan executes you like the jester you are.", //Detailed ending description
         "text_extra": [ // Allows creators to add conditional extra descriptions
            {
                "condition": {
                },
                "result_text": ""
            } //Note: This parameter cannot be deleted even if no extra ending text is needed
        ],
        "open_after_story": 0, //Whether to enable Epilogue (1 = enabled, 0 = disabled)
        "bg":"over_cg/over_cg_1", //Ending CG asset
        "icon":"over_icon/over_icon_1", //Ending popup UI asset (recommended not to modify)
        "title":"over_icon/over_title", //Ending popup UI asset (recommended not to modify)
    },
    ,
    "222": {
        "name": "The Realm of Remembrance",
        "sub_name": "No more Sultans, only the Great King who restored the ancient kingdom! Long live the King!",
        "success": 2, 
        // Additional parameter to indicate if the ending is a failure, small victory, or decisive victory
        // If set to 0 or omitted, it means failure
        // If set to 1, it means small victory
        // If set to 2, it means decisive victory
        "text": "You and Sirshana ascended the steps of the Lapis Lazuli Palace.......",
        "text_extra": [
            {
                "condition": {
                },
                "result_text": ""
            }
        ],
        "open_after_story": 1,
        "bg":"over_cg/over_cg_101",
        "icon":"over_icon/over_icon_1",
        "title":"over_icon/over_title",
        "manual_prompt":true
        //Additional parameter to toggle confirmation popup when triggering the ending
        //Failure endings default to false (or omitted), showing a "Return to start of this round?" popup
        //Success endings must set this to true to disable the confirmation popup
    },
  }

Epilogue

• If the triggered ending has an epilogue enabled, the system will search all epilogue configurations and play those that meet the conditions
• Epilogue configurations are tied to characters

How to create a new epilogue

• Locate the relevant character's epilogue file in the mod-provided directory
• In the relevant character file, add an epilogue configuration with a unique id

<aside> 💡

File IDs and characters are not strictly bound. It is only for easier management by designers. You can actually create an unused id and assign epilogues for multiple characters to a single file. As long as the trigger conditions are correctly configured

</aside>

Epilogue data structure explanation, using 2000019 Jenna as an example

{
    "id": 2000019, //card id of Jenna
    "name": “Jenna", //name of the character
    "prior": [
    ],
    "extra": [
//---------------------------Ending-Dragonslayer-SacredSacrifice------------------------------
        {
            "key": "2000019_extra_1", 
              //Unique epilogue id (recommended format: [character id_extra_number] to avoid duplicates)
            "condition":{ 
            //Since epilogues are configured per character, conditions must fully specify ending triggers
            //Incomplete conditions may prevent epilogue activation or trigger it incorrectly
                //--------Conditions for Rebellion ending---------------------
                "counter.7000550>=":1, //"Sacred Sacrifice" ending completed
            //-------- Personal condition ---------------------     
                "have.2000019":1, //Jenna is alive
            },
            "result_text": "Jenna crafted a glorious jewel inspired by dragon slaying......" //Epilogue text
        },
//---------------------------The Realm of Sages ending-----------------------
        {
            "key": "2000019_extra_2",
            "sort" :1, 
            // Display priority (higher numbers appear later)
            //If omitted, defaults to character ID order
            "pic":"cards/2000019",
            //Epilogue illustration
            //If omitted, uses character's default portrait
            "condition":{
                //--------Conditions for Rebellion ending---------------------
                "counter.7000449<":1, //Protagonist participated in the Fruit
                "have.2000910.Legitimacy":1, //"Road Map of Revolution"
                "have.2000312.Sultan":1,  //Nawfal became leader
                "counter.7000446>=":1, // Balance achieved
            //-------- Personal condition --------------------- 
                "have.2000019":1,
            },
            "result_text": "Your council decreed a new path to nobility......"
        }, 
    ]
}