HearthShare - 个人战利品宝箱

[center][size=6][b]HearthShare[/b][/size]
[size=4]Valheim 合作模式下的个人战利品宝箱[/size][/center]

[line]

[size=5][b]为什么会有这个模组[/b][/size]
在合作模式中，谁先跑到宝箱前谁就拿走所有东西，其他人只能看到空箱子。你第 20 天才加入的朋友，永远无法像你一样去探索黑森林。

[b]HearthShare 让每位玩家都能从每个自然生成的宝藏箱中获得属于自己的那份战利品。[/b]有人喊"这边有个箱子！"，所有人都有理由跑过去打开它。一起玩、分头行动、中途加入：这个世界里始终有属于你的战利品。

灵感来自 Minecraft 的 [i]Lootr[/i] 概念。这是一个独立的 Valheim 实现，未使用任何其他模组的代码或资源。

[line]

[size=5][b]工作原理[/b][/size]
[list]
[][b]从宝箱自身的战利品表中为你独立抽取。[/b]当你[i]第一次[/i]打开某个宝箱时，服务器会从该宝箱正常的原版掉落表中为你抽取。不多不少，也不会用到游戏自身掉落表之外的内容。[/]
[][b]抽取后即固定。[/b]重新打开、重新连接、重启游戏，或朋友打开同一个宝箱，都不会重新抽取你的那份。[/]
[][b]其他人照样拿到自己的那份。[/b]你的朋友打开同一个宝箱时，会获得独立抽取的结果。[/]
[][b]使用真正的宝箱面板。[/b]它使用 Valheim 自带的宝箱界面，而非自定义窗口。[/]
[][b]你的那份，你做主。[/b]可以全部拿走、点击拾取和放置、与背包互换、从宝箱中丢出，也可以把自己的物品存回你的那份中。相同的堆叠会合并。[/]
[][b]一眼看清还剩什么。[/b]每个宝箱都会专门为你标记：
[list]
[][color=#E8C66A][b]金色[/b][/color]：你还没打开过[/]
[][color=#7CFFC4][b]绿色[/b][/color]：你打开过，里面还有战利品[/]
[]原版外观：你已经清空了它[/]
[/list][/]
[/list]
[line]

[size=5][b]哪些宝箱是个人化的[/b][/size]
[list]
[][b]基础游戏中的全部 26 种自然宝藏箱类型[/b]，从草地到极北之地。[/]
[][b]任务宝箱保持共享[/b]（Hildir 的宝箱和藏宝图宝箱），这样任务才能正常运作。[/]
[][b]你自己建造的宝箱绝不会被改动。[/b]你的基地存储与原版完全一致。[/]
[][b]服务器管理员可以通过配置添加或排除宝箱[/b]，例如其他模组添加的宝箱。以服务器的列表为准。[/]
[/list]
[line]

[size=5][b]EpicLoot 支持（可选）[/b][/size]
安装 [url=https://www.nexusmods.com/valheim/mods/387]EpicLoot[/url] 后，个人份额会通过 EpicLoot 自己的战利品抽取器来生成，因此魔法物品会按 EpicLoot 预期的方式掉落，并受世界 Boss 进度的限制。
[list]
[][b]EpicLootIntegration = Auto[/b]（默认）：存在 EpicLoot 时使用它。[/]
[][b]Enabled[/b]：需要 EpicLoot。[/]
[][b]Disabled[/b]：仅使用原版战利品。[/]
[/list]主机的设置决定所有人的抽取结果。
已在游戏中使用 EpicLoot 0.15.6 测试。HearthShare 会在启动时检查 EpicLoot 的代码。如果未来的 EpicLoot 更新改变了它所依赖的内容，个人宝箱会拒绝打开并报错，而不是以错误的方式抽取战利品。不会有任何损失：在 HearthShare 更新之前，将 [b]EpicLootIntegration = Disabled[/b] 即可使用原版战利品。日志会显示检查结果。

[line]

[size=5][b]兼容性[/b][/size]
已与以下模组一起测试：
[list]
[][b]EpicLoot[/b]（见上文）[/]
[][b]Contents Preview[/b]：预览显示[i]你的[/i]份额[/]
[][b]Cartur's Map Pins[/b]：已拾取图标和地牢标记跟随[i]你的[/i]份额[/]
[][b]Extra Slots[/b]：投递物会落入安全槽位[/]
[][b]Adventure Backpacks[/b]：背包及其他自带物品栏的物品无法存入份额中（这是设计使然，以防止复制）[/]
[][b]Craft From Containers[/b] 和 [b]Valheim Plus[/b]：属于我们自己团队的模组列表，目前未发现问题[/]
[/list]其他修改宝箱或战利品的模组可能不了解个人份额机制。如果发现异常，请在 Bugs 标签页报告并附上你的模组列表。

[line]

[size=5][b]前置要求[/b][/size]
[list]
[][url=https://www.nexusmods.com/valheim/mods/15]BepInExPack Valheim[/url][/]
[][url=https://www.nexusmods.com/valheim/mods/1138]Jötunn[/url] 2.30.2 或更新版本[/]
[]Valheim 1.0.21（"Deep North"）[/]
[/list]
[line]

[size=5][b]安装[/b][/size]
[list=1]
[]安装 BepInEx 和 Jötunn。[/]
[]将 [b]HearthShare[/b] 文件夹解压到
[code]Valheim/BepInEx/plugins/[/code]。[/]
[][b]每个人都需要安装，且版本相同：[/b]主机或服务器[b]以及[/b]每位玩家。HearthShare 无法在不同版本之间连接。[/]
[]启动一次游戏以生成配置文件。[/]
[/list]
[b]多人游戏：[/b]主机或服务器会将所有人的个人份额保存在
[code]BepInEx/config/HearthShare/[/code]。请将该文件夹与你的世界一起备份，就像备份世界本身一样。

[line]

[size=5][b]配置[/b][/size]
[code]BepInEx/config/twiggy.hearthshare.cfg[/code][list]
[][b][Chests] AdditionalChests[/b]：额外设为个人化的宝箱 prefab 名称（由服务器控制）。[/]
[][b][Chests] ExcludedChests[/b]：保持共享的宝箱 prefab 名称（由服务器控制）。[/]
[][b][Integration] EpicLootIntegration[/b]：Auto / Enabled / Disabled。[/]
[][b][Appearance] ShowPersonalRuneRing[/b]：显示你的金色、绿色或原版宝箱标记。[/]
[][b][Appearance] MarkerStyle[/b]：Tint、Outline 或 Both。[/]
[/list]
[line]

[size=5][b]须知[/b][/size]
[list]
[][b]可在现有世界中使用。[/b]每个自然宝藏箱都会立即变为个人化，包括在你安装 HearthShare 之前已被打开过的宝箱：每位玩家都会从中获得全新的抽取结果。想要经典的"全新世界"体验？那就开一个新世界。[/]
[][b]Boss 门槛是全世界的。[/b]EpicLoot 的门槛跟随世界的 Boss 击杀进度，而非每位玩家各自的进度。个人 Boss 追踪可能会在以后加入。[/]
[][b]与原版宝箱相同：[/b]如果你丢弃或交易了一件物品，而游戏在保存前崩溃，该物品可能会存在两份。HearthShare 不会加剧这种情况，也不会修复它。[/]
[][b]卸载：[/b]在游戏进行中途从世界中移除它尚未经过测试，因此请先备份你的世界。仍留在个人份额中的物品存放在服务器的
[code]BepInEx/config/HearthShare/[/code]文件夹中，不会自行移回世界，所以请先把想要的东西取出来。[/]
[][b]专用服务器：[/b]已在单玩家的专用服务器上测试：加入、宝箱标记、重新登录、服务器重启和崩溃。双人合作已在玩家托管的世界中进行过游玩。双人同时在专用服务器上尚未测试。[/]
[/list]
[line]

[size=5][b]关于 AI 使用[/b][/size]
本着透明的精神：[b]HearthShare 是在 AI 辅助下构建的。[/b]
[list]
[][b]创意、设计和每一个决定[/b]（什么个人化、宝箱长什么样、允许什么）都是我的。它们源于我希望朋友们能一起享受探索的愿望。[/]
[][b]代码是在 AI 编程助手的协助下编写的[/b]：Claude（Anthropic）和 ChatGPT Codex（OpenAI）。我主导工作，两者互相交叉审查了对方的构建。[/]
[][b]发布前进行了大量测试：[/b]每个构建数百次自动化检查、独立审查、与朋友的真实游玩会话，以及刻意的崩溃和死亡。这些运行中没有丢失任何战利品，但没有模组能对每一次崩溃做出保证，所以如有任何异常请在 Bugs 标签页报告。[/]
[][b]没有 AI 生成的美术或资源。[/b]HearthShare 使用 Valheim 自带的宝箱面板和模型，截图来自游戏本身。[/]
[/list]如果这对你来说是硬伤，那也没关系。如果你尝试了，我很想听听你的团队觉得怎么样。

[line]

[size=5][b]致谢[/b][/size]
[list]
[]设计与测试：Twigology 和朋友们[/]
[]灵感来自 [i]Lootr[/i] 概念（Minecraft）。未使用其代码或资源。[/]
[]基于 BepInEx、Harmony 和 Jötunn 构建[/]
[/list]