增加一个建筑部件，让你可以为周围区域命名

⚒️ 巴隆德壁炉印记

---

总览

巴尔隆德火炉印记 添加一个新的可建造物 炉石印记 瓦尔海姆的护身符。

炉石印记会在你的定居点、营地、前哨站、道路、矿场和其他重要地点周围创建命名区域。
当玩家进入一个已命名的炉火标记区域时，区域名称会以与《英灵神殿》生物群系发现消息相同的风格显示。

多个炉石印记可以连接成一个共享网络。
相连的标记共享同一区域名称和消息冷却时间，可一同启用或禁用，并在悬停时显示临时连接光束。

该模组设计简洁，完全在游戏内运行：

无需外部游戏配置。
所有设置都直接在建筑部件上完成。

---

🏗️ 这个模组添加了什么

⚒️ 炉石印记

一件全新的可建造护符样式部件。

炉石印记可以：

• 在自身周围创建一个命名区域
• 玩家进入区域时显示区域名称
• 通过范围与其他炉石印记连接
• 在相连的炉石印记间共享名称
• 在已连接的炉石标记之间共享消息冷却设置
• 切换区域标记的显示与隐藏
• 显示链接标记之间的临时连接光束
• 作为其当前网络的一部分启用或禁用
• 通过Valheim ZDO数据存储其状态以实现多人游戏持久化

---

🧭 运作方式

1. 建造一个 炉石印记
2. 按下 使用 (E) 给它起个名字
3. 悬停并使用 加号 / 减号 调整范围
4. 使用 Ctrl + E 设置区域消息的出现频率
5. 在附近放置更多炉石印记
6. 如果有至少一个炉石标记连接到另一个，它们就会连通
7. 已连接的炉石标记视为一个命名网络

当玩家进入活动区域时，显示已解析的炉石印记名称。

如果连接网络中有一个炉石印记被重命名，该名称将应用于已连接的启用网络。
如果连通网络中一个炉石印记的消息冷却时间发生变化，该冷却时间也会应用于该连通且启用的网络。

---

⚙️ 功能

• 新可建造项 炉石标记
• 命名区域/聚落标记系统
• 已连接的护符网络
• 跨已连接炉石的共享名称
• 连接的炉石印记之间共享消息冷却时间
• 可调整的消息冷却时间，从 1分钟到1440分钟
• 默认消息冷却时间： 10分钟
• 可调节范围从 1米到50米
• 默认范围： 15分钟
• 直接在游戏内更改范围
• 可选持续区域标记显示
• 临时悬停区域标记
• 临时连接光束可视化
• 启用/禁用护符状态
• 全网络禁用行为
• 病房/私人区域通行支持
• 适合多人游戏的ZDO同步
• 完整本地化键支持
• 无需游戏配置文件

---

🧱 建造

建造部件

炉石印记已添加到锤子建造菜单中。

类别：

杂项

制作站：

工作台

🧾 配方

资源	数量
雷石	1
羽毛	3
优质木材	2
骨碎片	3

---

🎮 操作

动作	输入
设置炉石标记名称	E
启用/禁用炉石标记网络	Shift + E
显示/隐藏持续区域标记	Alt + E
设置区域消息冷却时间	Ctrl + E
增加射程	+ 或 小键盘 +
缩短射程	- 或 小键盘 -

⚠️ 瓦尔海姆的 交互() 替代 参数是游戏的备用用途输入，通常 Shift + E.
该模组直接检测真实的键盘 Alt 键以 Alt + E 切换标记。

---

🏷️ 命名系统

按下 E 在炉石标记上打开名字输入。

名称长度限制为：

64个字符

如果炉火印记与其他已启用的炉火印记相连，则该名称将应用于当前连接的网络。

这允许一个大型定居点或基地区域在多个护符之间共享同一名称。

---

⏱️ 消息冷却系统

按下 Ctrl + E 在炉石标记上打开消息冷却输入。

冷却时间以分钟为单位输入。

默认冷却时间：

10分钟

最低冷却时间：

1分钟

最大冷却时间：

1440分钟

冷却时间决定进入炉石标记区域后，区域消息再次出现的频率。
例如，将冷却时间设置为 15 意味着在该时间内，你短暂离开并重新进入区域时，同一条区域消息不会反复出现。

如果炉火印记与其他已启用的炉火印记相连，冷却时间将应用于当前连接的网络。
这意味着相连的护符共享相同的区域名称和相同的消息冷却时间。

---

🔗 网络系统

炉石印记通过范围连接。

两个炉火印记连接时会 至少其中一人到达另一人身边.

示例：

炉石标记A范围：10米 炉石标记B范围：15米 两者间距：12米 A无法覆盖B。B可覆盖A。结果：已连接。

这使得较大的炉印可以作为较小炉印的锚点。

连接的网络在以下情况下重新计算：

• 壁炉标记范围变更
• 一个炉石标记被启用或禁用
• 一个炉石标记被摧毁了
• 一个名字通过网络传播开来
• 消息冷却时间会通过网络传播

---

📏 范围系统

默认范围：

15分钟

最小射程：

1分钟

最大范围：

50米

步长：

1分钟

悬停于炉火标记时：

• 按下 + 增加射程
• 按下 - 缩短射程

切换射程可以：

• 连接新炉石印记
• 断开旧炉石标记
• 合并网络
• 分离网络
• 更改区域进入消息的显示位置

---

👁️ 区域标记

炉火印记有一个区域标记视觉效果。

默认情况下，悬停炉石标记会短暂显示区域标记。

你也可以永久切换标记：

