Seasons

Seasons

Four customizable seasons.

Seasons changes Valheim through spring, summer, fall and winter. Each season can affect the world, weather, lighting, resources, creatures and character stats, while still keeping the vanilla game recognizable.

Conditional Config Sync

• Config values marked with [Synced with Server] are synchronized from the server by default. Most of them control whether an entire feature or section is enabled, while its visual presentation and formatting remain configurable by each client
• Server administrators can change the synchronization policy for policy-controlled settings in BepInEx/config/shudnal.ConditionalConfigSync/ConditionalConfigSync.SyncPolicy.cfg
• Prefix an exact setting or whole-section identifier with + to force server control or - to make it client-controlled. Exact-setting rules take precedence over whole-section rules
• Use shared modpack configs or distribute your config manually if you also want client-controlled appearance and formatting settings to be identical for all players initially
• Seasons must be installed on the server and every connecting client
• The current season and day, seasonal JSON settings, generated runtime data, and settings that affect shared world state or networked physics are always controlled by the server and cannot be made client-controlled through the synchronization policy
• Settings without [Synced with Server] are client-controlled by default, but a server administrator can still force them to be server-controlled through the synchronization policy
• If you install this mod manually do not forget to install ConditionalConfigSync

If you experience FPS issues

If you notice FPS drops, your GPU might handle more. Try adding these launch options:

-gfx-enable-gfx-jobs -gfx-enable-native-gfx-jobs

in Valheim's launch options on Steam.

This unlocks more GPU power for the game, which might help. It is more convenient than editing the boot.config file and is safe to try.

If you use the RenderLimits mod and have the "Distance area" setting higher than 10, it may cause noticeable FPS loss in areas with many trees. This cannot be further optimized with modding tools alone.

What can be customized per season

• Environments: add new weather types, modify weather properties, or remove weather.
• Random events: adjust event frequency, remove events, or change biome restrictions.
• Lighting: control luminance, fog density for different times of day and indoors.
• Stats: modify regeneration rates, stamina usage, skill levels, skill gain speed, damage modifiers, and more.
• Seasonal settings: adjust season length, night length, production rates, and other multipliers.
• Trader items: add seasonal trader inventory to balance resource availability.

Configuring the mod

The mod uses general settings through BepInEx configuration.

Custom settings

Custom seasonal settings are defined using JSON files.

The mod creates a shudnal.Seasons directory inside the BepInEx config folder. This is where default and custom settings are stored.

Default settings

On each world load, the mod generates a Default settings folder containing files with default values.

BepInEx\config\shudnal.Seasons\Default settings

You need to launch the world at least once after installing the mod to generate these default files.

Important: Do not edit files inside the Default settings folder directly. Any changes will be overwritten the next time you load a world or update the mod.

How to create custom settings

To create custom seasonal settings:

1. Open the folder:

   BepInEx\config\shudnal.Seasons\Default settings

1. Copy the file you want to edit (e.g., Winter.json).
2. Paste it into the main shudnal.Seasons config folder:

   BepInEx\config\shudnal.Seasons\

1. Edit the copied file as needed.

If your changes are applied, you will see this message in the BepInEx console or LogOutput.log:

[Info   :   Seasons] Settings updated: Winter

Note: For the seasonal files such as Winter.json, omitted properties use their built-in values. Seasonal snow.json is different: it replaces the entire snow rule set. Missing piece or material rules are not copied from the default file.

Seasonal snow rules

Seasonal snow.json controls snow behavior for individual building pieces and snow-cover ranges for creature materials and player capes. General snow switches, buildup limits and melting multipliers remain in the BepInEx configuration.

Copy Default settings/Seasonal snow.json to the main shudnal.Seasons folder to customize it. The override file replaces the complete built-in rule set. When connected to a server, the server file replaces both local defaults and the local override. An empty object {} means that no individual rules are configured. Remove the override file to return to the built-in defaults. Changes reload while a world is running.

Pieces

The keys in pieces are prefab names. Each piece can use these fields:

• buildup: Snow processing mode. Seasonal uses normal seasonal buildup, Reduced uses the reduced buildup limits, Ignore leaves the piece outside Seasons snow processing, and Disabled forces snow buildup to zero and keeps its snow caps disabled. If omitted, Seasonal is used.
• copyFrom: Prefab whose main snow cap is copied when the target piece has no snow cap of its own.
• position: Local snow-cap position override. x, y and z are optional; omitted axes keep their original values.
• scale: Local snow-cap scale override. x, y and z are optional; omitted axes keep their original values.

"stone_fence": {