ValheimRAFT

A ValheimRaft fork that works with latest Valheim. The original mod owner Sarcenzzz stopped maintaining the mod.

As of 12/25/2023 I got official permission to maintain and open source this mod.

This decompile fork aims to keep the mod functional with future goals of expanding functionality.

Build Status

Contents

• ValheimRAFT
  • Build Status
  • Contents
  • Client/Server/SinglePlayer Support
  • Features
  • Community
  • Config
    • Meshes
  • Issues
  • Mod Support
  • Contributing
  • Support Open Source
  • Getting Started

Client/Server/SinglePlayer Support

Server support may or may not work. In >=1.6.2 ships and loading were mainly fixed by adding some threading optimization. There is also a config called ServerRaftUpdateZoneInterval this allows users to tweak the update frequency of checks.

The following has been tested:

• SinglePlayer
  • boats will load
  • FPS issues with giant ships
• Client only with a server IE (connecting to server without mod),
  • creating a boat and logging on and off the server does not destroy the boat.
  • sailing and teleporting does not destroy the boat.
  • The client will still be able to create items and the server will keep those raft items. (unless you have mods that garbage collect unused ZDOs)
  • restarting/stopping/starting server keeps the boat.
  • Removing the ValheimRAFT mod from the client will make the server glitch out the boat items.
  • joining back (after adding the mod again) will render the items correctly.
  • Loading a ship into view will possibly
• Server & Client
  • Loading a 4500 build plan ship. Traveling around a couple sectors. The ship remained as built.
  • Moving away from the ship until it unloaded. Moving back immediately and attempting to land on the ship while it renders. It works and still loads. Looks a bit funny as it spawns.
    • Warning to anyone that builds property next to a large ship, when it renders it's possible a wave could briefly flip it and the top part of the ship rolls and hits property.

Features

• Build a RAFT on the water using Valheim's building prefabs.
• Adds a climbable ladder
• Add piers that reach the ocean floor (stone and log)
• Adds anchors
• Adds custom sails (requires meshes to be working)
• Adds ropes (requires meshes to be working)
• Sails now will each contribute to the total ship speed. Mesh sails do an area calculation while tier1-3 sails are preset values.

Community

Join us on discord to get the latest information, upcoming features, and discover other mods.

Discord Link

Config

Meshes

In Mod versions at or lower than 1.4.9 there were problems with the folder being renamed. In >=1.5.0 there is a configuration manager option to change the path to resolve the ValheimRAFT folder.

If you want meshes (IE sails and ropes ) to render automatically, your mod must either be named ValheimRAFT or zolantris-ValheimRAFT.

Otherwise make sure to edit the pluginFolderName key and add the folder name for ValheimRaft located within the BepInEx\Plugins path. Afterwards relaunch the game. There should be no mesh issues.

Issues

If you have a bug, please create an issue under the repo's issues section.

• Please respect the form. Adding the relevant information makes it easier to triage the problem.

Click here to create an issue now.

Mod Support

In 1.6.0+ this mod supports PlanBuild a popular blueprinting mod.

Support is added via a patch that makes PlanBuild use the Raft localPosition instead of world position which each item could be moving/swaying and updating as the PlanBuild iterated through the items. This easily breaks the Plan save.

• Hopefully this logic can be incorporated within PlanBuild directly. There is a config toggle to turn this patch off to future proof things.
• Alternative approaches for this could be doing a detection if the game object is attached to a parent object and calculating coordinates of the items after all object positions have been fetched.

Noting that Planbuild does not register well with harmony so searching for it is not possible (from what I saw). There is a path resolution and a config flag to enable coordinate fixes. Disable the config value fixPlanBuildPositionIssues and it should not longer cause errors for not having PlanBuild installed.

Contributing

1. Please fork the codebase and make a pull request via your fork branch.
2. Changes need to be feature based IE keep the changes minimal and single focused. Larger changes are welcome, but they have higher chance of breaking other things and are harder to maintain.
3. If you want to directly get involved. Reach out on discord.

