⛵ 巴尔隆德船坞 – 模组文档

总览

巴伦德造船厂 为英灵神殿的海战玩法增添了 新舰船, 飞船升级系统, 自定义制作站, 防水船坞建筑部件，一个 渔网陷阱，以及一系列 水手主题物品.

当前版本包含完整的 基于ServerSync的配置系统 用于飞船配方、空间站配方、所有飞船升级蓝图配方、货物库存尺寸、每艘飞船的基础物理/属性配置，以及可配置的桨行为。

舰船升级通过以下方式处理 图纸 在以下地点制作： 抄写台 并应用于 船坞 车站。

---

⚠️ 重要警告

• 重大更新警告： 版本 1.3.0 和 1.4.0 引入了大型船只和货物改动。
• 更新前， 如果可能的话，清空你的飞船库存 以降低物品丢失的风险。
• 如果你更换一艘船的 物品栏宽度或高度先把那艘船清空，然后 重新加载/重新进入世界 在更改配置以便容器可以安全地重新创建之后。
• 如果你正在升级飞船，请保留 只有目标飞船靠近船坞站 以避免检测到错误的船只。
• 飞船属性配置，位于 1.8.0 改变受支持舰船的基础数值。极端的物理数值可能导致舰船不稳定；请谨慎修改推进力、阻尼、质量、转向和风帆力偏移。

---

🧰 核心特色

• 🚢 三艘新船
  添加 克诺尔, 霍尔克，以及 蛇形船 同时支持多艘原版舰船。

• 🛠️ 两个制作站

  • 书记台 – 用于建造飞船 图纸.
  • 造船厂 – 用于通过将图纸放入站内并拉下拉杆来应用升级。

• ⚓ 飞船升级系统
  舰船可以获得主题升级，例如 护盾, 灯, 锚点, 帐篷, 护甲, 桨, 绳索，以及 姓名牌，取决于船只。

• 🎨 视觉飞船自定义
  支持的舰船可以使用多个 船帆颜色/图案, 盾牌图案，以及船只专属的外观替换。应用不同的船帆方案会替换当前选中的船帆外观。

• 🌊 防水建筑套装
  包含一套以造船厂为主题、旨在抵御 水和雨水伤害.

• 🎣 渔网陷阱
  一种可放置的钓鱼建筑，在提供正确鱼饵时能更有效地捕获适合当地生物群落的鱼类。

• 🧳 扩展舰船功能
  货舱尺寸、挂载点、舒适度行为以及若干飞船功能会因飞船类型而扩展或调整。

• ⚙️ 服务器同步配置
  船只配方、船坞/抄写台配方、所有设计图配方、货舱尺寸、基础船只统计数据/物理参数以及船桨行为均可配置，并通过以下方式同步 服务器同步.

• 🚤 每艘舰船的基础属性配置
  受支持的船只可独立配置基础生命值、质量、帆力/桨力、转向、阻尼、撞击伤害、灰烬之地适配性和风化行为，无需替换船坞升级加成。

---

🔧 使用方法

1. 制作一个 书记台.
2. 创建一个 蓝图 想要购买的船只扩展或自定义项目。
3. 建造 造船厂 站点。
4. 将图纸放入船坞容器中。
5. 停靠目标船只 尽可能接近 前往造船厂。
6. 拉动船坞上的拉杆以应用升级。

笔记

• 如果范围内有多艘有效飞船， 首次检测到兼容飞船 可升级。
• 如果一艘舰船已包含不可替换的升级，空间站可能会尝试探测附近另一艘有效舰船。
• 船帆颜色/图案升级可替换：应用另一份有效的船帆设计图会改变当前船帆的外观。
• 最佳实践：保留 其他所有船只离开 只停靠你想要修改的飞船。
• 扩展适用于 原版船只 和 本模组添加的自定义舰船.
  木筏已从通用扩展系统中排除，但它有自己的默认背包扩展。

---

⚙️ 配置与服务器同步

巴隆造船厂在模组加载后创建其配置文件：

BepInEx/config/balrond.astafaraios.BalrondShipyard.cfg

当前配置使用以下分组：

