项目地址

王国战争

王国战争

王国战争 是一个适用于 Minecraft 1.21.3 的 Fabric 王国玩法模组。当前版本聚焦于建立王国、自动生成主城、保护领地、管理资源、生成国民和士兵，并通过宣战攻打、占领敌方城池。

运行版本

• Minecraft：1.21.3
• Fabric Loader：0.18.4
• Fabric API：0.114.1+1.21.3
• Java：21
• 模组编号：kindom

当前新增内容

当前版本新增两个可放入创造模式栏的内容：

• kindom:city_core：主城核心
• kindom:command_staff：指挥棒

创造模式栏名称为：

王国战争

其他城池建筑全部使用原版方块生成，不再新增专有建筑方块。

创造模式测试流程

建议使用开启作弊的创造模式测试世界。

1. 到主世界任意想建立主城的位置。平原、森林、山坡、水面、峡谷边都可以创建，系统会强制开辟主城空间。

2. 创建王国：

mcfunction /kingdom create SparkKingdom # 创建测试王国

该命令会自动生成主城。

3. 如需手动测试道具，可以获取主城核心和指挥棒：

mcfunction /give @p kindom:city_core # 获取主城核心 /give @p kindom:command_staff # 获取指挥棒

主城核心 道具手动放置仅用于创造管理员调试，会检查城池距离和重名；正常生存扩张请使用 主城控制台 的 分城扩张 页。

自动生成主城内容

内容	数量或规格
地基	100x100
围墙	5 格高
城门	南侧开放式入口
主城核心	1 个，位于中心主城议政厅内；议政厅是可进入大殿，带环形广场、高台地基、双层台阶、四向入口、四向门牌、南侧仪仗门廊、大拱门、外墙柱廊、高窗窗框、可进入角塔、分层屋顶、加厚檐口、屋顶副塔、中心高尖顶、二层回廊、观礼席、核心纹章、核心护栏、王座高台、王座旗墙、议事圆桌、战争沙盘、王国地图档案区、资源账房、军事命令区、分城档案区、地下入口、王国宝库、彩色动线和中文功能标识
仓库	军械仓库结构，带石砖地基、混凝土墙面、射击孔、宽幅门楼、军绿色屋顶、干净装卸棚、整齐内仓货架、战术桌、二层仓储平台、可攀登梯子和工作区
兵营	城防兵营结构，带石砖地基、混凝土墙面、射击孔、开放式宽幅门楼、升起的闸门、旗帜、战术大厅、左翼锻造区、二层战术平台、武器架、阅兵前场、训练场和靶场
农庄	分块农田、水渠、小桥、大谷仓、强化风车、粮仓塔、牧场、鸡舍、果园、采摘棚、农民休息棚、农庄岗亭、稻草人和农灯
民居	多栋一层和两层民居，带门牌、院落、花草、公共水井、居民小集市、街区灯、绿化隔离带和生活内饰
箭塔	4 座城防箭塔，带加宽石基、多层塔身、射击孔、连续内部梯井、分层内饰、顶部平台、垛口、旗帜、红陶塔顶和发射器
城市景观	主城核心广场、环形石路、十字主路、喷泉、纪念碑、旗杆、区位牌、长凳、路灯、树木、花坛、排水沟、小桥、民居院落、装卸区、训练场、公告栏、任务发布栏、公共市场、王国雕像和高灯柱
军事景观	南门检查站、左右岗亭、沙袋线、拒马、警示灯、指挥帐篷、医疗帐篷、补给棚、武器箱、马厩与载具区、训练靶位、雷达杆、仓库燃料罐、载具库、兵营战壕训练线和内侧碉堡点
国民	6 个
农民	2 个，手持木锄，提高粮食产出
工兵	1 个，手持木镐，提高木材、石料、铁产出并修复主城核心
民兵	2 个，手持木斧
剑士	1 个，手持木剑
建筑告示牌	主城核心、主城议政厅、军械仓库、后勤载具库、燃料储备罐、城防兵营、训练靶场、农庄、民居、城防箭塔、战术指挥帐、南门岗亭和城防碉堡附近各有中文标识

生成规则：

