
You are viewing a potentially older version of this package. View Latest Version
ValheimRAFT
ValheimRAFT - Build custom rafts, ships, and vehicles with physics, sailing, and flight. Updated and fixed for Valheim 1.0.12 (Unity 6).ValheimRAFT v4.3.4 (Valheim 1.0.12 Compatibility & Polish Update)
ValheimRAFT build custom movable rafts ships and movable bases in Valheim. Expand your vessels with standard building pieces, drop anchors, navigate the open seas, and take flight!
Update ValheimRAFT for Valheim 1.0.12, ValheimModding-Jotunn-2.30.0+, denikson-BepInExPack_Valheim-5.4.2350+, and ValheimModding-JsonDotNET-13.0.4+.
☕ Support
enjoy, and you can donate at Ko-fi:
☕ Support JNDEV0 on Ko-fi (https://ko-fi.com/jndev0)
⚠️ Important "As-Is" Disclaimer
- This fork was created to make ValheimRAFT playable again following Valheim's 1.0 release (Unity 6 engine upgrade).
- Core features have been tested mainly for single-player: vehicle piece building, floating/sailing, sail propulsion, anchor toggling, flying, ballasting, smooth water landing transitions, steering wheel doodad control, and world saving/loading.
- ValheimRAFT is a massive and complex codebase containing advanced mechanics. Not all extended features or edge-case interactions have been exhaustively tested.
- Offered "As-Is": Provided freely and without warranty. Always back up your character and world saves before testing! Players and modders are warmly invited to report issues, bugs, submit suggestions or Pull Requests, and help maintain this mod at the GitHub repository: 👉 https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12
📜 Attribution & Open Source History
- Original Creator: Sarcen created the original ValheimRAFT mod that defined ship building in Valheim, and generously released it as open source in 2023 under the GPLv3 license.
- Modern Rewrite & Architecture: Zolantris (zolantris/ValheimMods) completely overhauled the mod's architecture, adding modular vehicle systems, convex hull boundary physics, and expansive features.
📥 Installation
Option A: Thunderstore / r2modman / Gale (Recommended)
- Install via your mod manager of choice.
- Dependencies are automatically resolved and installed.
Option B: NexusMods / Vortex / Manual Installation
- If using Vortex, install and enable the zip archive directly.
- If installing manually, extract
ValheimRAFTinto yourValheim/BepInEx/plugins/directory:Valheim/ └── BepInEx/ └── plugins/ ├── ValheimRAFT/ │ ├── ValheimRAFT.dll │ ├── ValheimVehicles.dll │ ├── Zolantris.Shared.dll │ ├── ZdoWatcher.dll │ ├── DynamicLocations.dll │ ├── ServerSync.dll │ └── Assets/ │ └── Translations/ │ └── English/ │ └── valheimraft.json └── Newtonsoft.Json.dll (from ValheimModding-JsonDotNET)
📦 Requirements & Dependencies
To use this mod, ensure you have the following required dependencies installed:
- denikson-BepInExPack_Valheim-5.4.2350+
- ValheimModding-Jotunn-2.30.0+
- ValheimModding-JsonDotNET-13.0.4+
🚀 Changelog (v4.3.4)
Steering Wheel & Helm Controls
- Refined Hover Interaction Text:
- Overhauled steering wheel tooltip to clearly state:
[Shift] Toggle Anchor[Jump] and [crouch] adjust elevation/depth[jump]+[crouch] toggle float/flight
- Removed outdated divider lines, obsolete tutorial hints, mass displays, and debug prompts for a clean, immersive interface.
- Overhauled steering wheel tooltip to clearly state:
- Treadmill Animation & Weapon Holstering Fix:
- Fixed the character running in place on a "treadmill" while mounting the steering wheel if entering it while moving.
- Automatically holsters equipped weapons and shields upon taking the helm so the player stands/crouches cleanly with both hands on the wheel.
Rope Ladder Ergonomics
- Instant Auto-Climb by Default:
- Defaulted rope ladder movement to automatic fast climb without requiring manual toggling.
- Cleaned up hover interaction text by removing unnecessary mode toggle prompts.
Collision Damping & Shoreline Physics
- Rock Impact Damping & Anti-Stutter:
- Fixed the boat acting like an unstoppable power-drill bulldozing shoreline rocks and freezing the game with collision log flooding.
- Added dynamic collision impulse damping: forward velocity is smoothly diminished exponentially upon hitting rocks and a gentle reverse rebound velocity is applied.
Save-Cleanup Protection & Teleport Piece Sync
- Save-Cleanup Poisoning Shielded:
- Shielded
ZDO.ResetandRemoveZDOhooks from being wiped out by Valheim Ashlands+ save cleanup cycles (SaveCleanup). - Active world ZDOs are preserved in memory during world saves, preventing all ship pieces from disappearing from
m_allPiecesand_zdoGuidLookup.
- Shielded
- Vanilla Piece Loading on Boat Teleport Fixed:
- Fixed an issue where beds, chests, crafting tables, walls, and vehicle portals remained invisible when teleporting to a ship in float mode.
- Added universal sector migration for all piece types in
ZDOMan.instance.m_objectsBySectorand portal objects inm_portalObjects. - Fixed bed map pin desyncing to stale chunk locations by updating bed world positions and sectors even when the bed GameObject is unloaded.
- Added self-healing piece scanner (
EnsurePiecesForVehicle) to guarantee piece recovery fromZDOManunder any condition.
- Pre-Teleport Piece Sync & Piece Breakdown Logging:
- Synchronizes all piece coordinates and sectors prior to portal arrival.
- Categorizes pieces and logs counts to Unity console and on-screen HUD (top left):
[BoatPortal] Destination Vehicle ID {id} at {pos}: Found {total} pieces ({raftCount} ValheimRAFT, {vanillaCount} Vanilla, {modCount} OdinArchitect/Modded). - Ensures all child GameObjects are fully instantiated before the teleport loading screen completes (
[BoatPortal] Completed teleport to Vehicle {id}. Loaded pieces: {loaded}/{total}).
Clean Packaging & Mod Hygiene
- Decoupled Newtonsoft.Json:
- Removed bundled
Newtonsoft.Json.dllfrom the mod distribution in compliance with modding guidelines; added official dependency onValheimModding-JsonDotNET-13.0.4.
- Removed bundled
- Trimmed Obsolete Assets & Docs:
- Removed legacy
docs/folder and disabled custom sail texture directories (Assets/Logos,Assets/Patterns,Assets/Sails).
- Removed legacy
- Cleaned Issue Templates:
- Removed obsolete references to
YggdrasilTerrainfrom GitHub issue templates.
- Removed obsolete references to
🚀 Changelog (v4.3.3)
Portal & Fast Travel Overhaul
- Boat-to-Land Portal Routing Fixed: Resolved a critical issue where walking through a portal on a boat would teleport the player to the center of the boat instead of the connected land portal.
- Fixed piece placement logic in
Player_Patchthat was accidentally parenting shore/land portals to nearby vehicles (MBParentId). - Added terrain and placement distance validation to ensure ground and land structures never attach to vehicles.
- Cleared raycast piece cache (
PlayerLastRayPiece) on placement to prevent stale vehicle references from leaking into subsequent builds. - Fixed
VehiclePiecesController.ForceUpdateAllPiecePositionsfrom overwriting boat and land portal coordinates to the vehicle root. - Optimized
Teleport_Patch.DebouncedTeleportCoordinateUpdaterto immediately complete for land destination portals without unnecessary 10-second timeout delays or fallback drag-backs. - Added an automatic healer in
VehiclePiecesController.ActivatePiecethat detects existing misplaced land portals and unbinds them from vehicles back to true world coordinates.
- Fixed piece placement logic in
Bed Spawn Point & Ship Ownership
- Respawn on Moving Ships: Fixed bed spawn points on ships so players respawn cleanly on their bed on the vehicle instead of falling into the ocean or defaulting to the world spawn point.
- Vehicle Ownership Persistence: Resolved vehicle ownership issues during world load and player login so vehicles remain interactive and responsive across sessions.
Flight Modes & Propulsion
- Dynamic Flight Modes: Added distinct flight dynamics:
- Airship / Hover Mode: Controlled vertical lift with neutral buoyancy.
- Airplane Mode: Aerodynamic pitch, roll, and forward momentum.
- Float / Water Mode: Standard aquatic hull buoyancy.
- Universal Anchor Toggle (Shift Key): Shift toggles the vehicle anchor in all movement and flight modes, regardless of whether a physical anchor piece is attached.
Map & Navigation
- Dynamic Minimap Icon: Vehicle map icon now switches dynamically between ship, airplane, and vehicle indicators based on the current active flight/water mode.
- Vehicle Renaming Support: Added default naming and renaming support to prevent vehicles from being stuck as
V:Unnamed.
🚀 Changelog (v4.3.2)
Stability & Multi-Zone Loading
- Fast Travel / Portal Desync & Separated Parts Fixed: Fixed a critical issue where portaling away from or loading near a ship caused pieces to detach, separate, or throw null references. Added safety timeouts and zone load checks to
Teleport_Patch, protected vehicle pieces inWearNTear_PatchandVehiclePiecesControllerduring sector initialization, and disabled violent origin recentering on teleport transitions. - FixedJoint & Rigidbody Removal Error Fixed: Resolved the Unity error
Can't remove Rigidbody because FixedJoint depends on itinTargetControllerandVehiclePiecesControllerby guaranteeing all attached joint dependencies and connected bodies are cleanly unhooked and destroyed before Rigidbody removal. - Multiplayer Session Initialization Guard: Protected world UID lookups during player join/connect in
ZNet_WorldSession_Patchesbefore the remote server sends the world profile. - Corrected ZDO.Load Harmony Signature: Updated patch signature for
Zdo_Patchto match Valheim 1.0.12 / Unity 6Version.Worldparameter changes.
Sails, Propulsion & Visuals
- Dynamic Sail Furling & Unfurling: Sails now realistically furl and unfurl according to movement state:
- Anchored, Stop, or Speed 1 (Rowing): Sail is fully retracted/furled.
- Speed 2 (Half Sail): Sail extends to 50% height.
- Speed 3 (Full Sail): Sail extends to 100% full sail.
- Top-Down Sail Extension & Crossbeam Offsets: Corrected vertical sail scaling pivot so sails extend downward from the crossbeam rather than shrinking toward the deck. Added calibrated vertical offsets (
SailVerticalOffset = 1.05,KarveSailVerticalOffset = 2.15) for perfect alignment with Raft and Karve masts. - Minimum Sail Propulsion Enforced: Set a minimum baseline propulsion speed of
10(MinSailSpeed) so vessels with hulls move comfortably even with a single sail. - Storm Wind Velocity Capped: Lowered default
MaxLinearVelocityfrom 100 to 50 m/s to prevent uncontrollable runaway speeds and physics destabilization during severe storms. - Disabled Glitchy Sails & Masts from Hammer: Removed custom square sail, triangle sail, and custom masts 1-3 from the build menu to prevent physics glitches while keeping existing placed prefabs fully functional.
Usability & Quality of Life
- Automatic Rope Ladder Deployment: Rope ladders now automatically extend when the vessel is anchored, hovering, or stationary (
speed <= 0.01), ensuring swimming players can always climb back aboard without requiring manual anchor drops. Ladders retract cleanly during active flight or navigation. - Steering Wheel Anchored Alert: Attempting to move forward (W) or reverse (S) while the vessel is anchored now displays a floating yellow
"RAISE ANCHOR FIRST"alert directly above the steering wheel helm. - Font & Localization Improvements: Registered all active game fonts (AveriaSerifLibre, Norse) and dynamically generated Arial SDF Unicode fallbacks in
TMPProHelpersto prevent missing glyph errors. Cleaned up outdated foreign translation bundles and added missing localization keys. - Robust Mod Folder Detection: Rewrote
CustomTextureGrouppath resolution to automatically find mod assets across all mod managers (Thunderstore, r2modman, Gale, Vortex, manual installs).
🚀 Changelog (v4.3.1 Summary)
- Valheim 1.0.12 & Unity 6 Runtime: Fully recompiled and updated for Unity
v6000.0.75and Jotunn2.30.0. - Save & Logout Freeze Fixed: Fixed black screen hang when returning to main menu caused by
DontDestroyOnLoadonGame.instance. - Convex Hull & Collision Spam Silenced: Suppressed 0-point boundary warnings and disabled per-frame collision contact debug logging.
- Vanilla Esc Menu Restored: Single-player pause and smooth camera panning restored when pressing Esc.
- Centered Mechanism UI: Fixed coordinate math for Mechanism Toggle and Swivel UI menus.
- Tuned Sail Speeds & Flight Landing: Balanced sail speed factors and added smooth flight-to-water landing transitions.
💬 Community & Source Code
- GitHub Repository: https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12
- Upstream Repository: https://github.com/zolantris/ValheimMods
- Original Mod: ValheimRAFT by Sarcen
- Support JNDEV0 on Ko-fi: https://ko-fi.com/jndev0