将盔甲架连接至附近的箱子，以自动循环轮换多套盔甲和武器的外观展示。

护甲展示馆

护甲图鉴 将你的英灵神殿盔甲架变为动态旋转的展示画廊！将一个或多个箱子链接到盔甲架，即可定期自动轮换整套护甲和武器套装，或通过简洁的游戏内界面来管理、切换、摆姿势和配置你的装备展示厅。

---

✨ 功能

• 多宝箱定向连锁： 将最多12个箱子（可配置）连接到单个盔甲架，距离限制可配置（5米–30米）。
• 目标链接模式： 使用以下方式进入连结模式 <左Shift + E> 当看着一个架子时，金色粒子连接轨迹会实时直观地显示哪些宝箱是相连的。只需看着任意宝箱并按下 <E> 将其链接或取消链接。
• 严格1:1宝箱对应： 通过确保每个箱子只与一个盔甲架绑定，防止重叠。
• 宝箱界面集成与分页： 打开链接的宝箱会显示一个自定义护甲展柜标题，展示所链接展示架的名称、已配置套装总数、当前姿态、武器姿态切换（已装备 对 已收起），以及快捷热键（Q / E无缝浏览所有关联宝箱。
• 连续套装轮换： 将所有相连的箱子中的箱子行整理为连续的套组（例如箱子1拥有套组1–4，箱子2拥有套组5–8），并定期循环切换。
• 多种循环模式：
  • 顺序： 按要求逐行依次循环遍历已连接的箱子。
  • 随机行： 每轮随机选择一套完整的护甲套装。
  • 混沌： 将随机行中的单件护甲和武器槽位混搭，打造狂野的外观组合。
• 一键快速装备与套装切换： 宝箱界面中的每一行都设有一个专用的 装备 按钮。点击它即可立即将整套装备穿戴到你的角色身上，一键将你当前穿戴的护甲、披风、武器和盾牌直接换入该箱子行！
• 姿势与站姿自定义：
  • 骑行中随时切换站立姿势，使用 左Alt + E.
  • 切换武器姿态于 已装备 (手持)并且 已收起 （在髋部/背部）。
  • 可选配置选项，用于在每个轮换周期自动随机化姿势和/或武器姿态！
• 100%原版安全且无损： 物品始终直接存储在原版箱子库存中。没有自定义物品或专有数据库序列化。如果卸载模组，所有装备都会安全无损地保留在你的箱子里。
• 多人同步： 基于强大的邻近权威和ZDO网络同步构建。最近的活跃玩家驱动旋转间隔，避免不同步、所有权争夺或屏幕闪烁。当有人正在编辑链接时，其他玩家会被锁定在外，以防止竞态条件。

---

📦 支持的宝箱与容器规则

• 兼容容器（严格白名单）： 为保证完全可靠并避免UI或物品栏冲突，链接严格限制为6种官方玩家建造的存储部件：
  • 🪵 木箱 （5列×2行＝最多2组，每组5件）
  • 🛢️ 桶 （6列×2行＝最多2套完整系列）
  • 🔗 强化宝箱 （6列×4行＝最多4整套）
  • ⬛ 黑色金属宝箱 （8列×4行＝最多4套＋额外自由存储）
  • 🪨 灰岩宝箱 （8列×5行=最多5套+额外免费存储） （英灵神殿 1.0 / 灰烬之地）
  • 🚪 衣柜 （5列×10行＝最多10组，每组5块！） （英灵神殿 1.0）
• 不可链接的容器： 私人/个人箱子、推车、船只、湮灭器和第三方模组容器无法链接，以防止丢失、UI错位或访问冲突。

---

🛡️ 槽位指引与错放物品处理

• 栏位指引： 一旦箱子与盔甲架连接，第1至6列会显示清晰的视觉分类标题（头部, 宝箱, 腿, 护盾, 武器, 披风并限制拖放放置，使物品自然落入相应的列中。
• 额外栏位（黑金属与灰岩宝箱）： 第6列之后的列是无限制的免费存储空间，套装循环器会完全忽略它们。
• 智能行解析： 如果未安装模组的玩家存放了装备，或者箱子在链接前已被放入物品，ArmorGallery 绝不修改或移动你的胸部物品栏取而代之的是，视觉人偶会智能扫描整排，找到每一件装备，并动态装备到展示架上。
• 错放物品高亮： 位于第1至第6列中的任何与列标题不匹配的物品，都会以柔和的方式高亮显示。 琥珀槽位光效 而且一个 琥珀色角落警告徽章（!)，提供清晰的视觉反馈，而不会锁定或修改该物品。

---

🎮 使用方法

1. 将宝箱连接到盔甲架

1. 放置一个 盔甲架 以及一个或多个兼容 宝箱 附近（默认 20 米内）。
2. 查看盔甲架并按下 <左Shift + E> 进入 连接模式.
3. 金色闪光光束会将展台与当前已连接的宝箱相连。
4. 查看附近的箱子并按 <E> 将其链接到支架的开关。
5. 回头看盔甲架并按 <左Shift + E> 退出链接模式并开始自动旋转！