• 当前版本只支持在主世界生成。
• 主城美化完成情况见 CITY_BEAUTY_CHECKLIST.md，议政厅、围墙、仓库、兵营、箭塔共 100 条建议已逐项完成。
• 主城其他内容美化完成情况见 CITY_OTHER_BEAUTY_CHECKLIST.md，农庄、民居区、中心广场与道路、南门检查站与军事外景、城市公共景观与功能设施共 100 条建议已逐项完成。
• 生成区域不能和已有城池范围重叠。
• 不再检查平地、水面、高差、树木或箱子等带数据方块；主城会直接清理和覆盖生成范围内原有方块。重要物品不要放在建城范围内。
• 系统会在 100x100 范围内采样地表高度，选择较稳定的开辟高度，削平过高地形，排空水体，并把空气、峡谷、水下空间向下填实到可承重方块。
• 新生成的主城会在主城核心、军械仓库、后勤载具库、燃料储备罐、城防兵营、训练靶场、农庄、大谷仓、粮仓塔、牧场、果园、农庄岗亭、民居、公共水井、居民小集市、城防箭塔、战术指挥帐、南门岗亭、医疗帐篷、前线补给点、公共市场和城防碉堡附近放置中文告示牌。

复杂地形开辟建议：

地形	生成效果
平原、森林	清理树木和杂物，形成标准 100x100 主城地基
山坡、峭壁	平台会切入高处山体，低洼侧会补石头基础
水面、沼泽	会排水并填到水底或可承重方块，主城不会漂浮；南门外会尝试生成小码头
洞穴、峡谷	城池每一列都会向下补基础，减少悬空城墙和悬空地面；南门外落差较大时会生成石桥
高山复杂地形	会优先保证功能可用和地基稳定，外缘会出现石砖护边、角部支撑和城门引道

旧存档中已经生成过的主城不会自动补出新告示牌。站在城池范围内执行下面的命令，可以补放或刷新建筑告示牌：

/kingdom city signs # 补放或刷新当前城池的建筑告示牌
/kingdom city layout # 输出当前城池最高级建筑占地和布局验证报告

已实现命令

/kingdom create <kingdom_name> # 创建王国并自动生成主城
/kingdom leave # 普通成员退出当前王国
/kingdom disband # 国王解散自己的王国
/kingdom disband <kingdom_name> # 管理员清理指定王国
/kingdom info # 查看当前王国信息
/kingdom city info # 查看当前所在城池信息
/kingdom city layout # 输出当前城池最高级建筑占地和布局验证报告
/kingdom city found <city_name> # 在面前建立分城
/kingdom city explore # 探索当前城池附近最近的 3 座城池
/kingdom city signs # 给当前城池补放建筑告示牌
/kingdom city upgrade <wall|warehouse|barracks|farm|arrow_tower> # 升级城墙、仓库、兵营、农庄或箭塔
/kingdom city upgrade_all # 管理员一键升级当前城池全部主城建筑
/kingdom war declare <target_kingdom_name> # 向目标王国宣战
/kingdom war status # 查看战争状态
/kingdom resource add <wood|stone|iron|food|coin|crystal> <amount> # 管理员增加王国资源
/kingdom resource fill # 管理员一键补满当前王国所有资源
/kingdom soldier spawn <farmer|engineer|militia|swordsman|archer> <amount> # 管理员生成工种或士兵

城池等级

等级	半径	核心最大生命值
1	50	500
2	70	900
3	90	1500
4	110	2400

当前版本新建主城默认为 1 级，半径 50 格，核心生命值 500。初始城墙覆盖 100x100 区域，每次升级城墙都会向外扩展 20 格。

王国资源

资源参数	中文名
木材	木材
石料	石料
铁	铁
粮食	粮食
金币	金币
魔晶	魔晶

管理员或创造模式测试时可以直接添加资源：

/kingdom resource add wood 500 # 增加木材
/kingdom resource add stone 500 # 增加石料
/kingdom resource add iron 200 # 增加铁
/kingdom resource add food 500 # 增加粮食
/kingdom resource add coin 100 # 增加金币
/kingdom resource add crystal 10 # 增加魔晶
/kingdom resource fill # 管理员一键补满当前王国所有资源

查看当前王国信息和资源：

/kingdom info # 查看当前王国信息和资源

