Njoror FairWinds

Njoror_FairWinds

Njoror_FairWinds is a lightweight mod designed to improve sailing with fair winds, ocean weather modulation, and sea serpent encounter controls.

About the Name: Njörðr

In Norse mythology, Njörðr (Njord) is the revered Vanir god of the wind, the sea, and prosperous seafaring voyages, prayed to by Vikings for favorable winds and calm waters. In this mod, Njörðr watches over your fleet—deflecting frustrating headwinds into fair sailing breezes, balancing oceanic storms, and regulating sea serpents.

Features

• Fair Winds & Headwind Mitigation: Intelligently deflects dead-ahead headwinds into tackable crosswinds or broad reaches while sailing.
• Minimum Wind Speed Scaling: Prevents dead calms from stalling voyages by guaranteeing a steady baseline sailing breeze.
• Ocean Weather Tuning: Dynamically modulates the frequency and duration of thunderstorms, rain, and clear skies.
• Sea Serpent Controls: Customizes encounter rates, spawn timers, and daytime serpent availability.

Installation Type

• Location: Must be installed on both the Server and the Client.
• Enforcement: Client versions must match the server version.

Manual Install

• Ensure BepInEx and Jotunn are installed.
• Extract the downloaded.zip archive.
• Copy Njoror_FairWinds.dll into your Valheim/BepInEx/plugins/ folder.
• Launch the game once to generate the default configuration file.

Configuration

The configuration file is automatically created at BepInEx/config/com.bigai.njoror_fairwinds.cfg after running the game once.

| Section | Setting | Default | Description |

|:--- |:--- |:--- |:--- |

| 1 - Fair Winds | EnableFairWinds | true | Enable fair winds while sailing aboard a ship. |

| 1 - Fair Winds | HeadwindMitigationPercent | 60.0 | Chance (%) to deflect a direct dead-ahead headwind into a tackable crosswind. |

| 1 - Fair Winds | MinimumWindSpeedMultiplier | 1.0 | Minimum wind velocity scaling factor (>1.0 ensures a steady minimum breeze). |

| 1 - Fair Winds | AlwaysTailwindInOcean | false | If enabled, ships sailing in the Ocean biome strictly receive tailwinds or broad reaches. |

| 1 - Fair Winds | CheckDeflectOnWindChange | true | Evaluate fair-wind deflection only when Valheim selects a new wind target. |

| 1 - Fair Winds | CheckDeflectTimeSeconds | 0 | When wind-change checks are disabled, re-evaluate fair winds at this interval (0 to disable). |

| 2 - Weather & Storms | EnableWeatherTuning | true | Enable dynamic modulation of ocean storms and atmospheric weather conditions. |

| 2 - Weather & Storms | StormFrequencyMultiplier | 1.0 | Multiplier for the frequency and duration of ThunderStorms (1.0 = Vanilla). |

| 2 - Weather & Storms | RainFrequencyMultiplier | 1.0 | Multiplier for regular rain and overcast conditions (1.0 = Vanilla). |

| 2 - Weather & Storms | ClearWeatherFrequencyMultiplier | 1.0 | Multiplier for clear, sunny weather frequency (>1.0 for more clear days). |

| 3 - Sea Serpents | EnableSerpentTuning | true | Enable custom encounter rate tuning for Ocean Sea Serpents. |

| 3 - Sea Serpents | DaytimeSerpentSpawnChance | 0.0 | Base chance (%) for a Sea Serpent to spawn during clear/calm Day conditions. |

| 3 - Sea Serpents | NighttimeSerpentSpawnChance | 5.0 | Base chance (%) for a Sea Serpent to spawn during Night hours. |

| 3 - Sea Serpents | SerpentSpawnIntervalSeconds | 1000.0 | Time interval (seconds) between Ocean spawner serpent spawn checks. |

| 3 - Sea Serpents | AllowCalmWeatherDaySerpents | false | If true, Sea Serpents can spawn during daytime even when it is not storming. |

| 4 - Diagnostics | EnableDebugLogging | false | Enable detailed diagnostic logs in the BepInEx console. |

Controls & Commands

• Keybinds: None.
• Admin Commands: None.

Compatibility & Safe Removal

• Multiplayer: Must be installed on both server and clients with Jotunn.
• Save Integrity: Safe to add or remove mid-playthrough without affecting existing world or character saves.

AI Disclosure

I made this mod using AI. Most of the code in this