为你的成就系统提供一个简单的称号奖励系统，支持服务器同步

🏆 巴尔隆德成就奖励

服务器感知成就可靠性、恢复机制以及英灵神殿外观称号

巴隆德成就奖励 将瓦尔海姆的成就系统转变为一个更完整的、适合多人的、面向模组游戏的进度层。

该模组仍保留其初衷——为每项原版英灵神殿成就提供外观奖励 标题 — 但从 v0.1.1 它还聚焦于一个更重要的问题：让成就在真实的模组和多人游戏环境中稳定可靠。

Valheim在特定作弊或开发者指令状态下会停止授予成就，成就相关的统计数据可能落后于原始游戏统计数据，并且可能无法干净地重新评估某些进度。Balrond成就奖励模组正是为解决这些情况而设计的。 而不把成就变成免费解锁.

目标很简单：

让玩家可以使用模组、服务器、管理工具和长期角色，而不会永久丢失正当成就进度——同时由服务器掌控规则。

加入巴尔德之巢 · 所有Balrond模组 · 在Ko-fi上支持开发 · 委托咨询

---

这个模组的作用

巴伦德成就奖励有两个紧密相连的系统：

1. 成就可靠性

该模组可帮助《英灵神殿》在模组环境下保持正常成就进度。

其成就层正是围绕这些规则设计的：

• 《英灵神殿》自身的成就定义仍是权威依据。
• 模组会 不 发明替代平台成就。
• 服务器控制多人游戏中的成就策略。
• 服务器同步的成就设置本应锁定。
• 合法的历史进度可以从瓦尔海姆自身存储的统计数据中恢复。
• 当服务器策略允许时，可以修复现有的过期作弊状态数据。
• 成就进度不应仅仅因为角色进入过模组或管理员会话就被永久禁用。
• 恢复机制基于现有的英灵神殿数据和事件记录，而不是盲目授予每一项成就。
• 当元成就的前置条件已完成但英灵神殿未能正确更新时，可以重新评估这些元成就。

2. 外观称号奖励

每一个当前原版英灵神殿中受该模组支持的成就都有一个装饰性称号。

示例：

成就：Boss3Bonemass 奖励称号：光之使者鲍里斯 ↓ 光之使者鲍里斯

称号不提供属性、增益、伤害、物品、配方、技能或进度优势。

---

核心哲学

巴隆德成就奖励是 不 一个“解锁全部内容”的模组。

这也并非旨在惩罚运行模组服务器的玩家。

成就系统遵循三项原则：

正当进度应在模组游玩后保留

使用模组、服务器管理或开发工具不应自动永久破坏获得未来成就的能力。

服务器决定规则

在多人在线服务器上，成就修复与恢复策略通过以下方式由服务器权威决定： 服务器同步.

客户端不应能在本地放宽服务器的成就规则。

恢复不等于捏造

模组可以调和已存储的进度并修复受阻状态，但它不旨在将任意控制台操作转换为合法的成就进度。

目标是恢复 瓦尔海姆已经知晓的真正进展，而不是生成虚假的完成。

---

服务器权威与多人游戏

成就完整性由服务器端负责。

多人游戏中，请在以下设备安装相同版本的Balrond成就奖励：

• 专用服务器或主机，
• 每个按服务器策略应获得成就的客户端，
• 所有应该看到玩家称号的客户端。

巴尔德成就奖励使用 服务器同步 用于服务器控制的配置。

锁定服务器策略

服务器可以通过以下方式锁定同步配置：

锁定配置 = true

通常应保持启用状态。

当连接到服务器时，客户端会遵循服务器同步的成就和奖励配置，而不是其本地副本。

服务器政策涵盖可能影响成就资格、恢复或共享头衔定义的系统。

仅客户端视觉偏好保留在本地。

平台/供应商权限

《英灵神殿》仍会与其常规成就提供方/平台进行通信。

Balrond成就奖励不会用自定义的虚假后端替换Steam/平台成就服务。

该模组修复了 Valheim 端围绕该系统的资格判定、进度统计、数据校准和奖励展示。

因此，专用服务器控制着 政策，而玩家的英灵神殿客户端/提供方仍负责实际的平台成就状态。