生存玩法中也可以直接提交资源：手持可提交物品右键自己王国城池的 主城核心。提交资源时超过上限的部分不会入库。

手持物品	增加资源
原木	木材 x4
圆石、石头、石砖	石料 x1
铁锭	铁 x1
小麦、胡萝卜、马铃薯	粮食 x1
金锭	金币 x10
紫水晶碎片	魔晶 x1

资源上限会按王国规模计算：基础上限 1000，每座城池额外增加 500，仓库升级和贸易城专精会继续增加上限。王国等级字段目前为后续系统预留，现阶段主要通过城池、仓库和分城专精提高上限。资源上限会按当前实际拥有的城池重新计算，占领或失去城池后不会保留旧城池的仓储加成。

王国每 5 分钟会自动按城池数量产出资源。基础产出会被建筑等级、人员数量和主城策略修正：

每座城池	自动产出
木材	基础产出，工兵和仓库等级会提高产出
石料	基础产出，工兵、城墙和箭塔会提高产出
铁	工兵、2 级兵营和 3 级仓库会提高产出
粮食	基础产出，农庄等级和农民会提高产出
金币	基础产出，仓库等级和高级城池会提高产出
魔晶	3 级城池配合 3 级箭塔后开始产出

农庄每升 1 级，每座城池额外增加粮食产出 8。仓库每升 1 级，每座城池额外提高资源上限、金币和部分木材产出。每个农民额外增加粮食产出 6；农民实体白天还会在所属城池农庄附近收割成熟作物、补种小麦或少量上交粮食。2 级以上农庄附近，农民会照料牛、羊、猪、鸡并提高粮食收益。每个工兵额外增加木材、石料和铁，并在产出结算时修复主城核心；工兵实体也会周期性消耗石料、铁和金币修复所属城池核心，核心满血时会消耗少量石料和金币维护城墙、箭塔、道路和城门引道。

主城控制台

空手或手持不可提交物品右键自己王国城池的 主城核心，会打开 主城控制台。

主城控制台 是分页界面，底部导航可以切换：

• 王国总览：查看王国、城池、资源、人口、空闲人口、工作效率、防御、训练队列，并切换 均衡发展、生产优先、防御优先、修复优先。
• 建筑管理：升级城墙、仓库、兵营、农庄、箭塔。
• 训练征兵：训练农民、工兵、民兵、剑士、弓兵，并查看至少前 5 个训练队列。
• 分城扩张：面对想扩张的方向建立分城，并给分城选择专精。
• 探索侦察：探索当前城池附近最近的 3 座城池，并显示威胁和预估兵力。
• 城池维护：修复主城核心、城墙、箭塔、主城地基、城内道路、城门引道，补放建筑告示牌，检查城池结构，清理城内敌对生物。
• 资源管理：查看当前库存、上一轮 5 分钟资源结算明细和 王国任务。
• 外交战争：查看战争记录，向其他王国宣战。

王国总览 页里的 输出详细报告 会把完整城池信息发送到聊天栏，刷新控制台 会重新读取最新数据。每个按钮都会显示中文名称、消耗、权限和当前状态。切换策略、升级、训练、扩张、维护和宣战都需要本王国管理权限或创造管理员权限。如果主城核心不属于你的王国，只会显示简单城池报告，不能打开手动操作区。

城池建筑升级

站在自己王国的城池范围内升级建筑：

/kingdom city upgrade wall # 升级城墙
/kingdom city upgrade warehouse # 升级仓库
/kingdom city upgrade barracks # 升级兵营
/kingdom city upgrade farm # 升级农庄
/kingdom city upgrade arrow_tower # 升级箭塔
/kingdom city upgrade_all # 管理员一键升级当前城池全部主城建筑

英文参数也可以用于测试：wall、warehouse、barracks、farm、arrow_tower。创造模式 2 级以上管理员可以升级当前所在城池，普通玩家需要是本王国管理成员。升级会消耗木材、石料、铁、粮食、金币等王国资源。资源不足时命令或 主城控制台 按钮会显示本次升级需要的资源。生存模式推荐直接右键 主城核心，在 建筑管理 页升级，命令主要用于测试、排查和管理员维护。

