领土守卫系统

• 安装守卫 半径内领土定义 (Lv1 10m ~ Lv8 30m)
• 消耗燃料来 开启状态 维持
• 仅在开启状态下，区域内 建设与交互 可能
• 关闭时区域内所有建造/使用 屏蔽
• 等级越高 燃料仓库大小自动扩大 （1级 2x2 → 8级 5x6）

燃料系统（地区木材 + 树脂）

• 辅助燃料是 除Lv5（灰色传送点）外 所有等级 树脂 1个统一为
• 主燃料与生物群系相匹配 地区树木（树木/原木/古代树皮/硬木/世界树）。没有树木的山/海/灰烬之地，用黑曜石或两种木材组合替代
• 守卫 基础(Lv1)燃料 或 当前等级自身燃料，自动消耗这两种中库存较多的一种（无法使用中级燃料）
• 燃料消耗时，在守卫上方播放光环VFX + 完成效果音

白名单 & 入侵者警报

• Shift+E (安装者): 打开成员管理UI — 曾至少连接过一次服务器的 所有角色无论在线还是离线都会显示在同一列表中（已允许 ✔ / 未允许 ☐），点击名称即可立即切换允许或驱逐状态。当前在线时，名称旁边会显示“(在线)”
• Shift+R (未安装者)：守卫自行加入/退出（以前是Shift+E，但因与默认E（使用）输入重叠导致误操作问题，已改为Shift+R）
• 未授权玩家在区域内 尝试使用箱子或工作台如果（仅仅是走进区域内不会触发，10秒冷却时间）：
  • 播放警告音(sfx_morgen_alert)
  • 向白名单全体成员（安装者+已允许成员）发送屏幕中央警告消息
  • 入侵者头顶的红色“入侵者”标签（维持1小时）
  • 白名单全员 聊天窗口通知 发送

范围环 & 小地图标记

• 建设（布置棋子）时若在守卫附近 范围圈自动显示
• R键5米范围内的守卫范围环手动开/关切换
• 守卫放置 / 升级 / 被摧毁时 小地图标记自动更新

自动关闭

• 打开区域内的门时 5秒后自动关闭 （安装者专用）
• 在设置中可调整延迟时间

5级+领土护盾

• K键(默认): 消耗1个焰灵核心 → 1小时保护 开始
• 护盾激活中再次 K键按下即可立即 禁用 — 此时剩余时间不会消失，而是会被保存（保底机制）
• 在保存时间剩余期间内重新激活时 不消耗道具 从那时起继续
• 护盾半径始终与守卫的当前等级半径同步——即使开启护盾后再升级，也会立即扩大
• 护盾激活中：
  • 区域内 所有建筑(WearNTear) 伤害格挡
  • 区域内 玩家 伤害格挡
  • 区域内 怪物 无法获取目标
  • 投射物（箭矢等） 在穹顶边界拦截
  • 当怪物接近警戒范围时 提前转向逃跑至少，如果还是进来的话 立即被推出警戒线外 — 实际上怪物无法存在于区域内
  • 华丽 护盾特效穹顶 显示
• 护盾剩余时间：在守卫悬停文本中 所有玩家向……显示
• 区域内部时 屏幕底部以HUD显示剩余时间 显示

升级视觉效果/音效

• 守卫升级成功时播放特效和音效

管理员绕过 (Admin Bypass)

• F1 Config中开启后，可无视安装数量限制、安装材料费、升级材料/金币费用，立即安装和升级
• 燃料维护费仍然照常生效 — 用于测试/运营目的的管理员专用开关

U/K/R/Q 四个键全部在 F1 ConfigurationManager 的 通用 可以在分区中自由重新分配。

升级守卫后 半径·燃料·燃料仓库大小一起变大。
所有数值均可在 F1 Config 中由服务器管理员调整。

辅助燃料除Lv5（灰色侏儒之眼1个）外，所有等级均统一使用树脂1个。守卫只能选择Lv1燃料或自身等级的燃料，二者之一使用。

1. 靠近已安装的守卫（仅安装者可用）
2. Shift+E 按K键打开成员管理面板
3. 已识别角色 列表中会显示所有曾登录过服务器的角色——已授权的成员 ✔，尚未被允许的角色 ☐显示为，如果当前在线，名字旁边会加上“(在线)”
4. 点击名字即可 立即允许/踢除切换完成（离线角色也可点击预先添加）
5. 关闭 用按钮关闭面板

未安装者请代替使用 Shift+E Shift+R按可以自行加入/退出。

1. 守卫 5级以上升级为
2. 守卫燃料仓库里 1个焰灵核心 保管
3. 在守卫附近 K键（默认）点击 → 消耗1个焰灵核心，开始1小时保护
4. 生成护盾穹顶特效并在屏幕上显示激活提示（半径会根据守卫等级自动调整）
5. 悬停文本中实时显示剩余时间（所有玩家）
6. 在区域内时，画面下方显示剩余时间HUD
7. 再次 K键按下即可立即停用 — 剩余时间不会被丢弃，而是会保存
8. 在保存时间剩余期间重新激活时 不消耗物品 恢复，用完后又需要SurtlingCore

配置管理器 使用(F1 键)即可在游戏内通过图形界面调整所有设置。

配置文件位置

BepInEx/config/KorCaptain_territorial_ward.cfg

⚠️ 服务器同步(Server Sync)：所有设置项均 服务器管理员专用这是服务器管理员（英灵神殿 管理员列表（已注册的账户）在F1中更改值后，该值会 立即强制应用于所有已连接的客户端됩니다. 非管理员客户端无法在F1中修改这些项目（锁定），只能在自己的本地 .cfg 即使文件中保存了其他值，连接服务器时 会被服务器值忽略并覆盖.