Support Open Source

Please reference the getting started docs.

Changelog

All notable changes to ValheimRAFT are documented here. For full commit history see the GitHub Releases page.

[4.2.2] - 2026-03-14

Fixed

• ensure that sails request a sync to other peers
• ensure peers can send a message that sail has been updated.
• ensure sail data is not corrupted
• ensure a failed claim of a sail can be recalled to request ownership.

[4.2.1] - 2026-03-14

Fixed

• fixes a constant stutter issue with valheim raft on non-dedicated servers and likely fixes dedicated server stuttering. Issue introduced in 4.2.0 with server sync fixes
• ensure that syncs only happen on vehicles for servers within 250 unit radius of an active player. This ensures only active vehicles are force synced to these positions.

[4.2.0] — 2026-03-13

Added

• Vehicle Name field — set a custom name per-vehicle, saved to ZDO and shown on the minimap pin as V:<name>.
• Custom minimap pin icons for all vehicle types (water, land, air) sourced from the asset bundle.
• AddTextInputRow UI helper — reusable TMP input field that scales to its container, with onChanged and onEndEdit callbacks.
• Documentation overhaul — new tutorials for Basics, Cannons, Power System, and a Changelog.

Fixed

• Map pin sync stability improvements and NRE guards on server reconnect.
• Vehicle config panel input text rendering white-on-white (was inheriting label colour instead of input text colour).
• Server sync and GUI inconsistencies across clients.

[4.1.3] — 2025-12-04

Fixed

• Archive step in the release build pipeline.

[4.1.2] — 2025-12-03

Fixed

• Optimised HumanoidOnAttackTrigger patch to better support external mods that hook the same method.
• Versioning chores and dependency bump to Jotunn 2.27.

[4.1.1] — 2025-10-20

Fixed

• Sail normals rendering incorrectly on some mesh variants.
• Flight stability issues when sails were attached to a flying vehicle.

[4.1.0-beta.1] — 2025-10-14

Added

• Vehicle chunk boundary limits — constrain the physics bounds of a vehicle to a defined area using Boundary Chunk Addition prefabs.

[4.0.4] / [4.0.3] — 2025-10-12

Fixed

• Removed the 4×4 Dirt Planter prefab which was accidentally included in the release build.

[4.0.2] — 2025-10-12

Added

• Vehicle boundary safety — prevents hull collision bounds from expanding dangerously when pieces are placed at extreme offsets.

[4.0.1] — 2025-10-03

Fixed

• Unity 6 compatibility for Water Vehicle ships and Air Vehicles.

[4.0.0] — 2025-08-25

Added

• Full Unity 6 compatibility pass across all vehicle types.
• Power System: Eitr Power Generator, Eitr Power Storage (battery), Power Pylons (BETA), and Drain/Charge Activator Plates.
• Swivels — rotate or move any placed prefab using Mechanism Toggle triggers. Requires power by default.
• Mechanism Toggle (mechanism switch) — configure swivels, open the vehicle debug panel, and trigger docking sequences.

Changed

• Swivels now require a connected power network and charge to activate ( configurable).

[3.7.2] — 2025-08-24

Added

• Prefab naming snapshots — prefab names are now stable across saves.
• Various quality-of-life improvements to piece placement and snapping.

[3.7.1-beta] — 2025-08-16

Added

• New hull pieces and updated existing hull geometry.

[3.6.6] — 2025-07-31

Fixed

• Steering wheel not detecting the player when standing at certain positions.

[3.6.5] — 2025-07-30

Fixed

• Null reference exception on equip patch affecting some item interactions.

[3.6.4] — 2025-07-26

Added

• Cannonballs (solid bronze, explosive blackmetal) added to the items section.

Fixed

• Multiple stability fixes across the 3.6.x cannon release series.

[3.6.3-beta] / [3.6.1-beta.2] / [3.6.0-beta.1] — 2025-07-21

Added