---

成就可靠性

为什么需要这个

在正常的模组环境中，有几件事会干扰成就：

• 一个角色可能会被标记为使用过作弊，
• 一个世界/会话可能会进入作弊状态，
• 开发命令可能导致《英灵神殿》拒绝后续的成就进度，
• 物品可以携带作弊来源，
• 成就界面计数器可能落后于原始游戏统计数据，
• 成就被封锁期间获得的进度可能无法计入，
• 元成就可能会错过其重新评估窗口。

Balrond成就奖励旨在将这些情况作为一个协调统一的系统来处理，而无需依赖多个独立的成就修复模组。

从阻塞会话中恢复

当同步服务器策略允许时，该模组可以为一个原本会被永久阻止的角色/会话恢复成就获取资格。

这确实 不 意思是“每条控制台命令都会给予成就进度”。

重要的区别在于：

恢复成就资格 ≠ 直接授予任意成就完成

服务器可以允许玩家在使用了管理/开发者命令后继续获得成就，同时仍然依赖合法的成就条件和存储的游戏统计数据。

历史数据恢复

即使成就进度被阻止，Valheim 仍可保留原始游戏统计数据。

巴隆德成就奖励可以保守地协调这些数值。

预期的恢复模型等同于：

成就界面进度 = 取最大值（现有成就进度，有效存储的原始进度）

非：

成就进度 += 所有历史原始进度

这样可以避免重复计算已经计入的进度。

元成就修复

有些成就依赖于其他成就，而不是某个直接的游戏计数器。

巴隆德成就奖励可以在相关成就变更和角色/档案初始化后重新检查这些关系，这样已完成的先决条件就不会因为英灵神殿错过了最初的评估时机而被忽略。

旧版作弊状态清理

在服务器策略允许的情况下，成就可靠性层可以修复过时的角色/物品作弊状态，否则这些状态将继续污染后续进度。

这被有意视为恢复/迁移行为，而非免费解锁机制。

服务器所有者应自行决定哪些修复选项适合他们的社区。

---

反作弊模型

此模组专为 模组进度，而非不受限制的成就欺骗。

多人游戏模式应这样理解：

服务器 │ ├─ 控制成就策略 ├─ 锁定同步设置 ├─ 控制恢复/回填规则 └─ 控制共享称号目录 ↓ 客户端 │ ├─ 记录本地英灵神殿游戏统计数据 ├─ 应用同步策略 ├─ 校合合法存储的进度 ├─ 与平台成就提供方交互 └─ 仅发布选定的称号身份

连接到已配置的服务器时，该模组不会将客户端本地配置视为权威配置。

这一点尤其重要，因为成就进度是一个敏感系统：客户端绝不能悄悄启用比服务器所允许的更宽松的恢复规则。

---

外观称号

称号系统仍与《英灵神殿》的正常内容完全集成 成就 屏幕。

没有单独的自定义成就菜单，也没有称号快捷键。

选择称号

1. 打开英灵神殿的常规 成就 屏幕。
2. 找到一个你已经解锁的成就。
3. 点击已解锁的成就。
4. 如果配置了称号奖励，模组会打开一个原生的英灵神殿 是 / 否 确认弹窗。
5. 选择 是 装备称号。
6. 选择 不 保留你当前的称号。

解锁一个称号会 不 自动装备它。

你已解锁的称号可以随意切换。

移除你的头衔

成就界面包含一个原生风格的：

无题

普通关闭控件附近的按钮。

点击它可恢复为正常角色名。

示例：

光明使者鲍里斯 ↓ 无头衔 ↓ 鲍里斯

---

已锁定的成就和 ？？？

巴隆德成就奖励保留了英灵神殿秘密/锁定成就的展示方式。

部分锁定的成就可以开启英灵神殿的普通 成就详情 窗口和显示：

？？？ ？？？ / ？？？

那是原版行为。

该模组不会透露隐藏成就信息。

只有已解锁且配置了称号奖励的成就才能用于称号选择。

---

姓名板

其他玩家

如果玩家拥有激活的称号，其他安装了模组的客户端可以在玩家名称旁显示该称号。

示例：

光明使者鲍里斯

该角色实际保存的名称仍为：

