Raft Flotsam – Ocean Salvage

Raft Flotsam – 海洋漂流物

将《Raft》风格的海洋打捞玩法带入 Minecraft！

安装 Raft Hook 模组，获得《Raft》风格的钩子，让你可以远距离收集漂浮物！

航行、游泳或探索海洋时，收集漂浮的碎片、木桶和板条箱。

Raft Flotsam 重现了《Raft》中标志性的漂浮物系统，并将其带入 Minecraft。穿越海洋，寻找漂浮资源、可收集的木桶，以及装满珍贵战利品的稀有板条箱。

专为单人和多人游戏打造，支持 Fabric、Forge，并可选集成 Valkyrien Skies（Forge/Fabric）。

---

特色

• 🌊 《Raft》风格的漂浮物系统
• 🪵 漂浮的原木、木棍、石头和泥土
• 🛢 装有《Raft》风格战利品的漂浮木桶
• 📦 藏有稀有奖励的漂浮板条箱
• ⛵ 支持游泳、原版船只，以及 Valkyrien Skies 木筏/船只（需安装附属模组）
• 🚢 可选支持 Valkyrien Skies
• 👥 适合多人游戏的共享生成航道
• ⚡ 自动清理与实体数量上限系统
• ⚙ 可通过 JSON 完全配置
• 📋 为整合包提供数据驱动的战利品表

---

运作方式

当你在海洋中移动时，模组会根据你的前进方向，在前方生成动态漂浮物航道。

默认情况下，漂浮物只会出现在海洋生物群系中，内容包括：

• 橡木原木
• 木棍
• 石头
• 泥土
• 木桶
• 板条箱

系统会追踪实际移动方向，并加入方向锁定机制，防止通过快速旋转或曲折移动滥用生成机制。

附近的玩家共用一条漂浮物航道，避免重复生成战利品。

---

收集方式

漂浮物可以通过以下方式收集：

• 直接触碰
• 驾驶原版船只驶过
• 使用钩子钩取，钩子来自 Raft Hook Mod

木桶和板条箱被收集时会生成一次战利品，随后消失。

---

适合多人游戏

附近的玩家和船只会被编为一组，共用一条生成航道。

这样可以防止同行玩家生成两倍或三倍于预期的战利品，同时让服务器和多人地图保持平衡。

---

可选的 Valkyrien Skies 支持

安装可选的 Valkyrien Skies 附属模组：

• Raft Flotsam – Valkyrien Skies Compatibility

整艘船会根据船只速度而非玩家移动生成共用的漂浮物航道。

这样可以防止大型船员队伍同行时重复生成战利品。

---

📊 漂浮物生成概率

漂浮物类型	默认概率
橡木原木	30%
木棍	25%
石头	22%
泥土	18%
木桶	4%
板条箱	1%

所有数值均可配置。

---

🛢 木桶战利品表

木桶会进行 2–3 次战利品抽取。

物品	每次抽取的概率
橡木原木	37.73%
甘蔗	18.87%
煤炭	14.15%
铁粒（1–4 个）	9.43%
线	7.08%
石头	6.13%
胡萝卜	3.30%
马铃薯	3.30%

灵感来自《Raft》原版木桶战利品系统，并针对 Minecraft 进行了改编。

---

📦 板条箱战利品表

板条箱会进行 3–5 次战利品抽取

物品	每次抽取概率
橡木原木	17.0%
石头	14.0%
泥土	13.0%
线	11.0%
煤炭	8.0%
燧石	6.0%
小麦	5.0%
竹子	4.5%
甘蔗	4.5%
粗铁	3.5%
粗铜	3.0%
墨囊	2.0%
海晶碎片	1.5%
原版树苗	总计 2.0%
粗金	2.0%
末影珍珠	1.2%
绿宝石	0.8%
附魔书	0.6%
钻石	0.4%

附魔书使用原版钓鱼风格的附魔。

---

命令

重载配置

/raftflotsam reload

无需重启服务器即可重载配置。

权限等级： 2

---

⚙ 配置

配置文件：

config/raft_flotsam.json

常规设置

