balrond shipyard

⛵ Balrond Shipyard – Mod Documentation

Overview

Balrond Shipyard expands Valheim’s naval gameplay with new ships, ship upgrade systems, custom crafting stations, waterproof shipyard building pieces, a Fishnet Trap, and a collection of sailor-themed items.

The current release includes a full ServerSync-backed configuration system for ship recipes, station recipes, every ship-upgrade schematic recipe, cargo inventory dimensions, per-ship base physics/stat profiles, and configurable Oars behavior.

> Ship upgrades are handled through Schematics crafted at the Scribe’s Table and applied at the Shipyard station.

---

⚠️ Important Warnings

• Major update warning: versions 1.3.0 and 1.4.0 introduced large ship and cargo changes.
• Before updating, empty your ship inventory if possible to reduce the risk of item loss.
• If you change a ship's inventory width or height, empty that ship first and reload/re-enter the world after changing the config so the container can be recreated safely.
• If you are upgrading a ship, keep only the intended ship close to the Shipyard station to avoid the wrong ship being detected.
• Ship-stat configuration in 1.8.0 changes the base values used by supported ships. Extreme physics values can make a ship unstable; change propulsion, damping, mass, steering, and sail-force offset carefully.

---

🧰 Key Features

• 🚢 Three New Ships

Adds Knarr, Holk, and Snekke alongside support for several vanilla ships.

• 🛠️ Two Crafting Stations
• Scribe’s Table – used to craft ship Schematics.
• Shipyard – used to apply upgrades by placing a schematic into the station and pulling the lever.

• ⚓ Ship Upgrade System

Ships can receive thematic upgrades such as Shields, Lamp, Anchor, Tent, Armor, Oars, Ropes, and Nameplate, depending on the vessel.

• 🎨 Visual Ship Customization

Supported ships can use multiple sail colors/patterns, shield patterns, and ship-specific visual swaps. Applying a different sail schematic replaces the currently selected sail appearance.

• 🌊 Water-Resistant Building Set

Includes a shipyard-themed set of structural build pieces designed to resist water and rain damage.

• 🎣 Fishnet Trap

A placeable fishing structure that can catch biome-appropriate fish more effectively when supplied with the correct bait.

• 🧳 Expanded Ship Utility

Cargo sizes, attach points, comfort behavior, and several ship functions are expanded or adjusted depending on ship type.

• ⚙️ Server-Synchronized Configuration

Ship recipes, Shipyard/Scribe’s Table recipes, all schematic recipes, cargo dimensions, base ship statistics/physics, and Oars behavior are configurable and synchronized through ServerSync.

• 🚤 Per-Ship Base Stat Profiles

Supported ships can independently configure base health, mass, sail/paddle force, steering, damping, impact damage, Ashlands readiness, and weather-wear behavior without replacing Shipyard upgrade bonuses.

---

🔧 How to Use

1. Craft a Scribe’s Table.
2. Create a Schematic for the ship extension or customization you want.
3. Build the Shipyard station.
4. Place the schematic into the Shipyard container.
5. Dock the target ship as close as possible to the Shipyard.
6. Pull the lever on the Shipyard to apply the upgrade.

Notes

• If more than one valid ship is within range, the first detected compatible ship may be upgraded.
• If a ship already contains a non-replaceable upgrade, the station may try to detect another valid ship nearby.
• Sail color/pattern upgrades are replaceable: applying another valid sail schematic changes the current sail appearance.
• Best practice: keep all other ships away and dock only the ship you want to modify.
• Extensions work for vanilla ships and the custom ships added by this mod.

Raft is excluded from the general extension system, but it has its own default bag extension.

---

⚙️ Configuration & ServerSync

Balrond Shipyard creates its configuration file after the mod is loaded:

BepInEx/config/balrond.astafaraios.BalrondShipyard.cfg

The current configuration uses the following groups:

• 1 - General
• 2 - Ship Recipes
• 3 - Station Recipes
• 4 - Schematic Recipes
• 5 - Ship Inventory
• one 6 - Ship Stats - <Ship> section for each supported ship
• 7 - Ship Upgrade - Oars

1 - General

Lock Configuration

• 1 – the server/host configuration is authoritative for synchronized gameplay settings.
• 0 – synchronized settings are not server-locked.

For multiplayer and dedicated servers, keeping this at 1 is recommended so every client uses the same gameplay configuration.

Allow Ships To Be Destroyed Using Hammer

• true – supported ships can be dismantled with the Hammer Remove action.
• false – Hammer Remove is disabled for supported ships.

This setting is local only. It is intentionally not synchronized through ServerSync and is not controlled by Lock Configuration.

2 - Ship Recipes

Construction recipes can be configured independently for:

• Raft
• Karve
• Knarr
• Snekke
• Longship
• Holk
• Ashlands Drakkar

Recipe format:

Prefab:Amount,Prefab:Amount

Example:

FineWood:30,BronzeNails:90,LeatherScraps:16,DeerHide:10,CoalPaste:20

The Raft uses default by default, which keeps its normal Valheim recipe. It can still be replaced with a custom recipe.

Invalid recipe strings fall back to the mod's built-in/default recipe instead of silently creating an incomplete recipe.

3 - Station Recipes

The construction costs of both custom stations are configurable: