Rusty Heathens Mist Control

Control Mistlands visibility while you play. Open the in-game panel, hide or restore the mist, and choose how far your wisplight and wisp torches clear it.

Built for the Rusty Heathens community. Works in single-player and on modded multiplayer servers.

Features

• In-game controls: press F8 for the settings panel.
• Quick mist toggle: Left Shift + F8 hides or restores Mistlands mist.
• Separate clearing ranges: adjust equipped wisplights and placed wisp torches independently, from 5 to 60 meters.
• Server-controlled settings: server admins apply changes for everyone using the mod; regular players have a read-only panel.
• Saved settings: changes made through Apply are saved on the host/server and synced to connecting players.
• Reversible: switch off custom settings to restore original ranges and normal mist rendering. No world mist objects are deleted.

Installation

Install BepInExPack Valheim and RustyHeathensMistControl using your mod manager, then start the game modded.

For multiplayer, install the same mod version on the server and every player who should receive the mist changes. Restart the server once after installation. Settings can then be changed in-game without restarting.

For manual installation, place RustyHeathensMistControl.dll in:

BepInEx/plugins/RustyHeathensMistControl/

If you installed the earlier manual test build, remove that manually installed DLL before installing the mod-manager package. Keep just one copy of Mist Control. Your existing Mist Control config can stay.

No Jotunn, external ServerSync, or other Rusty Heathens mod is required.

Controls

Default settings

The sliders adjust mist clearance, not illumination brightness. When all mist is hidden, radius differences will not be visible. Restored mist may take a few seconds to fill back in as the game creates new particles.

Server admins and configuration

Single-player and listen-server hosts can edit settings. Dedicated-server changes require a player recognized by Valheim's adminlist.txt. The server checks the sender's connected account before accepting a change.

Admin lists maintained only by other mods do not automatically grant access here. Add your admins to Valheim's real admin list as needed.

Config file:

BepInEx/config/com.rustyheathens.mistcontrol.cfg

The host/server's settings are authoritative. Settings received from a server do not overwrite the client's local configuration. A multiplayer client that cannot sync with the server falls back to original behavior and cannot apply local overrides. Players without this mod retain their own game behavior; this mod does not enforce installation or kick players.

To change local keyboard shortcuts, close the game, edit the config's [Controls] section, and restart:

[Controls]
PanelShortcut = F8
ToggleShortcut = F8 + LeftShift

Rusty Heathens ModGuard

If your server uses ModGuard, add this exact plugin ID to its AllowedForPlayers list:

com.rustyheathens.mistcontrol

This allows regular players to load the mod. Editing its server settings still requires admin permission. Restart after changing ModGuard's server policy.

Compatibility and behavior

• Only Mistlands particle mist is hidden. Ordinary weather fog, smoke, and rain remain.
• Mistwalker and dvergr lantern ranges are not changed.
• Avoid using another mod that changes the same mist or wisp ranges at the same time.
• Original field values are captured when first encountered. With another range mod installed, those values may already contain its adjustments.
• Hiding mist is visual: mist volumes remain in the world and enemy concealment checks are not deliberately disabled. Enlarging native clearing fields can affect game checks using those fields.
• Higher radii may cost more performance, especially around many torches.
• The panel uses keyboard and mouse controls; no separate controller binding is included.

Troubleshooting

F8 does not open the panel: make sure the mod is installed in the active profile, launch the game modded, spawn into a world, and close chat, inventory, map, shop, and console screens. Check for a shortcut conflict.

Panel is read-only: check the server's adminlist.txt. Being an admin in another mod alone is not sufficient.

Panel is waiting for the server: install the same version on the server, restart it, and reconnect.

A change was refused after another admin edited settings: review the refreshed values and Apply again.

For a bug report, include your game version, mod version, whether the issue occurred on the server or client, and the relevant BepInEx/LogOutput.log excerpt. Include a screenshot for a panel issue.

Credits

Created for RustyHeathens / RustyLaserGaming. Code and package artwork were developed with AI assistance. Version 0.1.0 was reported working in-game by RustyLaserGaming before this public package was prepared.

Changelog

0.2.1 — 2026-10-14

• Replaced low-contrast helper text with bright white text and dark outlines.
• Lightened blue headings and increased helper text size.
• Kept read-only labels readable while leaving controls locked.
• Preserved the wooden panel, brightness behavior and v2 sync protocol.

0.2.0 — 2026-10-14

• Integrated gamma-style ambient brightness into the existing F8 controls.
• Added Natural, Soft (35%) and Clear (60%) brightness presets and a 0–100% slider.
• Synced brightness settings with the same server-admin authorization and persistence as mist controls.
• Added an inventory-style wooden panel, Rusty Heathens emblem and electric-blue selection highlights.
• Preserved mist settings, plugin identity, F8 and Shift+F8 shortcuts.
• Added color/alpha preservation, zero-input protection and lighting restoration.
• Updated the sync protocol; server and clients must all use 0.2.0.
• Prevented simultaneous loading with the standalone ColdSpirit.GammaMod.
• Included GPL-3.0 license, attribution, full source and build/test instructions.
• Compilation and automated tests passed; in-game validation remains pending.

0.1.0

• Initial Mistlands visibility and wisplight/torch range controls.