火星定居点建筑部件

[size=5][b]Marsarah Build Pieces[/b][/size]

[b]版本：[/b] 1.0.0
[b]作者：[/b] Marsarah

[line]

[size=5][b]🧰 关于模组[/b][/size]

Marsarah Build Pieces 是一个独立的 Valheim 自定义可建造部件合集，主要聚焦于[b]功能性部件、传送门和新的光源[/b]，而非大量的建筑墙壁和地板套装。

该模组最初是 [b]Marsarah Tweaks[/b] 中的自定义建造部件部分，现在已分离为独立模组。目前它添加了 [b]14 个可建造部件[/b]以及可制作的 [b]Portal Core[/b] 物品，包括 Pocket Portal、Glacial Stone Portal、Mystical Light Ward、Silver 光源、Green Standing Brazier 和彩色 Dvergr Lanterns。

所有功能配置均使用 [b]ServerSync[/b] 进行同步，并且当两个模组同时安装时，该模组包含与 MarsarahTweaks 的可选兼容性。

[line]

[size=4][b]开发说明[/b][/size]

[b]Deep North / 剧透说明：[/b] 有意暂未包含 Deep North 建造部件。
我希望先亲自体验新生物群落和进度，然后再深入研究游戏文件，这样我就可以在不破坏自己体验的情况下通关它。
在完成 Deep North 后，我计划审查其建造部件和其他相关内容，以考虑可能添加到本模组中。

[b]AI 使用披露：[/b] 最初的建造部件功能来自我的 MarsarahMod / Marsarah Tweaks 项目。后来使用 AI 工具协助移植，现在也作为我开发工作流程的一部分，用于调试、重构、兼容性更新、研究游戏 API 变更和文档编写等任务。
开发仍由人工主导：由我决定添加哪些功能、它们应如何表现，并且我编写代码、审查和测试发布中包含的更改。该模组的标志也是使用生成式 AI 创建的。

[size=4][b]相关 Marsarah 模组[/b][/size]