鲍里斯

该模组仅更改外观。

你的角色

Valheim通常不会在本地角色上方显示标准的多人游戏名称HUD。

Balrond成就奖励可选择使用Valheim自带的玩家HUD展示方式，创建一个仅本地可见的自身名牌。

相关客户端设置：

显示自己的名牌 = 真 / 假

垂直位置也可以在本地调整。

---

仅原版成就

Balrond成就奖励使用Valheim提供的成就集。

它不会为以下内容添加替换用的伪成就：

• 收集任意自定义数量，
• 自定义模组技能里程碑，
• 自定义首领要求，
• 无关的模组统计信息。

系统可能会修复 Valheim 追踪或评估其成就的方式，但成就定义本身仍然是 Valheim 的成就。

当前支持的基础版本包含 53个原版成就.

---

默认头衔奖励

默认奖励目录为每个受支持的 vanilla 成就分配一个装饰性头衔。

一些示例：

原版成就ID	默认标题
已到达	新血
鹿角神	风暴之触
首领2长老	碎根者
骨魔	光明使者
四号首领	屠龙
第五个首领亚格鲁斯	弑君者
女王6号	破巢者
首领7淡出	破焰者
冰封之王	破链者
所有Boss	被遗忘者的克星
所有建筑部件	建筑大师
全部食物已烹饪	厨艺大师
全部物品制作	大师级工匠
查找所有奖杯	奖杯守护者
东西南北	寻路者
探索东南西北无地图	无路可循
多人首领战	誓约者
独行首领	孤狼

显示完整的默认53项成就称号目录

#	原版成就ID	默认标题
1	所有首领	被遗忘者的克星
2	全首领困难模式	末日行者
3	所有首领普通难度	界域守卫
4	所有建筑部件	建筑大师
5	全部食物已烹饪	厨神
6	所有食物已吃完	铁胃
7	全部物品制作	宗师
8	所有小首领	传奇猎人
9	所有武器制作	军火库管理员
10	已抵达	新血
11	大鱼	钓鱼大师
12	鹿王	风暴之触
13	boss2长老	碎根者
14	骸骨巨兽	光明使者
15	四号首领模组	屠龙
16	Boss5亚格鲁斯	弑君者
17	Boss6女王	破巢者
18	首领7淡出	破焰者
19	冰封之王	破链者
20	建造迪恩温	炎铸
21	建造高级	天空建筑师
22	建造高塔世界	穿云者
23	建造房屋	自耕农
24	建造村庄	炉火领主
25	奥丁之子	奥丁神选
26	全类型死亡	死亡伴侣
27	死亡清除者	雾化
28	死亡之树	木结构
29	全灭	树木磁铁
30	探索东南西北	寻路者
31	探索东南西北无地图	无径
32	查找所有奖杯	奖杯守护者
33	首次死亡	已返回
34	打磨构筑	建筑师
35	研磨舒适度	炉火守护者
36	研磨烹饪	老练的营火兵
37	打磨日	幸存者
38	咀嚼进食	无底
39	磨鱼	钓鱼大师
40	采集者	野性收割者
41	采集研磨	收割领主
42	研磨蜂蜜	养蜂人
43	利维坦	利维坦之灾
44	磨帆	海盗船
45	研磨帆舵	舵手
46	刷宝	宝藏猎人
47	砍树	伐木工
48	全部击杀	野兽克星
49	击杀所有生物（困难）	巅峰猎手
50	国王与王后	破冠者
51	多人Boss	誓约者
52	帆缘	边缘行者
53	首领单挑	孤狼

---

配置

BepInEx 配置文件生成于：

BepInEx/config/balrond.astafaraios.BalrondAchievementRewards.cfg

配置分为两类：

服务器同步的游戏玩法/成就策略 客户端本地的视觉/诊断偏好设置

服务器同步设置

这些设置应由服务器控制，并在多人游戏中锁定。

锁定配置

默认：是

保持Balrond成就奖励设置同步，由服务器控制。

对于公开或注重进度的服务器，请保持启用此项。

已启用

默认：是

启用 Balrond 成就奖励系统。

标题奖励

服务器控制的原版成就到外观称号的映射。

条目格式：