Alt + E

启用后，炉石标记生效期间标记会保持可见。

禁用时，标记仅在悬停时短暂显示。

标记状态通过ZDO数据保存，因此重新加载后仍会保留。

---

🔦 连接显示

当鼠标悬停在已激活的炉石标记上时，该模组会短暂显示直接相连的炉石标记之间的连接效果。

这些光束让你更容易看清哪些护符是相互连接的。

连接光束仅为视觉效果。
实际网络逻辑基于水平距离和有效范围值。

---

🟢 启用 / 禁用状态

炉石标记可以启用或禁用。

按下：

Shift + E

在炉石标记上切换它。

禁用已启用的炉石印记时，当前连接的网络也会一并禁用。

启用已禁用的炉石标记时，只会重新启用该炉石标记。

已禁用的炉石标记：

• 不要连接网络
• 不显示玩家进入消息
• 不显示连接光束
• 显示禁用视觉状态
• 保留其已保存的名称、范围、标记状态和消息冷却时间

---

🛡️ 结界权限

如果需要进入病房/私人区域，玩家必须拥有与炉石印记交互的权限。

这会影响：

• 命名
• 设置消息冷却时间
• 启用/禁用
• 标记切换
• 距离调整

如果玩家没有权限，炉石印记会显示无权限提示。

---

🌐 多人游戏行为

巴尔隆德炉石印记专为多人游戏设计。

重要状态存储在ZDO数据中：

• 炉石印记名称
• 炉石标记名称同步戳
• 炉石标记范围
• 炉石标记消息冷却
• 炉石标记消息冷却同步时间戳
• 启用 / 禁用状态
• 持续区域标记状态
• 已初始化状态

这意味着系统可以跨以下内容持续存在：

• 世界重载
• 服务器重启
• 玩家重新连接
• 区域卸载/重载

在写入网络状态之前，若需要则声明所有权。

---

🧪 技术说明

该插件在Valheim初始化期间注册其资源包和建造组件。

插件信息：

GUID: balrond.astafaraios.BalrondHearthMark 名称: BalrondHearthMark

主预制体：

炉火印记碎片

建造部件已注册到锤子部件表中，并添加到 网络场景.

---

🔧 安装

1. 安装 BepInEx 献给《英灵神殿》。
2. 将模组DLL放入：

BepInEx/plugins

1. 开始游戏。
2. 建造 炉石印记 从锤子建造菜单中。
3. 在游戏内直接配置炉石标记。

不需要额外的玩法配置。

---

🤝 兼容性

巴尔隆德炉火印记应与大多数模组兼容。

它使用：

• 英灵神殿 碎片
• 英灵神殿 网络视图
• 英灵神殿 ZDO
• 英灵神殿 文本输入
• 英灵神殿 可悬停
• 英灵神殿 可交互
• 为预制件/建筑部件注册进行Harmony补丁

可能与以下模组发生冲突：

• 以不兼容的方式替换 Hammer 构建表
• 修改相同的预制体名称
• 干涉 ZNetScene.Awake
• 全局替换普通交互行为
• 修改 检查访问权限 行为

---

📘 翻译支持

所有面向玩家的文本都使用翻译键。

如果你看到类似这样的文字：

炉火标记名称

那么翻译文件未加载或键缺失。

翻译JSON键不应包含 $ 前缀。

示例：

炉火印记

翻译文件存放在config文件夹内，该文件夹位于以mod名称命名的文件夹中 -> English.json

---

❓ 常见问题

这个模组需要配置文件吗？

不。
巴尔伦德炉火印记不需要额外的游戏配置。
所有设置都直接在游戏内的建造部件上完成。

我该如何重命名炉石标记？

将鼠标悬停在炉石标记上并按下 E.

我该如何更改范围？

将光标悬停在炉石标记上并按下 + 或 -.

我该如何设置区域消息冷却时间？

将鼠标悬停在家园标记上并按 Ctrl + E，然后输入冷却时间（以分钟为单位）。

默认消息冷却时间是多少？

默认冷却时间为 10 分钟。

消息冷却时间会在已连接的火种标记之间同步吗？

是。
更改一个已启用的相连炉石印记的冷却时间会将该冷却时间应用于整个相连网络。

我该如何永久显示区域标记？

将鼠标悬停在炉石印记上并按 Alt + E.

我该如何再次隐藏区域标记？

将鼠标悬停在炉火标记上并按下 Alt + E 再来一次。

我该如何禁用炉石印记网络？

将鼠标悬停在已激活的炉石标记上并按 Shift + E.

当我禁用一个已连接的火炉印记时会发生什么？

当前已连接的启用网络也会一并禁用。

我启用已禁用的炉石标记会发生什么？

只有那个炉石印记再次被激活了。
激活后，它可以重新连接到附近已启用的炉印。

炉石印记是如何连接的？

当至少一个炉痕的半径范围触及另一个炉痕时，它们就会连接。

连接的炉石是否共享名称？

是。
重命名一个已启用的连接炉石标记会将名称应用到所连接的网络。

它在多人游戏里能用吗？

是。
主要状态存储在ZDO数据中，并通过Valheim网络同步。

---

💬 社区与支持

Discord： https://discord.gg/Jfp8T5N7Pv
Ko-fi： https://ko-fi.com/balrond1020

---

📌 最终说明

巴尔隆德炉石标记专为希望在世界中命名、整理并直观呈现重要地点而无需依赖外部配置的玩家打造。

放置护符，命名你的定居点，调整范围，设置消息冷却时间，让相连的炉火印记划定你的家园领地。