建筑	最高等级	当前效果
城墙	4	提高城池等级、城池范围和核心生命，向外扩展 20 格，把新增城区平整到主城同一高度，并向下填充到可承重地面
仓库	3	提高王国资源上限，并横向扩建、增加楼层和储物空间
兵营	3	提高训练队列容量，缩短训练时间，并横向扩建、增加楼层、战术内饰和功能方块
农庄	3	提高粮食自动产出，并在安全区域分区扩建农田、牧场和果园
箭塔	3	提高自动防御伤害，并加宽塔身、加高楼层和顶部平台

主城建筑采用分散布局：仓库在西南侧，兵营在东北侧，农庄在东南侧，民居在西北侧，箭塔靠近四角但不会贴到城墙。建筑外观不再局限于单一拜占庭风格，而是混合王国要塞、军事基地、前线营地、补给站、碉堡、控制塔和公开 schematic 城堡蓝图常见的主体量块语言。当前实现不会把第三方 .schematic 或 .schem 文件直接打包进模组，而是把蓝图里的比例、层级、屋顶、塔楼、楼梯、内饰分区和照明方式转成原创程序化生成规则。

主城议政厅会在初始生成和城墙升级后重建为中心大殿：保留主城核心交互空间，增加环形广场、高台地基、双层台阶、四向入口、四向门牌、南侧仪仗门廊、大拱门、外墙柱廊、高窗窗框、可进入角塔、分层红陶屋顶、加厚檐口、中心高尖顶、屋顶副塔、旗帜序列、夜间轮廓照明、二层回廊、观礼席、核心纹章、核心护栏、王座高台、王座旗墙、议事圆桌、细化战争沙盘、王国地图档案区、资源账房、军事命令区、分城档案区、地下入口、王国宝库、吊灯和彩色动线。

城墙升级会补双层防御墙、闭环巡逻道、垛口火盆、四角角楼、中段哨塔、双塔门楼、门卫室、补给壁龛、外侧水壕、木栅栏和铁栏防线。升级城墙时会先清理旧半径城墙、旧墙地基线和旧南门门楼，再把新增城墙范围内的高山、泥土堆和多余地形清掉，把新城区地皮压到主城同一水平线，并向下填充空气、水和不可承重方块，直到外城墙和新增地皮接触可承重地面。

仓库升级会重建为更完整的军械后勤库，新增分类资源区、账房、货梯、地下粮仓、称重点、通风塔、多层回廊、燃料罐、载具库和雷达杆，门口不再堆放杂乱箱子。兵营升级会重建为多开间城防营房，移除悬空床，新增二层指挥室、观礼栏杆、军官办公室、地下武器库、格斗训练圈、阅兵前场、训练场、靶场、武器架、锻造设备、战壕训练线、沙袋线和小型训练碉堡。箭塔升级会重建为更宽石基、更高塔身、多层射击孔、连续内部梯井、休息区、箭矢储备区、分层灯光、顶部平台、红陶塔顶、避雷针、发射器、补给箱、外侧防线和连接城墙巡逻道的短桥。

农庄升级不会再用一个越来越大的正方形覆盖周围建筑，而是在固定安全地块分区扩展，新增水渠小桥、大谷仓、强化风车、粮仓塔、采摘棚、农民休息棚、牧场、果园、稻草人、农灯、农庄岗亭和小型防御碉堡，避免破坏箭塔、仓库、兵营、民居、道路或城墙。初始主城还会生成居民街区、环形广场、公共市场、公告栏、任务发布栏、排水沟、高灯柱、王国雕像、南门医疗帐篷、补给棚、拒马和前线训练靶位，让升级前也有完整生活区、公共设施和军事外景。扩建出来的新城区还会按确定性随机规则补给小型基建，包括补给棚、灯光小广场、集合训练场和取水点，并为这些小基建放置中文告示牌。

高级升级有前置条件：城墙 3 级需要仓库、兵营、农庄、箭塔都达到 2 级；城墙 4 级需要这些建筑都达到 3 级。仓库、兵营、农庄、箭塔升到 3 级时，也会检查对应的城墙、仓库或兵营等级。资源足够但前置建筑不足时，命令和控制台都会显示原因。管理员测试命令不会逐项检查升级消耗，/kingdom city upgrade_all 会直接把当前所在城池的全部主城建筑升到最高等级并应用外观。