成就匹配器|标题ID|显示名称|名称格式|可选颜色

条目之间用以下内容分隔：

;

最小示例：

id:Boss3Bonemass|lightbringer|光明使者

默认输出：

光明使者鲍里斯

自定义示例：

id:Boss3Bonemass|lightbringer|光明使者|{player}，{title}|#E7F5B6

输出：

鲍里斯，圣光使者

成就完整性/恢复策略

版本0.1.1将同步配置扩展到了头衔之外。

服务器策略控制该模组是否可以执行以下操作：

政策区域	目的
成就资格恢复	防止过时的模组或开发者命令状态永久禁用后续成就进度
历史数据校准	恢复《英灵神殿》已存储统计中本应存在却未计入成就的正当进度
角色作弊状态修复	当服务器允许时，移除过期的角色级阻挡状态
道具作弊状态修复	修复旧物品来源，防止其继续污染未来的有效进度
世界/会话作弊处理	定义服务器是否允许在使用管理员/开发者命令后取得成就进度
元成就修复	重新评估依赖于其他成就完成的成就

这些是 服务器策略控制，而非个人客户端偏好。

当连接到启用了配置锁定的服务器时，客户端会遵循同步的服务器数值。

已安装版本随附的配置文件注释是各项完整性选项名称和默认值的权威参考。

成就匹配器类型

编号： — 推荐

与原版内部一致 成就.m_id.

示例：

已到达 首领3骨量 单挑首领

名称：

与原生成就名称/本地化标识符匹配。

自动：

使用模组支持的自动匹配逻辑。

对于服务器配置，建议使用 编号： 尽可能。

标题ID

标题的稳定内部标识符。

示例：

光明使者

允许的字符：

A-Z a-z 0-9 . _ -

不要使用空格。

显示名称

可见外观称号。

示例：

光明使者

名称格式

可选。

必须同时包含：

{player} {title}

示例：

{player}，{title} {title} {player} {player}，{title} {player} — {title}

可选颜色

可选的十六进制标题颜色。

示例：

#E7F5B6

接收方客户端必须启用头衔颜色才能显示颜色。

---

客户端本地外观设置

这些选项不会改变成就获取资格或服务器进度策略。

在玩家上方显示称号

默认：是

在其他玩家显示的名字中显示已激活的称号。

显示自己的姓名牌

默认：是

在你的角色上方显示你自己的名字和当前称号。

自己的名牌垂直偏移

默认：0.30

调整本地自身名牌高度。

使用称号颜色

默认：true

允许渲染同步的可选称号颜色。

---

诊断

详细日志记录

默认：否

向 BepInEx 日志添加详细的成就匹配、恢复、同步和标题状态信息。

在报告时启用：

• 一个本应取得进展却未能取得的成就，
• 恢复/补填问题，
• 服务器同步不匹配，
• 标题选择问题，
• 一个铭牌问题。

初始化时写入成就转储

默认：否

将发现的英灵神殿成就ID和状态写入：

BepInEx/config/BalrondAchievementRewards/achievement_dump.txt

这在英灵神殿更新后很有用，也适合维护自定义头衔目录的服务器管理员。

---

角色与头衔持久化

所选的称号按角色存储于：

BepInEx/config/BalrondAchievementRewards/character_titles.v1.tsv

通常不需要手动编辑此文件。

称号系统存储的是所选称号身份，而不是第二个自定义成就数据库。

成就完成仍取决于英灵神殿及平台状态，外加模组的修复与协调层。

---

安装

模组管理器

使用兼容Thunderstore的模组管理器安装Balrond成就奖励，并安装该版本声明的包依赖项。

手动安装

使用你平常的BepInEx Valheim工作流程。

多人游戏中，请在服务器和所有参与的客户端上安装相同版本。

使用同步成就策略时，请勿运行客户端/服务器版本不匹配的构建。

---

正在从 v0.1.0 更新到 v0.1.1

v0.1.1将Balrond成就奖励从仅提供称号奖励扩展为更全面的成就可靠性系统。

你现有的称号选择和原版成就映射在概念上仍然兼容。

服务器管理员在向玩家开放服务器之前，应查看新的成就完整性/恢复设置。

