diff --git a/README.md b/README.md index f7aeb7b..fe84823 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ Godot 4 tactical RPG prototype inspired by classic turn-based Romance of the Thr ## Current Slice -- Thirty-eight campaign scenarios. +- Thirty-nine campaign scenarios. - Grid movement. - Unit selection. - Move, attack, wait, end turn. @@ -59,6 +59,7 @@ Godot 4 tactical RPG prototype inspired by classic turn-based Romance of the Thr - Weishui Crossing consumes the Weishui Camps branch flags and turns the western campaign from river defense into a Guanzhong foothold. - Guanzhong Foothold consumes the Weishui Crossing branch flags and turns the seized riverbank into a western base against Ma Chao's rearguard. - Ma Chao Retreat consumes the Guanzhong Foothold branch flags and drives the western campaign toward Guanzhong pacification or the Hanzhong front. +- Hanzhong Approach consumes the Ma Chao Retreat branch flags and opens Zhang Lu's mountain gate campaign. - Post-battle choices can save campaign flags that branch later briefing text, shop stock, and scenario events. - Scenario post-battle dialogue can play before the victory result panel. - Basic battle EXP, level-ups, and core first-tier class promotion routes. diff --git a/data/campaign/campaign.json b/data/campaign/campaign.json index 090ea2c..2e4a61e 100644 --- a/data/campaign/campaign.json +++ b/data/campaign/campaign.json @@ -193,6 +193,11 @@ "id": "038_ma_chao_retreat", "title": "Ma Chao Retreat", "path": "res://data/scenarios/038_ma_chao_retreat.json" + }, + { + "id": "039_hanzhong_approach", + "title": "Hanzhong Approach", + "path": "res://data/scenarios/039_hanzhong_approach.json" } ] } diff --git a/data/scenarios/039_hanzhong_approach.json b/data/scenarios/039_hanzhong_approach.json new file mode 100644 index 0000000..90df50e --- /dev/null +++ b/data/scenarios/039_hanzhong_approach.json @@ -0,0 +1,359 @@ +{ + "id": "039_hanzhong_approach", + "name": "Hanzhong Approach", + "objectives": { + "victory": "Reach the Hanzhong approach with Cao Cao, then defeat Zhang Lu's border guard.", + "defeat": "Cao Cao is defeated or the battle reaches Turn 18." + }, + "conditions": { + "victory": { "type": "all_units_defeated", "team": "enemy", "after_event": "hanzhong_approach_reached" }, + "defeat": [ + { "type": "any_officer_defeated", "team": "player", "officer_ids": ["cao_cao"] }, + { "type": "turn_reached", "turn": 18, "team": "player" } + ] + }, + "briefing": { + "title": "Hanzhong Approach", + "location": "Hanzhong Approach, Qinling Passes, 215 CE", + "lines": [ + "With Ma Chao's retreat broken, Cao Cao turns from Guanzhong's roads toward Hanzhong's mountain gates.", + "Zhang Lu's border guard watches the passes, where supply, faith, and narrow stone roads can slow even a victorious army." + ], + "conditional_lines": [ + { + "campaign_flags": { "pacified_guanzhong": true }, + "lines": [ + "Pacified Guanzhong gives Cao Cao a quiet rear and fuller supply trains before the mountain approach." + ] + }, + { + "campaign_flags": { "prepared_hanzhong_front": true }, + "lines": [ + "Preparations for Hanzhong put Cao Cao's vanguard in motion early, but Zhang Lu's border scouts have already lit the pass beacons." + ] + } + ] + }, + "shop": { + "items": [ + "bean", + "wine", + "iron_sword", + "training_spear", + "short_bow", + "hand_axe", + "war_axe", + "leather_armor", + "iron_armor" + ], + "conditional_items": [ + { + "campaign_flags": { "pacified_guanzhong": true }, + "items": ["imperial_seal"] + }, + { + "campaign_flags": { "prepared_hanzhong_front": true }, + "items": ["war_drum"] + } + ] + }, + "roster": { + "max_units": 7, + "required_officers": ["cao_cao", "guo_jia"] + }, + "formation": { + "cells": [[1, 3], [1, 4], [1, 5], [2, 2], [2, 3], [2, 4], [2, 5], [2, 6], [3, 2], [3, 3], [3, 4], [3, 5], [3, 6]] + }, + "map": { + "width": 18, + "height": 11, + "terrain": [ + "GGGGHHGGGGGGHHGGGG", + "GGFFHHGGRRGGHHFFGG", + "GGRRRRRRRRRRRRFFGG", + "GGGFGHGGGGRRGGGGGG", + "RRRRRRRRRRRRRRRRRR", + "GGGGGHHGGGRRGFFGGG", + "GGHHGFFFGGFFFGGHHG", + "GGHHGFFFGGFFFGGHHG", + "GGGGGGFFGGHHHGGGGG", + "GGFFGGGGGGHHHFFGGG", + "GGGGGGGGGGGGGGGGGG" + ] + }, + "deployments": [ + { + "unit_id": "cao_cao_ch39", + "officer_id": "cao_cao", + "team": "player", + "pos": [1, 4] + }, + { + "unit_id": "guo_jia_ch39", + "officer_id": "guo_jia", + "team": "player", + "requires_joined": true, + "pos": [2, 4] + }, + { + "unit_id": "zhang_he_ch39", + "officer_id": "zhang_he", + "team": "player", + "requires_joined": true, + "pos": [2, 3] + }, + { + "unit_id": "xiahou_dun_ch39", + "officer_id": "xiahou_dun", + "team": "player", + "pos": [1, 5] + }, + { + "unit_id": "dian_wei_ch39", + "officer_id": "dian_wei", + "team": "player", + "requires_joined": true, + "pos": [2, 5] + }, + { + "unit_id": "xiahou_yuan_ch39", + "officer_id": "xiahou_yuan", + "team": "player", + "requires_joined": true, + "pos": [3, 3] + }, + { + "unit_id": "cao_ren_ch39", + "officer_id": "cao_ren", + "team": "player", + "requires_joined": true, + "pos": [3, 4] + }, + { + "unit_id": "zhang_lu_border_guard", + "name": "Zhang Lu Border Guard", + "class_id": "commander", + "team": "enemy", + "level": 36, + "pos": [14, 4], + "base": { "hp": 126, "mp": 50, "atk": 37, "def": 29, "int": 30, "agi": 20 } + }, + { + "unit_id": "hanzhong_pass_champion", + "name": "Hanzhong Pass Champion", + "class_id": "champion", + "team": "enemy", + "level": 36, + "pos": [15, 3], + "base": { "hp": 130, "mp": 12, "atk": 39, "def": 27, "int": 12, "agi": 24 } + }, + { + "unit_id": "mountain_gate_captain", + "name": "Mountain Gate Captain", + "class_id": "guard_captain", + "team": "enemy", + "level": 36, + "pos": [12, 4], + "base": { "hp": 104, "atk": 37, "def": 30 } + }, + { + "unit_id": "hanzhong_ritual_advisor", + "name": "Hanzhong Ritual Advisor", + "class_id": "military_advisor", + "team": "enemy", + "level": 36, + "pos": [13, 5], + "skills": ["blaze", "great_mend"], + "base": { "hp": 92, "mp": 76, "atk": 8, "def": 18, "int": 39, "agi": 18 } + }, + { + "unit_id": "hanzhong_spear_north", + "name": "Hanzhong Spear Guard", + "class_id": "infantry", + "team": "enemy", + "level": 36, + "pos": [12, 3], + "base": { "hp": 94, "atk": 37, "def": 27 } + }, + { + "unit_id": "hanzhong_spear_south", + "name": "Hanzhong Spear Guard", + "class_id": "infantry", + "team": "enemy", + "level": 36, + "pos": [12, 5], + "base": { "hp": 94, "atk": 37, "def": 27 } + }, + { + "unit_id": "hanzhong_pass_marksman", + "name": "Hanzhong Pass Marksman", + "class_id": "marksman", + "team": "enemy", + "level": 36, + "pos": [13, 2], + "base": { "hp": 86, "atk": 38, "def": 14, "agi": 27 } + } + ], + "events": [ + { + "id": "opening", + "once": true, + "when": { "type": "battle_start" }, + "actions": [ + { "type": "log", "text": "Cao Cao's army approaches Hanzhong's mountain gates as Zhang Lu's border guard blocks the pass road." } + ] + }, + { + "id": "opening_dialogue", + "once": true, + "when": { "type": "battle_begin" }, + "actions": [ + { + "type": "dialogue", + "lines": [ + { "speaker": "Xiahou Yuan", "text": "The road climbs quickly. Hanzhong will not fight like Guanzhong." }, + { "speaker": "Guo Jia", "text": "Mountains make small armies feel large and large armies feel slow." }, + { "speaker": "Cao Cao", "text": "Then we move before the mountain teaches them confidence." } + ] + } + ] + }, + { + "id": "pacified_guanzhong_feeds_pass_column", + "once": true, + "when": { "type": "turn_start", "team": "player", "turn": 2, "campaign_flags": { "pacified_guanzhong": true } }, + "actions": [ + { + "type": "dialogue", + "lines": [ + { "speaker": "Cao Ren", "text": "Guanzhong is quiet enough to keep the pass column supplied." }, + { "speaker": "Cao Cao", "text": "A quiet rear lets a narrow road feel wider." } + ] + } + ] + }, + { + "id": "prepared_hanzhong_front_lights_beacons", + "once": true, + "when": { "type": "turn_start", "team": "enemy", "turn": 2, "campaign_flags": { "prepared_hanzhong_front": true } }, + "actions": [ + { + "type": "dialogue", + "lines": [ + { "speaker": "Zhang Lu Border Guard", "text": "Cao Cao prepared for Hanzhong early. Light every pass beacon and make speed cost him." }, + { "speaker": "Zhang He", "text": "The pass is awake. We will have to cut through before it gathers." } + ] + }, + { + "type": "spawn_deployment", + "deployment": { + "unit_id": "hanzhong_beacon_riders", + "name": "Hanzhong Beacon Riders", + "class_id": "cavalry", + "team": "enemy", + "level": 36, + "pos": [16, 3], + "base": { "hp": 86, "atk": 34, "def": 18, "agi": 24 } + } + } + ] + }, + { + "id": "turn_4_pass_rituals", + "once": true, + "when": { "type": "turn_start", "team": "enemy", "turn": 4 }, + "actions": [ + { + "type": "dialogue", + "lines": [ + { "speaker": "Hanzhong Ritual Advisor", "text": "Hold the gates. Let the invaders learn how slowly a mountain opens." }, + { "speaker": "Guo Jia", "text": "They want delay to become belief. We cannot give them time." } + ] + } + ] + }, + { + "id": "hanzhong_approach_reached", + "once": true, + "when": { "type": "unit_reaches_tile", "team": "player", "officer_ids": ["cao_cao"], "pos": [10, 4] }, + "actions": [ + { + "type": "set_objective", + "victory": "The Hanzhong approach is reached. Defeat Zhang Lu's border guard.", + "defeat": "Cao Cao is defeated or the battle reaches Turn 18." + }, + { + "type": "dialogue", + "lines": [ + { "speaker": "Cao Cao", "text": "This is the approach. Break the border guard before Hanzhong closes its gates." }, + { "speaker": "Zhang Lu Border Guard", "text": "The gate is not yours because you can see it." } + ] + }, + { + "type": "spawn_deployments", + "deployments": [ + { + "unit_id": "hanzhong_gate_halberd", + "name": "Hanzhong Gate Halberd", + "class_id": "guard_captain", + "team": "enemy", + "level": 36, + "pos": [16, 4], + "base": { "hp": 102, "atk": 37, "def": 30 } + }, + { + "unit_id": "hanzhong_gate_archer", + "name": "Hanzhong Gate Archer", + "class_id": "archer", + "team": "enemy", + "level": 36, + "pos": [16, 5], + "base": { "hp": 80, "atk": 36, "def": 12, "agi": 25 } + } + ] + } + ] + }, + { + "id": "turn_9_gate_in_sight", + "once": true, + "when": { "type": "turn_start", "team": "player", "turn": 9 }, + "actions": [ + { + "type": "dialogue", + "lines": [ + { "speaker": "Xiahou Yuan", "text": "The gate road is in sight. Their border guard is running out of pass to hide behind." }, + { "speaker": "Cao Cao", "text": "Then make Hanzhong hear us before we knock." } + ] + } + ] + } + ], + "rewards": { + "gold": 7600, + "items": ["bean", "wine", "war_drum"] + }, + "post_battle_dialogue": [ + { "speaker": "Guo Jia", "text": "The Hanzhong approach is open. Zhang Lu must now decide whether his gates are walls or bargaining tables." }, + { "speaker": "Xiahou Yuan", "text": "We can secure the approach and bring up supplies, or press the gate before Zhang Lu's priests steady the defenders." }, + { "speaker": "Cao Cao", "text": "Hanzhong can be opened by patience or shock. Choose the first argument." } + ], + "post_battle_choices": [ + { + "id": "secure_hanzhong_approach", + "label": "Secure Approach", + "description": "Cao Cao secures the Hanzhong approach so the mountain column can advance safely.", + "set_flags": { "secured_hanzhong_approach": true, "pressed_zhang_lu_gate": false }, + "gold": 1200, + "items": ["imperial_seal"] + }, + { + "id": "press_zhang_lu_gate", + "label": "Press Gate", + "description": "Cao Cao presses Zhang Lu's gate before the Hanzhong defense can settle.", + "set_flags": { "secured_hanzhong_approach": false, "pressed_zhang_lu_gate": true }, + "gold": 1000, + "items": ["war_drum"] + } + ] +} diff --git a/docs/DATA_MODEL.md b/docs/DATA_MODEL.md index 719fe8a..69d34e4 100644 --- a/docs/DATA_MODEL.md +++ b/docs/DATA_MODEL.md @@ -49,6 +49,7 @@ data/scenarios/035_weishui_camps.json data/scenarios/036_weishui_crossing.json data/scenarios/037_guanzhong_foothold.json data/scenarios/038_ma_chao_retreat.json +data/scenarios/039_hanzhong_approach.json ``` ## Campaign @@ -99,7 +100,8 @@ The campaign file defines scenario order, resource paths, and officers who are a { "id": "035_weishui_camps", "title": "Weishui Camps", "path": "res://data/scenarios/035_weishui_camps.json" }, { "id": "036_weishui_crossing", "title": "Weishui Crossing", "path": "res://data/scenarios/036_weishui_crossing.json" }, { "id": "037_guanzhong_foothold", "title": "Guanzhong Foothold", "path": "res://data/scenarios/037_guanzhong_foothold.json" }, - { "id": "038_ma_chao_retreat", "title": "Ma Chao Retreat", "path": "res://data/scenarios/038_ma_chao_retreat.json" } + { "id": "038_ma_chao_retreat", "title": "Ma Chao Retreat", "path": "res://data/scenarios/038_ma_chao_retreat.json" }, + { "id": "039_hanzhong_approach", "title": "Hanzhong Approach", "path": "res://data/scenarios/039_hanzhong_approach.json" } ] } ``` diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 421a334..733827f 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -21,7 +21,7 @@ - Destination victory conditions and objective map markers exist. - Turn-limit conditions and HUD turn-limit display exist. - Victory reward summary is visible. -- Next-battle flow exists across the current thirty-eight-scenario campaign. +- Next-battle flow exists across the current thirty-nine-scenario campaign. - Campaign completion and new-campaign reset exist. - Reward inventory can be brought into the next battle. @@ -52,7 +52,7 @@ - Party roster persistence has a first save-file skeleton. - Level, experience, and equipment persistence. - Chapter selection and save/load. -- Linear thirty-eight-scenario campaign order exists. +- Linear thirty-nine-scenario campaign order exists. - Save reset exists. - Victory rewards, consumable counts, equipment stock, and equipped gear persist. - A basic pre-battle shop with scenario-specific stock exists. Sell-back and richer item management are still planned. @@ -98,6 +98,7 @@ - Thirty-sixth-scenario content exists with Wei River crossing pressure, Guanzhong foothold stakes, western alliance strain, and 035 branch reactions. - Thirty-seventh-scenario content exists with Guanzhong foothold pressure, Ma Chao's rearguard, split-alliance tension, and 036 branch reactions. - Thirty-eighth-scenario content exists with Ma Chao retreat pressure, Guanzhong commandery stakes, western road pursuit, and 037 branch reactions. +- Thirty-ninth-scenario content exists with Hanzhong approach pressure, Zhang Lu's border guard, mountain-gate stakes, and 038 branch reactions. ## Milestone 5: Presentation