• Fixed Cannons — mount to any vehicle or base. Controlled from the Steering Wheel on a vehicle or from the Cannon Control Center off-vehicle.
• Cannon Control Center (telescope) — fire-control station for fixed cannons. Manages all cannons within its discovery radius (default 15 units). Supports four directional groups (forward / port / starboard / aft).
• Handheld Cannon — mobile cannon with auto-aim mechanics. Fully multiplayer compatible.
• Cannonball ammunition — solid (piercing) and explosive (AoE blackmetal) variants.

[3.5.4] — 2025-07-03

Fixed

• Compile error in swivel stability changes.

[3.5.3] — 2025-06-24

Fixed

• Missing prefabs added back to the build.
• Scale of corner floor hull pieces corrected.

[3.5.2] — 2025-06-23

Added

• Improved vehicle docking — child vehicles now align anchor-to-anchor with lerp smoothing.
• Mast ZDO syncing across clients.

Fixed

• Sail mesh and rotation sync issues.

[3.4.3] — 2025-05-30

Fixed

• Eitr Drain Conduit multiplayer sync issues.
• Swivel multiplayer sync reliability.
• Power network logic sync across clients.

[3.4.0-beta.1] — 2025-05-10

Added

• Swivel GUI improvements — configure rotation axes, speed, and power requirements from a dedicated panel.
• Swivel rotators with visible connection lines.

[3.3.0] — 2025-04-29

Added

• Custom masts with crow's nest — tier 1–3 mast variants with a climbable crow's nest platform.
• Vehicle Save & Spawn system — save a vehicle blueprint to disk and spawn it later anywhere. See Vehicle Storage Tutorial.

[3.2.1] — 2025-04-28

Added

• Russian and Chinese Simplified translations.

[3.2.0] — 2025-04-28

Added

• Vehicle Hammer — dedicated build tool replacing the vanilla hammer for all ValheimRAFT pieces. All vehicle prefabs now live under its tabbed build menu.
• Custom floatation height per vehicle — set a fixed height or use the Floatation Prefab for per-vehicle control.
• Toggle switch persistence — mechanism switch state is now saved to ZDO.

Changed

• Removed V1 raft support. Use vehicle recover to migrate old V1 rafts.
• Custom floatation mode is now locked to local vehicles only to prevent sync bugs on shared ships.

[3.1.0] — 2025-04-04

Added

• Collision object parenting optimisations — large ships with many pieces load faster.

[3.0.8] / [3.0.7] / [3.0.5] / [3.0.4] — 2025-04-01

Fixed

• NRE in collection rebuild bounds on ship load.
• Convex hull optimisation — large ships compute collision bounds significantly faster.
• Valheim game update regressions.
• Land vehicle stability and tread rotation logic.

[3.0.0-beta] — 2025-02-01

Added

• Land Vehicle (tank) — wheeled/tread ground vehicle. Drive it overland or load it onto a water vehicle for transport.
• Tank tread rotation logic — treads animate based on vehicle velocity and turning.
• Boundary alignment tools for large vehicle builds.

[2.5.3] — 2025-01-20

Added

• Anchor HUD — shows anchor state on screen when near your vehicle.

Fixed

• Stability tweaks for anchor physics and multiplayer sync.

[2.5.0-beta.1] — 2025-01-12

Added

• Anchors — physically anchor the ship when the anchor touches the seabed or terrain. Synced across clients. Requires swamp-tier materials.
• Window Porthole walls and floors (2×2, 4×4, 6×4, 8×4 iron variants) — see through hull sections with half the health of solid iron pieces.
• New hull geometry: corner floors (2×2, 2×4, 2×8 left/right wood and iron).

[2.4.3] — 2024-11-30

Fixed

• Player control responsiveness tweaks while helming a vehicle.
• Ship lean cosmetics towards wind direction.
• Boat ownership transfer stability.

[2.4.2] — 2024-11-24

Fixed

• Water damping minimum and maximum values clamped correctly — ships no longer oscillate uncontrollably in rough weather.