2. 在箱子中整理装备

打开你的关联宝箱，将装备排列成6列套装行：

第1列	第2列	第3列	第4列	第5列	第6列	额外列
头盔	宝箱	腿部	护盾	武器	披风	免费存储

• 同一行中的空槽位会按原样保留（例如，没有头盔的套装会显示光秃的头部）。
• 双手武器会自动将盾牌调整至背后。
• 错位的物品会显示琥珀色光晕和警告标记，而智能行整理仍会将套装显示在展示架上。

3. 管理套装与宝箱界面

• 按下 <E> 在已连接的盔甲架上会直接打开主要连接的箱子。
• 使用 <Q> 和 <E> （可配置）在箱子界面打开时，可浏览所有已连接的箱子，无需在它们之间走动。
• 点击 装备 点击任意行旁边的按钮，即可立即装备该整套装备，或与维京人当前所穿装备进行互换。
• 点击 姿态按钮 (已装备 / 已收起在武器栏界面中可更改武器的握持方式。
• 看看展示台，然后按下 左Alt + E 随时切换姿势。

---

⚙️ 配置

配置文件位于 BepInEx/配置/com.drakosdj.armorgallery.cfg:

类别	设置	默认	描述
通用	已启用	真	启用或禁用自动切换套装。
通用	旋转间隔	60.0	设置轮换之间的时间间隔（秒）。
通用	旋转模式	顺序	骑行模式： 顺序, 随机行，或 混沌.
通用	最大链接宝箱数	6	可连接到单个支架的最大宝箱数量（1–12）。
通用	最大连接距离	20.0	展示架与箱子之间的最大距离（米）（5米–30米）。
通用	循环时随机姿态	假	启用后，每次循环会自动随机选择一个姿势（不包括装备堆姿势15）。
通用	随机切换姿态	错误	启用后，每次循环时会在已装备和收起状态之间随机切换武器。
通用	修饰键	左Shift键	按住使用键时配合热键修饰键可切换连接模式。
通用	姿态修改键	左Alt	使用按键配合热键修饰键可循环切换姿势。
控制	上一宝箱钥匙	Q	在界面中翻页至上一个链接箱子的快捷键。
控制	下个宝箱钥匙	E	在UI中翻页至下一个已链接箱子的热键。

---

🌐 多人游戏与原生兼容性（模组与原版）

• 纯人体模型（物品零丢失或复制）： 盔甲展示架将盔甲架纯粹视为视觉人偶。真实的装备物品永远不会被序列化到盔甲架的网络数据中；所有真正的装备始终100%保留在你关联的箱子内。
• 无人看管时的站立外观： 由于视觉旋转和人体模型展示是由运行装甲画廊模组的玩家主动驱动的，如果当前活跃区域/地带没有玩家运行该模组，盔甲架就会显示为空（例如在专用服务器上只有未装模组的原版玩家在附近时，或在未装模组的原版环境中加载世界时）。一旦有装了模组的玩家进入该区域，盔甲架就会立即重新穿上当前套装并恢复轮换。
• 交互行为（模组与原生）：
  • 使用装甲画廊（模组版）： 按下 <E> 在连接的架子上直接打开主要连接宝箱。快捷栏附件（1-8）会被安全阻止，并显示游戏内提示。
  • 无护甲库（原版／无模组）： 站位槽已用内部哨兵锁固定（锁定）。如果未安装模组的玩家尝试装配快捷栏物品（1–8），原版游戏会阻止装配，并显示 <color=red>无法对盔甲架使用物品</color>. 按下 <E> 在锁定槽位上不掉落任何物品，防止任何物品复制。
• 外來物品安全回收（原版遊戲中零裝備損失）： 如果未安装模组的玩家在原版游戏中成功将真实装备挂到展示架上（或者在原版中手动清空了某个槽位），那么返回模组游戏时将会 绝不覆盖、删除或复制该装备当模组玩家进入区域时，盔甲陈列馆会检测到正版物品，将其连同所有原始属性、耐久度和品质完好无损地安全掉落在展示台前的地面上，并显示居中HUD消息： <color=#FFD700>护甲陈列馆：原版游戏过程中装备的护甲已安全放置在展示架上。</color>
• 近距离大师权限： 旋转计时器和配置设置由离每个展台最近的单个活跃模组玩家驱动，以防止网络冲突或计时器重叠。
• 连线锁定： 当一名玩家正在台上编辑链接时，其他玩家会看到琥珀色提示，并且在编辑完成前无法覆盖链接设置。

---

📦 安装

1. 安装 Valheim 的 BepInEx.
2. 提取 护甲库.dll 和 图标.png 进入 BepInEx/plugins/ （或使用 Thunderstore / r2modman 模组管理器）。
3. 启动游戏，尽情体验你的军械库吧！

---

💬 Discord

加入我们的 Discord 服务器 欢迎在此讨论、提出建议和报告问题！