管理员测试时可以先使用 /kingdom city layout 查看最高级建筑占地和布局验证报告，再使用 /kingdom resource fill 补满当前王国资源，最后使用 /kingdom city upgrade_all 一键升级当前城池所有主城建筑。如果先一键升级仓库导致资源上限变高，可以再执行一次补满。

分城扩张

本王国管理成员可以通过 主城控制台 建立分城：右键本王国 主城核心，切到 分城扩张 页，面对想扩张的方向，点击 建立分城。系统会在当前城池边界外自动寻找空地，自动命名为 王国名分城编号，并生成一个小型主城核心平台。

命令入口仍然保留，适合测试或手动命名：

/kingdom city found EastOutpost # 在面前建立名为 EastOutpost 的分城

生存模式建立分城会消耗木材 300、石料 500、粮食 150、金币 120。按钮会按玩家当前朝向在城池边界外找点；命令会在玩家面前找点。两种方式都会检查是否距离已有城池太近，避免分城范围和旧城池范围重叠。分城会加入王国资源体系，但不会自动生成完整主城建筑，仓库、兵营、农庄和箭塔初始为 0 级；只有实际升级或选择对应专精后才会产生建筑、防御和产出效果。

分城建立后可以在 分城扩张 页选择专精，选择专精会消耗木材 120、石料 120、粮食 80、金币 80。当前版本专精不能免费重置。

分城专精	生存效果
农业城	生成小农田和堆肥区，提高粮食产出和农民效率
矿业城	生成矿井入口和熔炉区，提高石料、铁和少量魔晶产出
军事城	生成训练场，提高训练队列容量并缩短训练时间
贸易城	生成市场，提高金币产出并增加资源上限
边防城	生成小箭塔，提高箭塔伤害和守城扫描范围

城池维护和资源明细

城池维护 页提供以下生存操作：

操作	消耗和效果
修复主城核心	消耗石料、铁、金币，核心生命恢复到上限
修复城墙	按当前城墙等级补回主结构
修复箭塔	按当前箭塔等级补回塔身、连续梯井、分层内饰、平台和发射器等关键结构
修复主城地基	重建外缘护坡、支撑和平台边带
重铺城内道路	恢复十字主路、中心广场、支路、花坛、树木、装卸区、训练场、农庄入口和主城基础军事景观
重建城门引道	重建南门外石质引道，并根据地形恢复码头、石桥或引道
检查城池结构	不消耗资源，检查主城核心、城墙、道路和关键建筑是否缺失
补放建筑告示牌	消耗少量木材，重新放置军械仓库、城防兵营、训练靶场、后勤设施、箭塔、岗亭和碉堡等中文告示牌
清理城内敌对生物	消耗金币和魔晶，只清理本城范围内敌对生物

资源管理 页会显示上一轮 5 分钟结算明细，包括每座城池的专精、木材、石料、铁、粮食、金币、魔晶产出，以及人口和工种带来的维护粮食消耗。工兵仍会在结算时自动修复少量核心生命，修复优先 策略会提高这个数值；已加载的工兵实体还会在核心受损且王国资源足够时进行小额周期维修，核心满血时会进行结构维护。

资源管理 页也包含 王国任务。任务进度直接根据已有数据计算，完成后本王国管理成员可以点击任务图标领取资源奖励，奖励领取状态会保存，不能重复领取。

王国任务	完成条件	奖励
建立第一座分城	拥有至少 2 座城池	木材、石料
组织生产队伍	农民和工兵合计达到 4 人	粮食、木材
完成基础防线	任意城池拥有 2 级城墙和 2 级箭塔	石料、铁
整备兵营	任意城池拥有 2 级兵营，且训练队列容量至少 6	铁、金币
建立侦察网络	同一世界已记录至少 3 座其他城池	金币、魔晶

探索侦察

探索侦察 页会自动显示与当前城池在同一维度的最近 3 座已记录城池。探索结果包括：

• 城池名称
• 所属王国
• 与本王国关系：本国、中立、敌对
• 与当前城池的水平距离
• 城池等级、范围和核心生命
• 城池专精
• 威胁类型和预估兵力
• 城池核心坐标

