OceanAdventures

OceanAdventures

Set sail beyond the familiar coast. OceanAdventures adds server-authoritative sea encounters and personal voyages to Valheim, using the world, boats, creatures, weather, and materials already in the game.

It does not change world generation, the inventory, or the crafting interface.

Compatibility and assets

OceanAdventures keeps its changes scoped to its own encounters. It does not replace or rebalance other sea or encounter mods, or globally change how their ships and creatures behave. It is designed to run alongside other mods, though individual mod combinations may still affect compatibility.

In-game encounter visuals use vanilla Valheim assets and materials. The package includes no extracted game files or third-party asset packs. The mod icon is original artwork.

At sea

• Ghost ship: A spectral longship follows its own ocean course, slows for nearby sailors, and can be boarded and looted before it sinks.
• Castaway wreck: Search the floating wreck for marked cargo, return it, then open the salvage chest and choose what to take.
• Smugglers: Intercept a moving longship, defeat its crew, and loot the cargo from its hold.
• Stormfront: Sail a marked route through a server-started storm. Completing the route grants its reward automatically.

Free encounters can occur while sailing, even without an active contract. They award resources and valuables, never equipment. Each encounter can include only one valuable type. Rare nails and metal bars are limited to the character's known recipe progress.

Haldor's voyage contracts

Haldor offers three rotating personal contracts. Keep one active at a time; it does not expire and can be abandoned at the ledger. A temporary map marker points to the destination. Other players can help, but only the contract holder receives the guaranteed equipment reward.

Contract equipment is selected from the highest Vanilla recipe tier the character has learned. A contract has a small chance to award a second item or improve an item's quality by one level, within its normal limit. Shipwreck and Smuggler rewards are placed in a chest or hold for manual looting.

Install

Install BepInEx for Valheim and Jötunn on the server and every player. Place OceanAdventures.dll in BepInEx/plugins/OceanAdventures/ on each machine. Everyone must use the same mod version. The server controls encounter spawning, contract progress, rewards, and world saves.

The mod uses a new configuration and save location. Existing settings and character/world profiles are not imported.

Configuration

The server configuration is BepInEx/config/com.oceanadventures.core.cfg.

Free Encounters

All event time settings are in minutes:

| Setting | Default | Meaning |

| --- | ---: | --- |

| MinimumWaitAfterEventMinutes | 10 | Minimum wait after one free event before another can start. |

| CheckForEventsEveryMinutes | 1 | How often the server checks for an event while a player is sailing. |

| EventChanceAtEachCheckPercent | 15 | Chance of an event starting at each eligible check. This is not a guaranteed timer. |

Contracts and rewards

Contract Range sets the minimum and base maximum distance for Calm, Balanced, and Harsh contracts. MaximumDistanceMultiplier increases the maximum distance up to five times. The server still searches for safe water and avoids land and obstacles.

Rewards controls the second contract item chance, quality upgrade chance, valuable-item chance, progress-material chance, extra item drops, quantity ranges, and the Smuggler resource bonus. By default, Smugglers pay 1.5 times the normal resource amount.

To add custom item drops, use CustomEncounterRewards with semicolon-separated entries in this format:

Encounter,Prefab,ChancePercent,MinAmount,MaxAmount

Encounter can be GhostShip, Shipwreck, Smugglers, StormFront, or All. For example:

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

Each prefab must be an item available to the server. Custom amounts are limited to 1–100.

Server commands

• oceanad