
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.3 (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+, and denikson-BepInExPack_Valheim-5.4.2350+.
☕ 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 mechanicsNot 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.
- 1.0 Compatibility Update: Because Zolantris has been inactive for several months while Valheim 1.0 broke existing builds, this fork was created by JNDEV0 to address engine breakages introduced by the Valheim 1.0 / Unity 6 update, ensuring the mod remains accessible and functional for the community.
- Telemetry Removed: Unused external telemetry wrappers (such as Sentry tracking) and leftover debug spam hooks have been audited and removed/disabled, ensuring clean, local, offline-friendly execution.
Licensed under the GNU General Public License v3.0 (GPLv3).
🎮 Controls Quick Reference
| Action | Control (Default) |
|---|---|
| Take Helm / Steer | Press E at Steering Wheel |
| Forward / Increase Speed | W (1 = Slow / Rudder, 2 = Half Sail, 3 = Full Sail) |
| Reverse / Decrease Speed | S |
| Turn Rudder | A / D |
| Ascend / Fly Up | Spacebar ("Jump") |
| Descend / Ballast Down | Ctrl or C ("Crouch") |
| Drop / Raise Anchor | Left Shift ("Run") |
| Interact / Open Mechanism UI | Press E on Mechanism Toggle Switch |
| Pause Game (Single Player) | Esc |
📥 Installation
Option A: Thunderstore / r2modman / Gale (Recommended)
- Search for ValheimRAFT in your mod manager and click Install with Mod Manager.
- Launch the game through your mod manager.
Option B: NexusMods / Vortex / Manual Installation
- If using Vortex, install and enable the zip archive directly.
- If installing manually, extract
plugins/ValheimRAFTinto yourValheim/BepInEx/plugins/directory:Valheim/ └── BepInEx/ └── plugins/ └── ValheimRAFT/ ├── ValheimRAFT.dll ├── ValheimVehicles.dll ├── Zolantris.Shared.dll ├── ZdoWatcher.dll ├── DynamicLocations.dll ├── Assets/ └── docs/
📦 Requirements & Dependencies
To use this mod, ensure you have the following required dependencies installed:
- denikson-BepInExPack_Valheim-5.4.2350 (or newer)
- ValheimModding-Jotunn-2.30.0 (or newer)
🛠️ 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