探索结果可能包含本国分城、其他玩家王国城池，也可能包含偶发生成的 流亡王城。如果当前世界没有其他已记录城池，会显示 未发现城池。

命令入口也可以用于创造模式验证：

/kingdom city explore # 在聊天栏输出当前城池附近最近的 3 座城池

退出和解散王国

普通成员退出当前王国：

/kingdom leave # 普通成员退出当前王国

国王解散自己的王国：

/kingdom disband # 国王解散自己的王国

管理员清理指定王国：

/kingdom disband SparkKingdom # 管理员清理指定王国

规则：

• 普通成员可以使用 /kingdom leave 退出王国。
• 国王不能直接退出王国，需要使用 /kingdom disband 解散王国。
• 解散王国会删除王国数据、该王国城池数据和相关战争记录。
• 自动生成出来的原版建筑不会被删除，会保留为普通地形。

士兵系统

士兵参数	中文名	定位
farmer	农民	农业和畜牧工种，提高粮食产出，白天处理作物和牲畜
engineer	工兵	建造、采集和维修工种，提高木材、石料、铁产出，修复核心并维护结构
militia	民兵	低级近战单位
swordsman	剑士	标准近战单位
archer	弓兵	中距离远程单位

生成士兵：

/kingdom soldier spawn farmer 5 # 生成 5 个农民
/kingdom soldier spawn engineer 5 # 生成 5 个工兵
/kingdom soldier spawn militia 5 # 生成 5 个民兵
/kingdom soldier spawn swordsman 5 # 生成 5 个剑士
/kingdom soldier spawn archer 5 # 生成 5 个弓兵

士兵会保存所属王国和所属城池。战争期内，士兵会自动攻击敌对王国士兵和非创造模式、非旁观模式的敌对玩家。

本国人员会随所属城池等级自动升级装备：

城池等级	防具	武器和工具
1	皮革装备	木制剑、斧、锄、镐，弓兵使用弓
2	铁装备	铁剑、铁斧、铁锄、铁镐，弓兵使用弩
3	钻石装备	钻石剑、钻石斧、钻石锄、钻石镐，弓兵使用弩
4	下界合金装备	下界合金剑、斧、锄、镐，弓兵使用弩

城池升级成功后，会立即刷新本城已加载的士兵、国民、农民和工兵装备。旧存档里已经存在的人员会在实体 tick 时自动补齐装备。防具升级不是只换属性数据：头盔、胸甲、护腿和靴子都会穿到对应装备槽位，并在客户端士兵模型上显示出来。

主城兵营可以训练单位：右键兵营中的锻造台。也可以右键 主城核心 打开 主城控制台，切到 训练征兵 页点击训练按钮。训练不会立即生成，而是进入兵营队列，倒计时完成后自动在兵营生成单位。训练会消耗王国公共资源，因此只有本王国管理成员或创造管理员可以下达训练。

兵营侧前方有 城防兵营 告示牌，附近还有 训练靶场 告示牌。进入兵营后，锻造台在左翼墙边；从主城核心位置看，兵营大门大约在东 30 格、北 19 格处，锻造台会随兵营升级沿左翼外移，初始大约在东 24 格、北 23 格处，最高级大约在东 20 格、北 23 格处。兵营升级后不会再生成悬空床，内部改为红毯中轴、战术桌、长凳、武器架、吊灯和锻造区。旧城池如果兵营坐标记录不准，第一次右键城内真实锻造台时会自动修正。

主手物品	训练单位	消耗
木锄	农民	木材 6、粮食 8
木镐	工兵	木材 10、铁 1、粮食 6
木斧	民兵	木材 8、粮食 4
木剑	剑士	木材 6、铁 2、粮食 6
弓	弓兵	木材 10、粮食 6

士兵行为：

