Vassal & Suzerains: Villager Recruits Addon

Vassal and Suzerain 是 Recruits 的附属模组，为现有阵营系统添加了持久化的封建政治层。它允许阵营建立有组织的领主—封臣等级关系、执行头衔规则、管理纳贡义务，并在 UI 中直接查看这些关系，且不会修改 Recruits 模组本身。

核心封建等级关系：

• 每个阵营最多只能有一位直属宗主，但可以拥有多位直属封臣。
• 等级关系会持久保存，玩家重新登录或服务器重启后仍然有效。
• 系统会自动阻止循环等级关系。
• 阵营不能成为自己的宗主，也不能建立无效的等级循环。
• 等级关系基于阵营 ID 建立，因此系统轻量且由数据驱动。

头衔系统：

• 阵营可被授予以下三种头衔之一：

KING
DUKE
COUNT

头衔规则如下：

• KING 不能拥有宗主。
• DUKE 只能臣属于 KING。
• COUNT 只能臣属于 DUKE。
• 无效的头衔组合会被拒绝。
• 如果更改头衔会破坏现有封臣关系，系统将阻止此次更改。

成为封臣的流程：

• 在常规游戏流程中，宗主关系不会立即强制建立。

/feudal vassalize 会向目标阵营发送请求。

• 接收请求的阵营领袖必须接受或拒绝。
• 如果目标领袖不在线，请求会被保留，并在其下次登录时显示。

/feudal requests 会列出待处理请求，并提供可点击的接受/拒绝选项。

• 管理员仍可使用 set_suzerain 直接覆盖设置。

关系管理：

• /feudal release 仅对直属宗主有效。
• 封臣不能自行脱离其领主。
• /feudal hierarchy 会显示当前领主关系链。
• /feudal contract info 可让封臣随时查看当前生效的纳贡契约。

外交与叛乱：

• 直属领主与封臣之间受到保护，不受常规敌对行为影响。
• 封臣不能随意反复更改与宗主之间的战争状态。
• 叛乱通过外交关系启动：
• 封臣可将直属宗主设为 ENEMY，以发动叛乱。
• 叛乱期间，领主与封臣之间允许直接交战。
• 如果关系改回 NEUTRAL 或 ALLY，叛乱就会结束，双方关系也会被强制恢复为 ALLY。
• 叛乱结束后，该封臣默认 5 个现实天内不能再次叛乱。
• 叛乱期间以外，系统会阻止直属领主与封臣之间的直接攻击和锁定目标。
• 这些规则由附属模组侧执行，不会修改 Recruits 的内部内容。

纳贡契约系统：
宗主可以通过按键绑定 UI 为直属封臣配置纳贡契约。

纳贡契约包含：

• 目标封臣
• 缴纳物品
• 物品数量
• 现实时间间隔
• 纳贡 UI 支持按物品 ID 或显示名称搜索所有已注册物品。
• 物品列表会在客户端扫描并缓存，以便快速搜索。
• 纳贡间隔可设置为 2 分钟至 30 个现实天。
• 宗主使用 /feudal vault 绑定收取贡品的箱子。
• 封臣使用 /feudal tribute 绑定缴纳贡品的箱子。
• 每到纳贡时间间隔，如果条件允许，附属模组就会将封臣箱子中的对应物品转移到宗主箱子中。

纳贡契约的持久性与可靠性：

• 纳贡契约、绑定的箱子以及执行时间都会保存在持久化世界数据中。
• 纳贡设置在玩家登出/登录和服务器重启后仍会保留。
• 契约更新也会持久保存。
• 如果宗主在封臣领袖离线时更改纳贡契约，封臣会在下次登录时收到通知。
• 封臣随时都可以通过 /feudal contract info 查看当前的纳贡义务。

贡品账簿：

• 每个贡品周期都会自动记录。
• 宗主的箱子会收到一本书面账簿，记录付款历史。
• 成功转交的贡品会记录为已完成付款。
• 转交失败或部分转交时，会记录缺少的数量和物品。
• 如果账簿被移走或摧毁，下一个记录周期会生成一本更新后的新账簿。
• 账簿历史记录保存在已保存的契约数据中，因此书本只是可见副本，并非唯一记录。

派系与领地界面：

• Recruits 派系列表新增了层级视觉效果：
• 派系旗帜上方会显示宗主旗帜
• 下方会显示直属附庸旗帜
• 将鼠标悬停在条目上可查看层级关系链
• 领地显示文本会扩展以显示领主信息，但不会改变领地所有权。
• 在特殊地图模式之外，领地颜色仍为派系原本的常规颜色。

世界地图封建模式：

• Recruits 世界地图新增客户端 Feudal Colors（封建颜色）切换选项。
• 启用后，直属附庸领地会在本地重新着色，以匹配其宗主的颜色。
• 这纯属视觉效果，仅作用于客户端：
• 不会更改服务器数据
• 每位玩家都可以独立切换