- [url=https://www.nexusmods.com/valheim/mods/3022][b]MarsarahTweaks[/b][/url] - 玩法、平衡、减少刷取和体验优化调整。BuildPieces 包含与多个 Tweaks 功能的可选兼容性。
- [url=https://www.nexusmods.com/valheim/mods/3710][b]MarsarahUI[/b][/url] - 独立 UI 和信息改进。
- 使用 Marsarah Build Pieces 不需要这两个模组中的任何一个。

[line]

[size=5][b]🔒 权限[/b][/size]

[b]不允许[/b]重新上传此模组，无论是部分还是完整。
任何人都可以自由从中获得灵感或实现类似功能，但必须使用自己的代码和资源。

[line]

[size=5][b]🧱 需求[/b][/size]

此模组需要：
- [url=https://valheim.thunderstore.io/package/denikson/BepInExPack_Valheim/][b]BepInEx for Valheim[/b][/url]
- [url=https://valheim.thunderstore.io/package/ValheimModding/Jotunn/][b]Jotunn[/b][/url]

对于多人游戏，请在[b]服务器[/b]和[b]所有客户端[/b]上安装该模组，以便同步配置和自定义预制件匹配。

[line]

[size=5][b]📦 安装[/b][/size]

1. 解压 [i].zip[/i] 文件。
2. 将 [i]MarsarahBuildPieces.dll[/i] 复制到你的 [i]Valheim/BepInEx/plugins[/i] 文件夹中。
3. 确保已安装 [b]Jotunn[/b]。

或使用模组管理器。

[line]

[size=5][b]⚙️ 配置[/b][/size]

首次启动时会生成配置文件：
[i]Valheim/BepInEx/config/Marsarah.MarsarahBuildPieces.cfg[/i]

所有 BuildPieces 设置都会与服务器同步。可以锁定配置，使只有服务器管理员才能更改同步值。

[b]主要设置：[/b]
- Pocket Portal
- Glacial Stone Portal
- Extra Lights
- Mystical Light Ward
- Mystical Light Ward Radius: 5-50 meters，默认 [b]32m[/b]

功能开关可在游戏过程中更改。需要时关闭并重新打开相关的建造/制作菜单，以便菜单刷新。

[line]

[size=5][b]💰 捐赠[/b][/size]
我的模组现在并且将来也始终免费使用。如果你想支持我的工作，可以在这里捐赠：
[url=https://paypal.me/Marsarah9]PayPal[/url]

[line]

[size=5][b]⚡ 主要功能[/b][/size]

[size=4][b]🔧 Pocket Portal[/b][/size]
一个便携式传送门，旨在让探索更加方便。

- 添加可制作的 [b]Portal Core[/b] 物品。
- 在[b]4 级 Workbench[/b]制作：5 Surtling Cores、20 Fine Wood、5 Freeze Glands、20 Obsidian。
- Portal Core 最大堆叠数量：[b]1[/b]。重量：[b]10[/b]。
- Pocket Portal 建造消耗：[b]1 Portal Core[/b]。
- 每个玩家一次只能放置[b]一个 Pocket Portal[/b]。
- 将其摧毁后，该玩家可以将其放置到其他地方。
- 制作 Portal Core 会通过自定义 Raven 教程介绍该功能。

[size=4][b]🔧 Glacial Stone Portal[/b][/size]
- 启用一个未使用的原版石制传送门，作为可建造的 Mountain 层级传送门。
- 需要 [b]Stonecutter[/b]。
- 建造消耗：6 Stone、2 Freeze Glands、2 Surtling Cores。
- 功能与普通传送门相同。
- 这[b]不是[/b] Ashlands Stone Portal。
- 当两个模组都安装时，与 [b]MarsarahTweaks Max Portals Per Player[/b] 集成。

[size=4][b]🔧 Mystical Light Ward[/b][/size]
- 一个更小的蓝色发光魔法 Ward，可使区域内的有燃料光源永久点亮。
- 需要 [b]Workbench[/b]。
- 建造消耗：2 Fine Wood、1 Silver、2 Obsidian。
- 默认半径：[b]32 米[/b]。可配置为 [b]5 到 50 米[/b]。
- 放置 Ward 时会显示半径，之后隐藏。
- 将其半径内的有燃料光源补充至最大燃料。
- [b]没有普通 Ward 的保护/归属行为[/b]。
- 如果禁用该功能，现有 Ward 将进入休眠状态并失去发光/效果。

[size=4][b]🔧 Extra Lights[/b][/size]
在 Mountain 和 Mistlands 进度中添加 [b]11 个光源建造部件[/b]。

[b]Green Standing Brazier[/b]
- 使用 Guck 作为燃料的绿色火焰 Standing Brazier。
- 需要 Forge。
- 消耗：5 Bronze、2 Guck、3 Fenris Claws。

[b]Silver Sconces[/b]
- Silver Sconce - Resin
- Blue-burning Silver Sconce - Greydwarf Eye
- Green-burning Silver Sconce - Guck
- 需要 Forge。
- 每个通常消耗：2 Ancient Bark、2 Silver、2 对应燃料。

[b]Silver Hanging Braziers[/b]
- Silver Hanging Brazier - Coal
- Blue-burning Silver Hanging Brazier - Greydwarf Eye
- Green-burning Silver Hanging Brazier - Guck
- 需要 Forge。
- 每个通常消耗：5 Silver、1 Chain、2 对应燃料。

[b]Colored Dvergr Lanterns[/b]
- Blue-colored Dvergr Wall Lantern
- Green-colored Dvergr Wall Lantern
- Blue-colored Dvergr Pole Lantern
- Green-colored Dvergr Pole Lantern
- 需要 Black Forge。
- 壁挂消耗：2 Copper、1 Lantern、1 Chain。
- 立杆消耗：3 Copper、1 Lantern、1 Chain。

[line]

[size=5][b]🔗 MarsarahTweaks 兼容性[/b][/size]

MarsarahTweaks 是一个[b]可选软依赖[/b]。BuildPieces 在没有它的情况下也能正常运行。

[b]Cheaper Build Pieces Amounts[/b]
- Green Standing Brazier Bronze：5 → 3
- Silver Sconce Silver：2 → 1
- Silver Hanging Brazier Silver：5 → 3
- Colored Dvergr Wall Lantern Copper：2 → 1
- Colored Dvergr Pole Lantern Copper：3 → 2

[b]Permanent Lights[/b]
- Green Standing Brazier 燃料：2 → 5
- Silver Hanging Brazier 燃料：2 → 5
- Silver Sconce 燃料：2 → 6
- [b]Permanent Lights 和 Mystical Light Ward 互斥。[/b] 在另一个选项激活时启用其中一个会禁用另一个选项。

[b]Brighter Lanterns[/b]
- 当启用 Tweaks 的 Brighter Lanterns 功能时，自定义蓝色和绿色 Dvergr Lanterns 会使用匹配的更亮设置。

[b]Max Portals Per Player[/b]
- 当两个模组都安装时，Glacial Stone Portal 会被 Tweaks 的传送门限制识别。

[line]

[size=5][b]🔮 未来计划[/b][/size]

计划中的未来功能是 [b]Smart Dropbox[/b]：一个功能性容器，可自动将存入的物品分配到附近已经包含相同物品/类型的容器中。

在我自己完成该生物群落之后，将审查 Deep North 建造部件和其他相关内容。

上述计划可能会随着开发继续而变化。

[line]

[size=5][b]💬 反馈[/b][/size]
欢迎在 Nexusmods 页面的 [b]Posts[/b] 或 [b]Bugs[/b] 标签页中提出建议和报告错误。
感谢查看 Marsarah Build Pieces！

[size=5][b]🧑‍🤝‍🧑 鸣谢[/b][/size]
- ValheimModding 团队 - 感谢 Jotunn
- Blaxxun-bloop - 感谢 ServerSync

[size=5][b]📜 版本历史[/b][/size]

[size=4][b]v1.0.0[/b][/size]
- [b]初始独立发布。[/b]

[b]独立建造部件模组：[/b]
- 将之前包含在 Marsarah Tweaks 中的自定义建造部件系统移至 MarsarahBuildPieces。
- 添加 Jotunn 集成和 ServerSync 配置支持。
- 添加 MarsarahTweaks 作为可选软依赖。

[b]Pocket Portal：[/b]
- 添加 Pocket Portal 和可制作的 Portal Core。
- Portal Core 配方：在 4 级 Workbench 使用 5 Surtling Cores、20 Fine Wood、5 Freeze Glands 和 20 Obsidian。
- 将 Pocket Portals 限制为每个玩家只能放置一个传送门。
- 添加自定义 Raven 教程。
- 更新归属 / 最大建造处理。

[b]Glacial Stone Portal：[/b]
- 添加未使用的原版石制传送门，作为可建造的 Mountain 层级传送门。
- 需要 Stonecutter，消耗 6 Stone、2 Freeze Glands 和 2 Surtling Cores。
- 添加 MarsarahTweaks Max Portals Per Player 集成。

[b]Mystical Light Ward：[/b]
- 添加本地永久光源机制，可为其半径内的有燃料光源补充燃料。
- 默认半径 32m，可配置为 5m 到 50m。
- 添加放置半径可视化。
- 移除普通 Ward 行为和继承的原版 Ward 教程。
- 禁用该功能时，现有 Wards 会进入休眠状态。

[b]Extra Lights:[/b]
- 添加 Green Standing Brazier。
- 添加三个 Silver Sconces。
- 添加三个 Silver Hanging Braziers。
- 添加蓝色/绿色 Dvergr Wall 和 Pole Lanterns。

[b]MarsarahTweaks 兼容性：[/b]
- Cheaper Build Pieces Amounts 集成。
- Permanent Lights 自定义光源消耗集成以及与 Mystical Light Ward 的互斥。
- Brighter Lanterns 与彩色 Dvergr Lanterns 集成。
- Glacial Stone Portal 支持 Max Portals Per Player。