• 不需要指挥棒手动下令。
• 会自动巡逻。
• 一定范围内出现敌对王国玩家或士兵时，会自动靠近并攻击。
• 弓兵会在中距离自动造成远程伤害。
• 无目标且离所属城池过远时，会自动回防到主城核心附近。
• 夜晚时，本城士兵、国民、农民和工兵会自动攻击城池防御范围内的敌对生物，包括苦力怕、僵尸、蜘蛛、女巫等。
• 夜晚或离城过远时，国民、农民和工兵会优先回防到所属主城核心附近；白天安全时，农民会处理农庄作物、补种小麦和照料牲畜，工兵会维修受损核心或维护城墙、箭塔、道路和城门引道。
• 指挥棒用于编队和战略目标：右键本国士兵加入当前编队，潜行右键本国士兵移出编队；潜行右键地面设置集结点；右键己方主城核心设置回防目标；右键战争期敌方主城核心设置进攻目标。默认会复用同一个第一编队，所以可以先设置目标再逐个加入士兵。士兵仍会自动攻击敌人，指挥棒只改变行动区域和目标优先级。

战争系统

宣战可以通过生存界面完成：右键本王国 主城核心，切到 外交战争 页，点击目标王国按钮。宣战消耗铁 30、粮食 120、金币 180。宣战后先进入 10 分钟准备期，准备期可以调兵但不能占领敌方核心；战争期开始后才能破坏并占领敌方核心。战争结束后有冷却时间，不能立刻重复宣战。

管理员测试命令仍然保留：

/kingdom war declare <target_kingdom_name> # 向目标王国宣战
/kingdom war status # 查看战争状态

战争时间规则：

• 宣战准备期：10 分钟
• 战争期：60 分钟

准备期内不会立即进入战斗状态。战争期开始后，双方王国会被视为敌对关系，士兵会自动索敌，敌方玩家可以攻击主城核心，城池箭塔会自动攻击进入城池范围的敌人。战争状态会显示双方占领比分和剩余时间。

世界中会低概率在玩家王国附近生成流亡势力。流亡势力只会在目标城池附近有在线玩家时尝试生成，避免营地落在长期不模拟的区块。根据玩家城池等级和随机结果，它可能生成 小型据点、中型城寨 或 大型王城，拥有不同规模的围墙、塔楼、资源、兵力和战争准备时间。准备期结束后会进入战争期，并派出袭击编队向玩家城池核心推进。如果袭击编队长期靠近核心，会持续降低核心生命，核心生命归零后城池会被流亡势力占领。

攻城和占领

1. 一个王国向另一个王国宣战。
2. 等待 10 分钟准备期结束。
3. 进入战争期。
4. 进攻方攻击防守方主城核心。
5. 攻击核心时会显示核心生命和占领进度。
6. 进攻者附近的本方士兵越多，核心受到的单次伤害越高。
7. 主城核心生命值降到 0 后，城池归属转移给进攻方。
8. 被占领城池的核心生命值会恢复到该等级最大值。

占领规则：

• 攻击敌方主城核心会降低核心生命并提高占领进度；核心附近必须至少有 1 名本方士兵，玩家攻击才会推进攻城。
• 核心伤害有短暂冷却，不能靠连续点击瞬间占城。
• 附近本方士兵越多，单次攻击核心造成的伤害越高。
• 核心生命降到 0 后，城池归属转移给进攻方。
• 占领城池会奖励木材、石料、铁、粮食、金币；3 级以上城池还会奖励魔晶。

自动防御

• 箭塔会按四座塔的位置分别扫描附近敌对玩家和敌方士兵，只攻击从塔顶可见的目标。
• 只有战争期的敌对目标会被箭塔攻击。
• 箭塔等级越高，单塔扫描距离和自动防御伤害越高，边防城会额外提高守城效果。
• 每座箭塔有独立冷却；箭塔触发防御时，会向在线王国成员发送中文提示。

领地保护

• 非本王国玩家不能在和平期间破坏城池范围内方块。
• 非本王国玩家不能在和平期间操作城池范围内方块。
• 2 级以上权限的创造模式管理员不受该保护限制，方便测试。

数据保存

王国、城池、战争和资源数据会按世界保存到：

kindom.json

开发命令

构建模组：

./gradlew build # 编译并打包模组

检查主城美化生成器和文档是否同步：

node scripts/validate_city_beauty.js # 检查主城美化生成器、最高级占地和中文文档描述
./gradlew compileJava # 编译 Java 代码，确认主城美化生成器能通过 Fabric 1.21.3 编译
./gradlew build # 打包模组并运行资源文件校验

启动开发客户端：

./gradlew runClient # 启动开发客户端，进入创造世界实地查看建筑效果