[2.4.1] — 2024-11-11

Fixed

• Auto-ascend/descend logic for flying ships.
• Target height offset when flying causing incorrect vertical positioning.

[2.4.0] — 2024-11-10

Added

• Water ballast mass system — hull pieces affect buoyancy dynamically.
• Flight mode — vehicles can be made to fly using ballast controls.
• Vehicle map pins — vehicles now show on the minimap.
• Translocations (teleport vehicle to player position, admin only).
• Rope Ladder — climbable ladder that extends to the ground or seafloor automatically.

[2.4.0-beta.1] — 2024-11-09

Added

• Water mesh masking (water opacity bucket) — hide water inside or around a sealed hull to create submarine-like interiors.
• Dynamic location system for world-space vehicle placement.

[2.2.4] / [2.2.3] / [2.2.2] — 2024-08-25

Fixed

• Ship floatation logic regressions.
• Flying vehicle height and ballast stability.
• Sail asset and ladder tweaks.
• Hull piece sizing corrections.

[2.2.0] — 2024-07-06

Added

• Fully sealable hull — new rib, corner, prow, and seal pieces allow building a watertight ship.
• Yggdrassil iron reinforced prefab variants for hull walls and floors.

Fixed

• Rudder turning speed optimisations.
• Sail rotation, physics, and anchor behaviour tweaks.
• Many hull wall and floor collision bug fixes.

[2.1.1] / [2.1.0] — 2024-05-22

Fixed

• Sail 3-point mesh not rendering correctly.
• raftcreative rotation fix — no longer rotates the vehicle unexpectedly.
• Multiplayer RPC stability improvements.

[2.0.3] / [2.0.2] / [2.0.1] / [2.0.0] — 2024-05-17

Added

• V2 WaterVehicle — completely rewritten vehicle system with proper physics, ZDO syncing, and hull floatation.
• vehicle recover command — migrates V1 raft pieces to the new V2 system.
• Boarding Ramp — extendable ramp (1–50+ units) for boarding ships from the water or shore.
• Dirt Floor (1×1, 2×2) — grow vanilla Valheim crops on your ship.

Changed

• Plugin GUID changed from the original ValheimRaft GUID to zolantris.ValheimRAFT. Existing V1 ships must be recovered with vehicle recover.

Fixed

• ZDO logging spam on rope anchors removed.
• Multiplayer ship sync regressions from 2.0.x patch series.

[1.6.14] — 2024-01-21

Fixed

• Local server (LAN host) ship rendering on connecting clients.

[1.6.13] — 2024-01-20

Fixed

• Rendering regression introduced in 1.6.12 for locally hosted servers.

[1.6.12] — 2024-01-07

Fixed

• Nexus/Vortex folder structure install path.

[1.6.11] — 2023-12-30

Added

• Vulkan graphics API support (Windows and Linux).

Fixed

• Collider placement moved below the lowest deck to stop clutter items flipping the boat.
• Config options added for collider sensitivity.

[1.6.9] / [1.6.10] — 2023-12-30

Fixed

• Anchor now correctly stops a flying raft.
• Sail component NRE guards to prevent log spam.

[1.6.7] / [1.6.8] — 2023-12-29

Added

• Boat size-based sailing calculations — larger ships are proportionally faster.
• Admin-only build mode config option.

Fixed

• Thunderstore folder structure for manual installs.

[1.6.5] / [1.6.6] — 2023-12-27

Fixed

• Sail mesh generation errors.
• Rope anchor duplicate WearNTear NRE spam.

[1.6.4] — 2023-12-26

Added

• Sail area calculations — sail speed is now based on the cubic volume of each sail.

[1.6.3] — 2023-12-24

Fixed

• Stable dedicated server and client raft rendering.

[1.6.2] — 2023-12-21

Fixed

• Server stability for zone-based raft updates.
• Plugin patch compatibility fixes for mods hooking ValheimRaft classes.