海洋探险

OceanAdventures

驶向熟悉海岸之外的远方。OceanAdventures 为 Valheim 添加了由服务器权威控制的海上遭遇和个人航行，利用游戏中已有的世界、船只、生物、天气和材料实现。

它不会改变世界生成、物品栏或制作界面。

兼容性与素材

OceanAdventures 将其改动限制在自身的遭遇范围内。它不会替换或重新平衡其他海上或遭遇类模组，也不会全局改变这些模组中船只和生物的行为。它被设计为可与其他模组并行运行，但个别模组组合仍可能影响兼容性。

游戏内的遭遇视觉效果使用 Valheim 原版素材和材料。该包不包含任何提取的游戏文件或第三方素材包。模组图标为原创美术作品。

海上

• 幽灵船： 一艘幽灵长船沿着自己的海上航线航行，会在靠近水手时减速，可在沉没前登船并搜刮。
• 漂流者残骸： 搜索漂浮的残骸以寻找标记货物，将其归还，然后打开打捞箱并选择要拿走的物品。
• 走私者： 拦截一艘移动中的长船，击败其船员，并从其货舱中搜刮货物。
• 风暴锋面： 在服务器发起的风暴中沿标记航线航行。完成航线后会自动获得奖励。

自由遭遇可在航行时发生，即使没有激活的合约。它们奖励资源和贵重物品，从不奖励装备。每次遭遇只能包含一种贵重物品类型。稀有钉子和金属锭受角色已知配方进度的限制。

哈尔多的航行合约

哈尔多提供三份轮换的个人合约。一次只能激活一份；它不会过期，并可在账本处放弃。一个临时地图标记会指向目的地。其他玩家可以协助，但只有合约持有人会获得保证的装备奖励。

合约装备从角色已学会的最高原版配方层级中选择。合约有小概率奖励第二件物品或将某件物品的品质提升一级，且在其正常上限内。沉船和走私者的奖励会放入箱子或货舱中供手动搜刮。

安装

在服务器和每位玩家的机器上安装适用于 Valheim 的 BepInEx 和 Jötunn。将 OceanAdventures.dll 放入每台机器的 BepInEx/plugins/OceanAdventures/ 中。所有人都必须使用相同的模组版本。服务器控制遭遇生成、合约进度、奖励和世界存档。

该模组使用新的配置和存档位置。现有设置以及角色/世界配置文件不会被导入。

配置

服务器配置文件为 BepInEx/config/com.oceanadventures.core.cfg。

自由遭遇

所有事件时间设置均以分钟为单位：

设置	默认值	含义
MinimumWaitAfterEventMinutes	10	一次自由事件结束后，到下一次事件可以开始前的最短等待时间。
CheckForEventsEveryMinutes	1	玩家航行时服务器检查事件的频率。
EventChanceAtEachCheckPercent	15	每次符合条件的检查时事件开始的概率。这不是保证计时器。

合约与奖励

Contract Range 设置 Calm、Balanced 和 Harsh 合约的最小距离和基础最大距离。MaximumDistanceMultiplier 将最大距离最多提升至五倍。服务器仍会搜索安全水域并避开陆地和障碍物。

Rewards 控制第二件合约物品概率、品质升级概率、贵重物品概率、进度材料概率、额外物品掉落、数量范围以及走私者资源加成。默认情况下，走私者支付正常资源量的 1.5 倍。

要添加自定义物品掉落，请使用 CustomEncounterRewards，以分号分隔条目，格式如下：

Encounter,Prefab,ChancePercent,MinAmount,MaxAmount

Encounter 可为 GhostShip、Shipwreck、Smugglers、StormFront 或 All。例如：

Smugglers,Coins,100,40,90;All,CoreWood,25,2,6

每个预制体必须是服务器可用的物品。自定义数量限制在 1–100。

服务器命令

• oceanadventures_test_event ghostship|shipwreck|smugglers|stormfront 启动一个测试遭遇。
• oceanadventures_clear_events 清除活跃遭遇。
• oceanadventures_event_status 显示遭遇和冷却状态。
• oceanadventures_reward_status 将奖励详情写入日志。

请在可接受临时天气变化和遭遇奖励的世界中使用测试命令。