管理员控制的瓦爾海姆全服首領解鎖與製作進度。

进度门控

一个轻量级的全服英灵神殿进度调度器。管理员决定何时可以召唤Boss；击败Boss后，会为所有人解锁其配置的制作等级。

创建者 猫龙.

进度门控专为希望在不进行大规模进度重做的情况下共享发布计划的社区服务器而设计。

功能

• 用于解锁和重新锁定首领召唤的实时管理员命令。
• 全服首领击败状态，客户端即时同步。
• 独立的首领召唤和制作关卡。
• 可配置的原版或模组首领。
• 精确预制体且不区分大小写的关键字配方规则。
• 可选匹配配方原料及产出物。
• 可选管理员绕过。
• 当首领解锁或真正被击败时，可选择通过 Discord webhook 发送通知。
• 配置热重载与服务器权威规则同步。

这个初始版本会限制首领祭坛和普通制作配方。它目前还不会限制装备使用、建造、烹饪站转换、冶炼、战利品掉落、商人、传送门或生物群系进入。

要求

• 英灵神殿
• BepInEx
• 该模组必须安装在专用服务器和每个客户端上。ServerDevcommands 为可选；Progression Gater 会自行授权 PG_* 针对服务器管理员列表的命令。

安装

复制 进度门控.dll 进入 BepInEx/plugins/ 在服务器和所有客户端上。启动服务器一次以生成：

BepInEx/配置/com.catosaur.progressiongater.cfg

服务器的规则和状态会同步到客户端。客户端的规则配置副本不会覆盖服务器。

管理员命令

命令会根据英灵神殿的服务器管理员名单进行验证。

状态 解锁 下一 解锁 <boss> 锁定 <boss> 击败 <boss> 未击败 <boss> 重置 确认 网络钩子测试

解锁下一页 选择第一个尚未被击败的已配置首领。可以使用明确的首领ID来解锁非顺序挑战。

战败 修理/进口在行政上声明，并有意不发送击杀首领的 webhook。只有真实的 设置全局按键 首领被击败事件会发送该通知。

默认进度

已击败首领	制作关键词已释放
鹿角神	青铜
长老	铁
骨山	银, 黑曜石
中等	黑金属
亚格鲁斯	迷雾之地材料关键词
女王	灰烬之地的材料关键词
滑块	暂时还没有默认的下一个生物群系规则

所有七个首领在新配置下均处于召唤锁定且未被击败状态。

规则配置

Boss记录使用此格式：

编号|显示名称|首领预制体|击败全局键|别名,别名

记录之间用分号分隔。它们的顺序控制着 解锁下一个. 别名可由命令和预制体查找使用；备用失败键别名必须以 战败_.

关键词配方规则使用：

bossId=keyword,keyword;bossId=keyword

关键词匹配子字符串时不区分大小写。如需精确规则——尤其是模组内容——请优先使用精确预制体规则：

长者=MyMod_IronWand,MyMod_IronStaff;母亲=MyMod_PlainsBlade

当 匹配配方材料 = true，配方输出和原料预制体名称均参与匹配。为假时，仅检查输出预制体。

无效记录和对未知Boss ID的引用将被忽略，并在BepInEx日志中显示警告。如果所有Boss定义均无效，则恢复内置定义作为安全回退。

Discord 网络钩子

在服务器配置中设置这些值：

[Discord] WebhookUrl = https://discord.com/api/webhooks/... ServerLabel = 我的英灵神殿服务器 PostBossUnlocks = true PostBossDefeats = true

消息可配置：

• 解锁代币： {boss}, {bossId}, 管理员, {server}
• 击败标记： {boss}, {bossId}, {server}

Webhook 会抑制 Discord 提及。默认情况下，仅接受 HTTPS Discord 主机。兼容的第三方端点需显式启用 允许非Discord的Webhook主机.

运行 网页钩子测试 配置URL以验证投放而不改变进度状态后。

建筑

将所需的游戏/框架引用放置于 库/，或使用支持1.0版本的安装脚本。游戏本体和BepInEx文件位于不同的目录中：

.\scripts\setup-references.ps1 ` -GameManagedDirectory "C:\Program Files (x86)\Steam\steamapps\common\Valheim\valheim_Data\Managed" ` -BepInExCoreDirectory "C:\Program Files (x86)\Steam\steamapps\common\Valheim\BepInEx\core" .\scripts\build.ps1

对于专用服务器，请使用其BepInEx 核心 目录及客户端游戏的 瓦尔海姆_Data\Managed 游戏引用目录。在每个客户端和服务器上安装BepInExPack Valheim 5.4.2350。

构建输出：

src/ProgressionGater/bin/Release/net48/net48/ProgressionGater.dll