选项	默认值	描述
enabled	true	启用或禁用该模组。
spawnIntervalTicks	20	生成尝试间隔。
spawnChancePerInterval	1.0	每次生成尝试成功的概率。
spawnDistanceMin	130	前方最小生成距离。
spawnDistanceMax	166	前方最大生成距离。
cleanupDistanceMargin	10	超出生成范围的额外清理距离。
spawnLaneHalfWidth	25	横向生成通道的最大宽度。
groupRadiusBlocks	64	用于将附近玩家分组的半径。
minHorizontalSpeed	0.04	所需的最小移动速度。
entityLifetimeTicks	1800	实体存活时间（90秒）。
maxActiveFlotsamPerGroup	500	每组最多存在的漂浮物数量。
oceanBiomesOnly	true	仅在海洋生物群系中生成。

方向保护

选项	默认值	描述
directionLockTicks	100	接受方向变更后的锁定时长。
directionTurnThresholdDegrees	35	大幅转向的角度阈值。
directionStabilityTicks	60	接受大幅转向前所需的稳定时间。

生成权重

类型	权重
原木	30
木棍	25
石头	22
泥土	18
木桶	4
板条箱	1

将任意权重设为 0 即可禁用该项。

---

⚡ 性能与技术细节

Raft Flotsam 包含多项旨在减少服务器负担的系统：

• 多人共享生成通道
• 附近玩家分组
• 自动清理遗弃的漂浮物
• 可配置的实体存活时间
• 活跃实体数量上限
• 以新实体替换最旧实体
• 由服务器权威控制生成
• 由服务器生成战利品

当通道中的实体数量达到上限时，系统会自动用新生成的漂浮物替换最旧的已追踪漂浮物，避免实体数量无限增长。

玩家或船只遗留的漂浮物一旦超出配置的清理距离，就会自动清除。

这些系统有助于在繁忙的多人服务器上保持性能。

---

📦 前置</assistant

此模组需要以下前置库才能正常运行：

• Architectury API（必需）

Architectury API 用于提供 Fabric 与 Forge 之间的跨平台兼容性，让模组能在这两种加载器上共用相同的核心逻辑。

未安装 Architectury API，模组将无法加载。

---

🧪 测试状态

此模组仍需进一步测试，才能确认在所有环境下都完全稳定。

非常欢迎提供服务器测试反馈。

---

🇪🇸 西班牙语

Raft Flotsam – Ocean Salvage

将《Raft》风格的海洋打捞系统带入 Minecraft！

安装模组 Raft Hook，即可获得《Raft》风格的钩子，让你能从远处收集漂浮残骸。

在航行、游泳或探索开阔海域时，收集漂浮残骸、木桶和箱子。

Raft Flotsam 将《Raft》标志性的漂浮残骸系统还原到 Minecraft 中。畅游海洋，寻找漂浮资源、可收集的木桶，以及装满珍贵战利品的稀有箱子。

专为单人和多人游戏打造，支持 Fabric、Forge，并可选集成 Valkyrien Skies（Forge/Fabric）。

---

功能特色

• 🌊 灵感源自《Raft》的漂浮残骸系统
• 🪵 漂浮在海洋中的橡木原木、木棍、石头和泥土
• 🛢 装有《Raft》风格战利品的漂浮木桶
• 📦 可获得稀有奖励的漂浮箱子
• ⛵ 兼容游泳、原版船只，以及 Valkyrien Skies 的木筏/船只（需安装附属模组）
• 🚢 可选支持 Valkyrien Skies
• 👥 多人游戏共享生成区域
• ⚡ 自动清理与实体数量上限系统
• ⚙ 支持通过 JSON 完全配置
• 📋 基于数据的战利品表，适用于整合包

---

运作方式

你在海洋中移动时，模组会在你前进方向的前方生成动态的漂浮残骸区域。

默认情况下，残骸只会在海洋生物群系中生成，类型包括：

• 橡木原木
• 木棍
• 石头
• 泥土
• 木桶
• 箱子

系统会追踪实际移动方向，并加入方向锁定机制，避免玩家通过快速转向或之字形移动滥用机制。

附近的玩家共用一个残骸生成区域，以避免重复生成战利品。

---

收集方式

可通过以下方式收集漂浮残骸：

• 直接触碰
• 驾驶原版船只从上方驶过
• 使用 Raft Hook Mod

的钩子将其钩住木桶和箱子被收集时只会生成一次战利品，随后便会消失。

---

多人游戏兼容

附近的玩家和船只会被归为一组，共用一个生成区域。

