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

• Craft a Scribe’s Table.
• Create a Schematic for the ship extension or customization you want.
• Build the Shipyard station.
• Place the schematic into the Shipyard container.
• Dock the target ship as close as possible to the Shipyard.
• 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 t