• 1 - 常规
• 2 - 飞船配方
• 3 - 车站配方
• 4 - 图纸配方
• 5 - 飞船库存
• 一 6 - 舰船属性 - <Ship> 每艘支持的飞船对应一个部分
• 7 - 船只升级 - 船桨

1 - 常规

锁定配置

• 1 – 服务器/主机配置对同步的游戏设置具有权威性。
• 0 – 同步设置不受服务器锁定。

多人游戏和专用服务器请保持此设置 1 建议这样做，以便每个客户端都使用相同的游戏配置。

允许使用锤子摧毁船只

• 真 – 支持的舰船可通过锤子移除操作进行拆解。
• 假 – 支持的舰船已禁用锤子移除功能。

此设置为 仅限本地。这是故意 未通过 ServerSync 同步 且不受其控制 锁定配置.

2 - 飞船配方

建造配方可独立配置用于：

• 木筏
• 卡夫船
• 克纳尔
• 斯内克
• 长船
• 霍尔克
• 灰烬之地龙船

配方格式：

预制体：数量，预制体：数量

示例：

细木:30,青铜钉:90,皮革碎片:16,鹿皮:10,煤炭膏:20

这 木筏 使用 默认 默认情况下，它保留其正常的英灵神殿配方。它仍然可以用自定义配方替换。

无效的配方字符串会回退到模组内置/默认配方，而不是静默创建一个不完整的配方。

3 - 空间站配方

两个自定义空间站的建设成本均可配置：

• 船坞站配方
• 抄写台配方

他们使用相同的 预制体：数量 配方格式。

4 - 图纸配方

每个升级/定制图纸都有其 可自定义的专属配方.

当前版本开放 113个独立图纸配方条目，包括船只扩展和视觉自定义，例如船帆变体。

这些数值控制制作该图纸的材料成本，在 抄写台然后通过以下方式消耗/应用该示意图： 造船厂 工作流。

5 - 飞船库存

货舱尺寸可以为全部七种支持的飞船类型单独配置：

• 木筏
• 卡维尔
• 克纳尔
• 蛇形船
• 长船
• 霍克
• 灰烬之地龙船

每艘舰船拥有：

• 物品栏宽度
• 物品栏高度

有效配置尺寸为 1–20.

值为 -1 或 0 意思是：

保留飞船预制件中设定的货物尺寸。

更改货物尺寸前，请先清空飞船，然后 重新加载/重新进入世界 再次使用现有舰船库存之前。库存尺寸是主要的配置类别，应视为需要重新创建容器。

6 - 舰船属性 - <Ship>

版本 1.8.0 为所有支持的舰船添加同步的基础属性档案。

各分区如下：

舰船	配置部分
木筏	6 - 船只属性 - 木筏
卡维尔	6 - 船只属性 - 卡维
克纳尔	6 - 船只属性 - 克纳尔
蛇船	6 - 船只属性 - 斯内克船
长船	6 - 船只属性 - 德拉克船
霍尔克	6 - 船只属性 - 霍尔克
灰烬之地龙船	6 - 船只属性 - 灰烬之地龙船

以下基础数值可为每艘舰船单独配置：

配置项	控制
基础生命值	基准 损坏 造船厂扩展加成前的生命值
基础质量	基础刚体质量（未加扩展质量前）
航行力系数	基础风帆推进系数
覆盖航行力偏移	启用明确的帆力施加偏移
帆力偏移	启用覆盖时使用的风帆力偏移
划桨力量	基础划船/划桨力度
舵速	基础转向/方向舵响应
启用强制航行	航行时的基础转向力
强制划桨	划桨时的基础转向力
前向阻尼	前进移动阻尼
侧向阻尼	侧移/漂移阻尼
角阻尼	角速度/旋转阻尼
水花冲击伤害	硬水冲击造成的基础伤害
翻转伤害	舰船倾覆时的基础伤害
灰烬之地已就绪	控制船只的灰烬之地海洋就绪标志
无顶天气装	控制无顶棚/天气磨损行为

对于普通的数值属性条目， -1 意为：

保留原始飞船预制体中设定的值。

