Vassal & Suzerains: Villager Recruits Addon

加入我们服务器，体验大规模战斗： 服务器

Vassal and Suzerain（封臣与宗主）是招募者（Recruits）模组的一个附加组件，它在现有的派系系统之上增加了一层持久的封建政治体系。它允许派系形成结构化的君主-封臣等级制度，强制执行头衔规则，管理贡金义务，并直接在用户界面中查看这些关系，所有这些都无需修改基础的招募者（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）模组内部代码。

贡金契约系统：
宗主可以通过一个按键绑定界面为其直接封臣配置贡金契约。

贡金契约定义了：
- 目标封臣
- 支付的物品
- 物品数量
- 实时时间间隔
- 贡金界面支持按物品 ID 或显示名称搜索所有已注册物品。
- 物品列表会在客户端扫描并缓存，以实现快速搜索。
- 贡金时间间隔可从 2 分钟到 30 个现实日进行配置。
- 宗主使用 /feudal vault 命令绑定一个目标箱子。
- 封臣使用 /feudal tribute 命令绑定其支付箱子。
- 在每个贡金周期，如果可能，附加组件会将匹配的物品从封臣箱子转移到宗主箱子。

贡金的持久性与可靠性：
- 贡金契约、绑定的箱子以及执行时间都保存在持久性的世界数据中。
- 贡金设置能承受退出登录/重新登录和服务器重启。
- 契约更新也是持久性的。
- 如果宗主在封臣领袖离线时更改了贡金契约，封臣将在下次登录时收到通知。
- 封臣可以随时使用 /feudal contract info 命令查看他们当前的贡金义务。

贡金账簿：
- 每个贡金周期都会自动记录日志。
- 宗主的箱子会收到一本记录付款历史的手写账簿。
- 成功转移被记录为已完成付款。
- 失败或部分转移会被记录为缺失数量和物品。
- 如果账簿被移除或销毁，下一个记录周期会生成一本新的、更新后的账簿。
- 账簿历史存储在已保存的契约数据中，因此书籍只是可见副本，而非唯一记录。

派系与领地界面：
- 招募者（Recruits）派系列表增强了层级结构显示：
- 派系旗帜上方会出现一个宗主徽标
- 直接封臣的旗帜会出现在下方
- 悬停条目会显示层级关系链
- 领地显示文本被扩展，以在不改变领地所有权的情况下显示君主信息。
- 在非特殊地图模式下，领地颜色仍然保持派系自身的正常颜色。

世界地图封建模式：
- 招募者（Recruits）的世界地图包含一个客户端的“封建颜色”开关。
- 启用后，直接封臣的领地会在本地重新着色，以匹配其宗主的颜色。
- 这纯粹是视觉层面和客户端的：
- 不会改变服务器数据
- 每个玩家可以独立开关此功能