⚓ Njord — Master of the Sea

[!WARNING] CRITICAL CONFIGURATION UPDATE (v1.3.0) Njord v1.3.0 introduces a massive overhaul to default ship physics (acceleration, forces, sails) and entirely changes how the wind blending mechanics operate. You MUST delete your existing wubarrk.njord.cfg file and let it regenerate to experience these new balanced defaults! Check the Changelog for full details on what has changed!

A mythic overhaul of Valheim’s ship handling, steering, acceleration, and sea-faring experience. Njord makes boats feel powerful, responsive, and alive — without breaking Valheim’s soul.

🌊 Core Features

⚡ Responsive Steering

• Smooth, modernized helm control.
• Adjustable steering multiplier so your longship finally answers the helm.
• Steering gate prevents jitter on helm acquisition.

💨 Acceleration, Sail Forces & Max Speeds

• Completely overhauled default physics to provide a smoother, more realistic sailing curve.
• Configurable forward/reverse forces.
• Configurable Base/Half/Full sail behavior.
• Optional reverse-kick for tight maneuvering out of rocky harbors.
• Per-boat max speed configuration (Njord vs Vanilla).
• Full native support and config generation for OdinShip prefabs.

🌬️ Dynamic Wind Systems

• Instant Snap HUD: When grabbing the rudder, the Njord HUD instantly displays the true natural wind angle.
• **Toggle Full Wind Always On/Off
• [EXPERIMENTAL] Wind Assists: Advanced mechanics like Wind_NoDeadZone (nudge out of dead zones) and Wind_BlendToFull (blend toward tailwinds) can be opted-into via config to give you a mythic edge against the sea.
• Grace Period Mechanics: Natural winds are punishing. When the wind shifts against you, Njord enforces a realistic grace period (default 2.5s). You will feel the dead zone before any magical assists kick in to save you.

🧭 Njord HUD

• Clean, minimal, mythic HUD.
• Fully multiplayer-safe.
• Shows steering, speed, waterline, hull integrity, wind blend, and readiness.
• Drag to reposition freely on your screen.
• Toggle visibility instantly with F7.

⭐ Runic Wake VFX

• Optional glowing wake effect behind ships.
• Color-tinted based on your configuration.
• Scales with speed and sail state.
• Fully multiplayer-safe with zero performance impact on servers.

⚙️ Configuration

All major systems are configurable via BepInEx (wubarrk.njord.cfg):

• SteeringMultiplier
• AccelerationMultiplier
• BaseForwardForce / BaseReverseForce
• SailForwardForce / HalfSailForce / FullSailForce
• ReverseKick
• Wind System Toggles, Blend Rates, and Grace Periods
• MaxSpeed_Njord / MaxSpeed_Vanilla per ship type (including OdinShips)
• VFX_Enable & VFX_Color
• HUD position & toggle

🔄 Runtime Reload

Press F8 in-game to reload the config from disk without restarting Valheim!

• If triggered by a server admin, the server will instantly re-broadcast the updated physics values to all connected clients!

🛠️ Installation

1. Install BepInExPack for Valheim.
2. Drop the Njord folder into your BepInEx/plugins/ directory.
3. Launch the game.
4. Edit the generated BepInEx/config/wubarrk.njord.cfg as desired.
5. Press F8 to reload settings on the fly.

🤝 Compatibility

• Works flawlessly in singleplayer and multiplayer.
• Fully server-authoritative config sync architecture.
• Safe to install or remove mid-playthrough.
• No world changes or corrupted saves.
• Native OdinShip support.

🧪 Known Limitations

• Some MP config changes may require server restart depending on the host setup.
• VFX appearance may vary heavily when using modded water shaders.
• VFX emitters may appear at slightly inaccurate offsets on certain OdinShip prefabs.

🐉 Credits

Wubarrk — Creator, Architect, Myth-Weaver
AI Assistance — For accelerating development and refining complex systems
Njord — God of the Sea, who tolerates your steering
You — For sailing boldly into the storm

❤️ Support

If you enjoy Njord and want to support development:
https://www.patreon.com/cw/WubarrkDev

📜 License

MIT License — free to modify, extend, and sail with.