覆盖帆力偏移 = false 保留创作的帆力偏移。启用后， 帆力偏移 成为显式配置的值。

对于 灰烬之地就绪 和 无顶棚天气装:

• -1 – 保留预制体数值
• 0 – 假
• 1 – 真

基础属性如何与船坞升级相互作用

1.8.0属性系统刻意采用此顺序：

1. 创作的预制体值
2. 船坞基础属性配置
3. 已安装的船坞升级/扩展
4. 临时运行时修正，例如船桨和兼容的航海技能效果
5. 原版船只物理

这意味着一个已配置的 基础生命值 或 基础质量 做 不 替换已安装的船坞扩展所增加的生命值/质量。配置值将作为基础值，扩展加成会在之后应用。

同样，来自船桨或兼容航海技能的转向和推进加成会作为临时运行时倍率应用，而不会永久写回配置的基础数值中。

预制体基准数据与实船状态分开记录，因此配置刷新不会误将已安装的升级或临时的航行/划桨倍率一并纳入并重复应用。

7 - 船只升级 - 船桨

船桨升级现在拥有自己的同步行为配置。

配置项	默认	行为
转向倍率	1.10	安装船桨时的基础转向倍率
每增加一名船员获得的操舵加成	0.05	每多一名玩家乘坐，转向倍率额外提升
前排倍率	1.0	向前划桨时的桨力倍率
反转行倍数	1.0	倒划时桨力倍率
每增加一名船员获得的列奖励	0.0	每额外一名船员增加的桨力倍率
最大额外船员数量	8	仅将用于乘数计算的船员贡献计入上限

第一个登船的玩家是基准船员。船员数量缩放只计算第一位之后的额外玩家，且从不会限制实际乘客数量。

使用默认值时，船桨会保留原有的转向加成，而前进/后退推进力保持不变，除非管理员启用额外的划桨倍率。

船桨修饰符已注入 仅在飞船物理更新期间 之后会被恢复。它们不是对飞船基础转向或桨值的永久写入。

服务器同步

巴尔德造船厂使用 服务器同步 v1.20 用于同步游戏玩法配置。

以下游戏设置将同步：

• 舰船建造配方
• 造船厂和书记官桌的配方
• 所有图纸配方
• 飞船库存宽度/高度设置
• 所有单船基础属性/物理配置
• 所有划桨行为设置

与 锁定配置 = 1，对于这些同步设置，服务器/主机的数值是权威依据。

允许使用锤子摧毁船只 是明确的例外：它仍然是一个 本地客户端偏好.

Balrond船坞被配置为必需的同步模组，因此多人游戏客户端应使用与服务器相同的Balrond船坞版本。

服务器同步已捆绑/内置到 巴伦德造船厂.dll 使用 ILRepack。你无需单独安装 ServerSync DLL。

---

📌 重要玩法变更

• 船只和新建造部件使用 煤膏 在模组定义的位置代替树脂。
• 煤膏 在……制作 工作台等级3 通过混合 煤和树脂.
• 舰船建造配方可配置。
• 多艘飞船的基础货舱容量已调整，可通过配置覆盖。
• 木筏 已收到库存支援。
• 版本 1.8.0 为每艘支持的飞船添加可配置的基础飞船属性和操控/物理数值。
• 舰船属性配置定义了 基础已安装的船坞扩展随后生效。
• 船桨使用临时的运行时转向/划桨倍率，不再永久覆盖船只操控数值。
• 造船厂确实如此 不 对船帆更换、船头装饰更换、船只命名、船锚、开关或正常造船厂修改流程施加创建者/所有权限制。
• 名牌是一种 舰船命名功能，而非所有权锁定系统。
• 英灵神殿/ZDO网络所有权仍会在复制和物理权限所需之处使用，但不再将其视为玩家权限系统。
• 船厂的运行时航行逻辑仅限于船厂管理的船只，不会全局重写任意第三方船只。
• 船坞建造部件使用明确的 Valheim 1.0 用途/分类标签，以便它们显示在合适的建造菜单分类中。

---

船只建造费用