1. 推荐：从 r2modman / Thunderstore 自动安装
2. 手动: BepInEx/plugins/Captain_territorial/ 将 DLL 复制到文件夹

⚠️ 服务器和客户端（玩家）双方都必须安装此模组。 只安装一侧会导致连接被拒绝或无法正常运行（网络兼容性：所有人都必须安装模组）。

领地守护系统

• 放置一个守卫以定义一个 基于半径的领地 （1级时10米，8级时最多30米）
• 消耗燃料以维持结界 开启
• 仅允许建造和互动 在活跃守卫区域内
• 抵挡 OFF = 所有建造和物品使用 格挡
• 燃料存储容量随等级自动提升 （1级时2x2 → 8级时5x6）

燃油系统（区域木材+树脂）

• 副燃料为 1x 树脂 每一级 除了5级，而是使用灰矮人的眼睛
• 主燃料是 生物群系对应的区域木材 （木材 / 圆木 / 古树皮 / 优质木材 / 世界之树木材）。没有天然木材的生物群系（山地 / 海洋 / 灰烬之地）改用黑曜石或两种木材类型的组合
• 结界可以消耗其 基础（1级）燃料 或其他 本级燃料，以有库存者为准（不能使用中间级别的燃料）
• 消耗燃料会在结界上方播放光环特效和完成音效

白名单与入侵警报

• Shift+E (创建者): 打开成员管理界面 — 显示 所有曾连接过该服务器的角色，在线或离线，统一显示在一个列表中（允许 = ✔，不允许 = ☐）。点击名字即可立即切换允许/踢出；当前已连接的玩家名字旁会显示“(在线)”标签
• Shift+R （非创建者）：自行加入/离开病室（已从Shift+E迁移，因其与原版E/使用输入冲突并误触发）
• 当一名未经授权的玩家 试图使用箱子或制作站 在区域内（仅走进区域不会触发此效果；每次警报冷却10秒）：
  • 警报音效 (sfx_morgen_alert)
  • 屏幕中央警告消息，针对每位白名单成员（所有者及获准成员）
  • 红 侵入者 / Intruder 头顶标签（持续1小时）
  • 聊天通知 向所有白名单成员广播

范围圈与小地图标记

• 守卫半径环 自动显示 在病房附近施工期间
• R键：手动切换结界5米范围内的范围环
• 小地图标记 自动更新 守护加载/升级/摧毁

自动关门

• 病房区内的门 5秒后自动关闭 （仅限所有者）
• 可通过配置设置延迟

5级+领地护盾

• K键 （默认）：消耗1个焰灵核心 → 开始 1小时保护
• 按下 K 激活时再次使用 立即停用 ——剩余时间会存入，不会丢失
• 仍有存储时间时重新激活将继续 免费 （未消耗物品）
• 护盾半径始终与守护技能的当前等级半径保持同步——在护盾存在期间升级会立即扩大半径
• 护盾激活期间：
  • 全部 建筑（耐久度） 在区域内：阻挡伤害
  • 全部 玩家 在区域：伤害已被格挡
  • 怪物 区域内部：无法获取目标
  • 弹射物 （箭矢等）被穹顶边界阻挡
  • 边界附近的怪物 转身逃跑 提前，而任何仍然进入内部的 立刻被推回外面 — 怪物实际上无法存在于该区域内
  • 护盾 特效穹顶 已显示
• 护盾剩余时间显示在悬停文本中，以便 所有玩家
• 抬头显示 进入区域时显示在屏幕底部

升级特效/音效

• 当结界升级成功时播放视觉效果和音效

管理员绕过

• 在F1配置中切换以完全忽略放置限制、放置材料费用以及升级材料/金币费用——即时放置/升级
• 燃料维护费仍照常扣除——仅供管理员用于测试或运营的开关

全部4个按键（U/K/R/Q）均可自由重新绑定，在 通用 F1配置管理器的部分。

升级结界会扩大其 半径、燃料需求和存储容量 一起。
所有数值均可由服务器管理员通过F1配置进行调整。

次级燃料始终为1x树脂，但Lv5使用1x灰矮人眼代替。结界只能使用其Lv1燃料或自身等级的燃料。

1. 将结界升级至 5级或以上
2. 放置 1x 焰灵核心 在病房的燃料储存区
3. 站在守卫附近并按下 K (默认) → 消耗1个焰灵核心，开始1小时保护
4. 护盾穹顶特效出现并显示激活提示（半径自动匹配结界等级）
5. 所有玩家悬停文本中显示的剩余时间
6. 屏幕底部的HUD在区域内会显示剩余时间
7. 按下 K 再次按下即可立即停用——剩余时间会保留，不会丢弃
8. 在存入时间仍有剩余时重新激活将继续 免费；一旦耗尽，需再次使用焰灵核心

使用 配置管理器 (F1 键) 通过图形界面调整游戏内所有设置。

配置文件位置

BepInEx/config/KorCaptain_territorial_ward.cfg

⚠️ 服务器同步每项设置均 仅限服务器管理员。当服务器管理员（即列于 Valheim 的 管理员列表改变F1中的一个数值，它是 立即强制应用于所有已连接客户端非管理员客户端无法在F1中编辑这些设置（已锁定），即使客户端在其本地保存了不同的值 .cfg 文件，它是 被服务器值忽略并覆盖 连接时。

1. 推荐通过 r2modman / Thunderstore 安装
2. 手动：将 DLL 复制到 BepInEx/plugins/船长领地/

⚠️ 服务器和每位客户端（玩家）都必须安装此模组。 如果只有一方安装了它，连接将被拒绝，或者模组无法正常运行（网络兼容性：所有人都必须安装此模组）。