对于注重进度的服务器，请保留：

锁定配置 = true

并在服务器上配置成就策略，而不是允许客户端自行选择恢复规则。

---

常见问题

这个模组会添加虚假成就吗？

不。

该模组使用英灵神殿现有的成就系统，并可修复其资格与进度处理机制。

它不会创建替代平台成就。

这个模组只是因为用了开发者命令就解锁成就吗？

否。

恢复层的目的是防止角色在使用了模组或管理员权限后被永久阻止获得成就。

恢复和资格与盲目授予完成是两回事。

客户端能否在多人服务器上启用更简单的成就规则？

当服务器使用预期的同步锁定配置时则不会。

成就完整性选项由服务器策略决定。

保留 锁定配置 = true 在以进度为核心的服务器上。

到底是谁拥有 Steam/平台成就？

英灵神殿和普通平台/提供商系统仍然拥有平台成就。

专用服务器控制Balrond成就奖励策略，但不会替换平台成就后端。

旧的合法进度能恢复吗？

成就可靠性系统用于在进度存在但因成就处理被阻止而未被计入时，对存储的英灵神殿统计数据进行校正。

恢复机制较为保守，不会重复计算已计入的进度。

称号会提供游戏性加成吗？

不。

称号仅为外观装饰。

我该如何装备称号？

打开瓦尔海姆的普通成就界面，点击一个你已解锁的成就。

选择 是 在标题确认弹窗中。

我该如何移除称号？

打开成就界面并点击 无标题.

为什么锁定的成就显示`???`？

这是英灵神殿中秘密或锁定成就的正常表现。

该模组不会泄露秘密成就信息。

我的角色真的改名了吗？

不。

仅显示的昵称会随当前佩戴的称号改变格式。

未安装模组的客户端能看到称号吗？

不。

标题展示需要在接收客户端上安装巴尔隆德成就奖励。

---

兼容性

巴隆德成就奖励专注于：

• 维京英灵殿成就资格与进度可靠性，
• 成就恢复/对账，
• 原生成就界面，
• 外观称号，
• 玩家名称显示，
• 同步多人游戏策略。

替换或大幅修改相同成就、统计或UI系统的模组可能会产生冲突。

组合多个成就修复模组时，除非明确测试过组合效果，否则避免启用重叠的补丁。

Balrond成就奖励旨在作为一个连贯的系统提供这些功能，因此一旦所安装的版本包含了等效功能，通常就不需要单独的成就启用/修复/同步模组了。

---

错误报告与支持

如需支持或提交错误报告：

巴尔德隆的巢穴 — Discord

报告成就问题时，请包含：

1. 巴隆德成就奖励版本。
2. 英灵神殿版本。
3. 完成 BepInEx 日志输出.log.
4. 完整的模组列表或模组管理器配置代码。
5. 单人游戏、主机多人游戏或专用服务器。
6. 服务器是否已启用配置锁定。
7. 涉及的成就ID/名称。
8. 你预期会获得的进度。
9. 会话中或该角色之前是否使用过开发者命令/管理员工具。
10. 精确重现步骤。

对于UI问题，请附上截图。

关于成就资格、ServerSync、恢复或多人游戏问题， 完成日志 是必不可少的。

---

支持开发

巴隆德成就奖励可免费下载使用。

开发支持有助于资助维护、多人游戏测试、兼容性工作、文档编写、错误修复以及未来的《英灵神殿》项目。

在Ko-fi上支持Balrond

对于自定义模组、私人集成、服务器配置工作或委托系统：

巴隆德的巢穴 — Discord

公开的错误修复不设付费门槛。针对特定项目的实现和私有集成工作可能需要单独报价。

---

更多Balrond模组

浏览完整的Balrond目录：

巴尔隆德在Thunderstore上

---

最后留言

巴尔隆德成就奖励旨在让成就系统在众多《英灵神殿》玩家实际游玩的游戏环境中也能发挥作用： 模组世界、专用服务器、长期角色、管理工具和多人社区.

服务器定义规则。
瓦尔海姆仍然定义着成就。
提供方仍拥有平台解锁权。
这个模组保留了正常的进度机制，还能让你把成就当作头衔来佩戴。