以下是 默认建造成本 由Balrond造船厂使用。这些数值可以在 2 - 飞船配方.

船	默认建造成本
卡维尔	30 优质木材 · 90 青铜钉 · 16 碎皮革 · 10 鹿皮 · 20 煤膏
纳尔	35份优质木材 · 120枚青铜钉 · 14块皮革碎片 · 12张巨魔皮 · 25份煤炭膏
斯内克	40 优质木材 · 100 铁钉 · 30 煤膏 · 16 巨魔皮 · 30 古树皮
长船	45份细木 · 200枚铁钉 · 40份煤膏 · 12张狼皮 · 4份红麻
灰烬之地龙船	50 优质木材 · 350 铁钉 · 25 焦油 · 40 世界树之木 · 40 陶瓷板
霍尔克	50 世界之树木材 · 400 铁钉 · 50 古树皮 · 12 洛克斯毛皮 · 20 焦油

木筏： 它的配方配置默认设置为 默认，这会保留正常的英灵神殿配方。你可以将其替换为自定义的 预制体：数量 可选的配方。

飞船升级、扩展和自定义蓝图在以下项目下有各自的独立费用，详见 4 - 图纸配方.

---

🚤 舰船扩展

🪵 木筏

包含功能

• 背包 – 默认始终激活，并添加一个 2格宝箱.

配置

• 木筏建造配方可以保持原版，使用 默认 或者被覆盖。
• 木筏库存的宽度/高度可以覆盖； -1/0 保留预制件值。
• 筏基底座的生命值、质量、操控性、推进力、阻尼、伤害、灰烬之地就绪状态以及风化损耗行为均可在以下位置配置： 6 - 船只属性 - 木筏.

---

🛶 小船

扩展

• 护盾 – 使船只生命值提高 200
• 灯 – 添加一个光源，具有 温暖效果
• 背包 – 增加 钝击抗性 和 +100 生命值
• 船桨 – 改善转向性能，并可选择添加可配置的正向/反向划船及船员缩放加成
• 锚点 – 允许船只原地停泊
• 护甲 – 增加 穿刺抗性 和 +100 生命值
• 铭牌 – 添加舰船命名信息；不会创建所有权或修改锁定

其他改动

• 添加了一个 前部挂载点
• 默认货物尺寸： 6个栏位
• 货物尺寸可配置

---

🪶 克纳尔号

扩展

• 护盾 – 使舰船生命值提高 200
• 灯 – 添加一个光源，带有 温暖效果
• 背包 – 增加 钝击抗性 和 +100 生命值
• 桨 – 改善转向，并可选择添加可配置的前进/后退划桨和船员规模加成
• 锚点 – 允许飞船原地停泊
• 帐篷 – 使舰船生命值提高 200
• 护甲 – 增加 穿刺抗性 和 +100 生命值
• 名牌 – 添加飞船命名信息；不会创建所有权或修改锁定

额外改动

• 已添加一个 前挂载点
• 默认货舱容量： 12个槽位
• 货物尺寸可配置

---

🐍 斯内克船

扩展

• 护盾 – 使舰船生命值提高 200
• 灯 – 添加一个光源，带有 温暖效果
• 背包 – 添加 钝击抗性 和 +100生命值
• 船桨 – 改进转向性能，并可选添加可配置的前进/后退划船以及船员规模加成
• 锚点 – 允许船只原地停泊
• 帐篷 – 使舰船生命值提高 200
• 护甲 – 添加 穿刺抗性 和 +100 生命值
• 名牌 – 添加船只命名信息；不会创建所有权或修改锁定

额外改动

• 已添加 前挂载点
• 默认货物大小： 18个槽位
• 货物尺寸可配置

---

🛡️ 长船

扩展

• 护盾 – 使舰船耐久度提高 300
• 灯 ——添加一盏灯和一些火把，带有 光与温暖
• 木桶 – 增加 钝击抗性 和 +100 生命值
• 板条箱 – 增加 斩击抗性 和 +100 生命值
• 船桨 – 改善转向，并可选择性添加可配置的前进/后退划船和船员规模加成
• 锚点 – 允许飞船原地停泊
• 帐篷 – 增加舰船生命值 300 并且提供 庇护所 在其下方时
• 护甲 – 增加 穿刺抗性 和 +200 生命值
• 名牌 – 添加飞船命名信息；不会创建所有权或修改锁定