这样可以避免结伴航行的玩家生成双倍或三倍战利品，让服务器和多人世界中的游戏体验保持平衡。

---

可选支持 Valkyrien Skies

安装可选的附属模组：

• Raft Flotsam – Valkyrien Skies Compatibility

船只会根据船速而非玩家移动来生成共用的漂浮残骸区域。

这样可以避免多人船员结伴航行时生成重复战利品。

---

📊 漂浮残骸生成概率

残骸类型	默认概率
橡木原木	30%
木棍	25%
石头	22%
泥土	18%
木桶	4%
箱子	1%

所有数值均可配置。

---

🛢 木桶战利品表

木桶会进行 2–3 次战利品抽取。

物品	每次抽取概率
橡木原木	37.73%
甘蔗	18.87%
煤炭	14.15%
铁粒（1–4）	9.43%
线	7.08%
石头	6.13%
胡萝卜	3.30%
马铃薯	3.30%

灵感源自 Raft 原版的木桶战利品系统，并针对 Minecraft 进行了改编。

---

📦 箱子战利品表

箱子会进行 3–5 次战利品抽取。

物品	每次抽取概率
橡木原木	17.0%
石头	14.0%
泥土	13.0%
线	11.0%
煤炭	8.0%
燧石	6.0%
小麦	5.0%
竹子	4.5%
甘蔗	4.5%
粗铁	3.5%
粗铜	3.0%
墨囊	2.0%
海晶碎片	1.5%
原版树苗	总计 2.0%
粗金	2.0%
末影珍珠	1.2%
绿宝石	0.8%
附魔书	0.6%
钻石	0.4%

附魔书使用原版钓鱼风格的附魔。

---

命令

重新加载配置

/raftflotsam reload

无需重启服务器即可重新加载配置。

权限等级：2

---

⚙ 配置

配置文件：

config/raft_flotsam.json

常规设置

选项	默认值	说明
enabled	true	启用或禁用该模组。
spawnIntervalTicks	20	生成尝试的间隔。
spawnChancePerInterval	1.0	每次尝试成功的概率。
spawnDistanceMin	130	前方生成的最小距离。
spawnDistanceMax	166	前方生成的最大距离。
cleanupDistanceMargin	10	超出生成范围的额外清理距离。
spawnLaneHalfWidth	25	生成通道的最大侧向宽度。
groupRadiusBlocks	64	用于将附近玩家划分到同一组的半径。
minHorizontalSpeed	0.04	生成残骸所需的最低速度。
entityLifetimeTicks	1800	实体存留时间（90 秒）。
maxActiveFlotsamPerGroup	500	每组可同时存在的残骸数量上限。
oceanBiomesOnly	true	仅在海洋生物群系中生成。

方向保护

选项	默认值	说明
directionLockTicks	100	接受方向变化后锁定的持续时间。
directionTurnThresholdDegrees	35	急转弯的角度阈值。
directionStabilityTicks	60	接受大幅转向前所需的稳定时间。

生成权重

类型	权重
木头	30
木棍	25
石头	22
泥土	18
木桶	4
板条箱	1

将任意权重设为 0 即可禁用。

---

⚡ 性能与技术细节

Raft Flotsam 包含多种系统，旨在确保服务器保持良好性能：

• 多人游戏共享生成通道
• 附近玩家分组
• 自动清理遗弃的漂流物
• 可配置实体存活时间
• 活跃实体数量上限
• 替换最旧的实体
• 由服务器控制生成
• 由服务器控制战利品生成

当某条通道达到实体数量上限时，系统会自动用新生成的漂流物替换最早记录的漂流物，而不是让实体数量无限增长。

当玩家或船只遗弃的漂流物超出设定的清理距离时，系统会自动将其移除。

这些系统有助于在多人游戏服务器负载很高时依然保持良好性能。

---

📦 依赖项

此模组需要以下依赖项才能正常运行：

• Architectury API（必需）

Architectury API 用于提供 Fabric 与 Forge 之间的兼容性，使该模组能在两种模组加载器上共用相同的基础逻辑。

如果未安装 Architectury API，该模组将无法加载。

---

🧪 测试状态

此模组仍需进一步测试，才能被视为在所有环境下都完全稳定。

非常欢迎大家提供服务器测试反馈。