其他改动

• 默认货物容量： 24个槽位
• 货物尺寸可配置
• 支持 3个替代头部装饰

---

🧱 霍克

扩展

• 护盾 – 使舰船生命值提高 300
• 灯 ——添加一盏灯、几支火把，以及一个 除雾器般的缕状特效
• 板条箱 – 增加 钝击抗性 和 +200 生命值
• 桨 – 改进转向，并可选择添加可配置的前进/后退划桨和船员规模加成
• 锚点 – 允许船只原地停泊
• 帐篷 – 使舰船生命值提高 200 并提供 庇护所 在其下方时
• 护甲 – 添加 穿刺抗性 和 +200 生命值
• 绳索 – 在船两侧增加额外的绳梯
• 名牌 – 添加飞船命名信息；不会创建所有权或修改锁定

其他改动

• 默认货物尺寸： 32格
• 货物尺寸可配置

---

🐉 灰烬之地龙舟

巴伦德造船厂也支持以下配置： 灰烬之地龙船.

配置

• 建造配方可配置。
• 货物栏位宽度/高度可配置。
• 默认配置的货物尺寸为 8 × 5（40格）.
• 基础生命值、质量、操控性、推进力、阻尼、伤害、灰烬之地适应性以及耐候行为可在以下位置配置 6 - 船只属性 - 灰烬之地龙船.

---

🎨 共享飞船功能

支持升级的舰船可根据舰船类型享受共享的自定义和扩展系统：

• 多 船帆颜色/图案 选项
• 船帆外观之后可以通过应用不同的兼容船帆设计图再次更改
• 免费 护盾模式切换 安装相关升级后
• 大多数结构/货物耐久升级也会增加飞船质量。

  延展质量贡献仍约为相关生命加成的一半。 护甲被有意排除在扩展派生质量之外 并且在不增加额外质量的情况下提升了耐久度。

---

🪚 船厂建造部件

这些是标准建筑部件，带有 船坞美学 以及对……的抵抗 水/雨伤害他们被设计成 深色核心木带绳索细节.

造船厂部件使用显式 Valheim 1.0 用途 类别，而不是回退到错误或默认标签，从而改善在现代建造菜单或类别系统中的放置。

结构件

• 2米和4米杆
• 光束2米和4米
• 45°和27°光束
• 斜坡 / 27° 地面
• 楼层
• 1米杆

其他构建元素

• 焦油壁灯
• 小货箱（4个槽位)
• 码头货箱（40个槽位)
• 小型龙头摆件
• 2米梯子，可交互传送至顶端
• 2面绿色布旗
• 4个绿色布顶
• 2个绳梯
• 3个绳桥部件
• 吊灯
• 渔网墙
• 渔网陷阱

---

🎣 渔网陷阱

该 渔网陷阱 建在水上，可以装载适合生物群系的鱼饵。

• 使用正确的鱼饵可以增加钓到该生物群系原生鱼类的几率。
• 没有合适的诱饵，陷阱依然能捕获 每2分钟获得基础鱼.

---

🧳 物品预制体 ID

• 水手角
• 煤泥
• 海盗头巾头盔
• 海盗帽头盔
• 剑刃
• 大锤锚
• 护盾转向

---

❓常见问题

• 有配置文件吗？
  是的。Balrond造船厂包含同步配置，适用于 舰船配方, 造船厂/书记官桌配方, 全部113张图纸配方, 货物尺寸, 每艘舰船的基础统计数据/物理特性，以及 船桨行为.

• 配置文件在哪里？
  BepInEx/config/balrond.astafaraios.BalrondShipyard.cfg

• 这个模组使用服务器同步吗？
  是的。游戏玩法配置通过以下方式同步： 服务器同步 v1.20与 锁定配置 = 1，服务器/主机配置具有权威性。

• 我需要单独安装ServerSync吗？
  不，ServerSync 是 已内置/整合到 BalrondShipyard.dll 中.

• 我可以配置基础飞船的操控和物理效果吗？
  是的。每艘已支持的飞船都有其自己的 6 - 舰船属性 - <Ship> 基础生命值、质量、帆/桨动力、转向、阻尼、撞击伤害、Ashlands 备战状态和天气磨损行为等部分。

• 更改基础生命值或基础质量会移除船坞升级加成吗？
  不。这些条目定义了 基础已安装的船坞扩展加成将在之后计算。

• 航行技能或其他航行模组还能影响船坞的船吗？
  1.8.0运行时层的设计使临时航行修正可以叠加在船坞配置的基础值之上。船桨仅在船只物理更新期间生效，之后便恢复原状，而非永久占用底层的原版属性字段。

• 造船厂会把船只自定义锁定为建造该船的玩家吗？
  不。造船厂不会通过创建者/所有权检查来阻止更改船帆、命名、锚、开关或造船厂修改。铭牌用于给船只命名，而非用于所有权权限。

• 我可以多次更换一艘船的帆吗？
  是。兼容的船帆颜色/图案蓝图可以替换当前生效的船帆外观。

• 我能分别配置每个原理图吗？
  是的。每个设计图在下方都有一个独立的配方条目。 4 - 图纸配方.

• 我可以为每艘船单独配置货舱大小吗？
  是的。木筏、卡维、克纳尔、斯内克、长船、霍尔克和灰烬之地的德拉卡，其宽度和高度均可独立配置。

• 我可以禁用锤子移除船只的功能吗？
  是。 允许使用锤子摧毁船只 是仅限本地的设置，位于 1 - 通用。它未同步，且不受 ServerSync 锁影响。

• 有翻译文件吗？
  不，目前暂未包含翻译文件；添加翻译文件已在计划中。

• 我需要更大的建造菜单吗？
  可能吧。因为新增的建筑部件数量，一个 建筑菜单扩展 可能会有用。

  • 推荐搭配使用 建造扩展 例如：
  • 西尔斯目录（ComfyMods）

---

🔌 需求与兼容性

• ✅ 需要 BepInEx
• ✅ 用途 由服务器同步支持的多玩家配置
• ✅ 服务器同步已捆绑 — 无需单独安装 ServerSync
• ✅ 服务器和多人客户端应使用 同版本Balrond造船厂
• ✅ 支持原版飞船以及本模组附带的自定义飞船
• ✅ 使用瓦尔海姆 1.0 公开集会基线 用于直接访问支持的游戏成员并减少核心路径中的反射
• ✅ 桨和船只属性的运行时更改旨在与 巴隆德额外技能 航海 以及使用临时船只物理修改器的其他航行系统
• ✅ 造船厂不会自动为任意第三方舰船安装升级或应用永久性造船厂行为
• ✅ 现有的 ZDO/RPC 多人游戏状态和 Valheim 网络权限保持不变；1.8.0 的性能优化侧重于本地缓存和减少轮询，而非引入新的网络层
• ✅ A 建造菜单扩展 可能因添加的棋子数量而被推荐

运行时行为与性能

1.8.0版本减少了若干飞船组件中不必要的每帧运算：

• 舰船扩展协调使用预定的缓存间隔，而不是每帧计时器轮询。
• 电灯开关、锚点开关、船名牌和护盾涂装器的视觉/状态检查改为按计划协调执行，而非每渲染帧都运行。
• 护盾样式层级查找已缓存。
• 常见的船舶扩展ZDO键已预先哈希，同时保持相同的旧版哈希/存档兼容性。
• 仅在阈值判定时，移动/距离检查在适当情况下使用平方值。
• 移动伤害与以下内容保持一致 固定更新刚体模拟。

这些优化 不 替换《英灵神殿》的在线权威模型，且无意改变游戏时序或引入额外网络流量。

---

💬 社区与支持

• 加入我们的Discord： 巴隆德的巢穴
• 在Ko-fi上支持我们： ko-fi.com/balrond1020

---

让你的港口超越原版——尽在Balrond船坞。