Skip to content

Configuration

brkihel edited this page Sep 26, 2026 · 4 revisions

Configuration

World modifiers and access lists

During installation, expand World modifiers to choose combat difficulty, death penalty, resources, raids and portal rules. After installation, use Jarl → Server Config. On an existing world, Gerenciar modificadores pelo Jarl starts off so saved settings are preserved. When enabled, save and restart Valheim to apply the choices. Rules such as no map and fire hazard have separate switches.

The same page manages admins, the allowlist and bans by platform ID (Steam or Xbox), one ID per line. Display names are reminders only; the game authorizes by ID. Turning on the allowlist restricts entry to permitted IDs; admins are included automatically. Valheim rereads these lists after a few seconds without a restart. Verify an ID before giving it admin powers.

Game and panel

The installer writes launch settings to server.env and creates the heimdall-valheim service, which the panel starts and stops. Worlds live apart from the game files, so SteamCMD updates never touch them. The host settings for website, panel and collectors are in heimdall.env, and panel credentials live in a separate file.

What Linux Windows
Launch settings /srv/valheim/server.env C:\ProgramData\HeimdallNexus\valheim\server.env
Worlds /srv/valheim/saves C:\ProgramData\HeimdallNexus\valheim\saves
Installation settings /etc/heimdall-nexus/heimdall.env C:\ProgramData\HeimdallNexus\etc\heimdall.env
Panel account /etc/heimdall-panel/config.json C:\ProgramData\HeimdallNexus\etc\panel\config.json
Game service heimdall-valheim.service (systemd) heimdall-valheim Windows service
Logs journalctl -u <service> C:\ProgramData\HeimdallNexus\logs\<service>

If the server accepts players but does not answer the local UDP status query (A2S), the panel uses Game server connected from the current service invocation to mark it ready. The player count then remains unavailable (—), and the world clock shows the last save without claiming that nobody is playing. You can view the game password locally with sudo grep '^VH_PASSWORD=' /srv/valheim/server.env on Linux, or Select-String VH_PASSWORD C:\ProgramData\HeimdallNexus\valheim\server.env in an administrator PowerShell on Windows; do not share its output.

Use the panel for normal operation. If you change a system setting by hand, restart only the affected web service or collector. A future upgrade must preserve the instance data paths.

Live data

The Layout Editor offers draggable live values (Adicionar → Dados ao vivo). Basic server, player and world data can be enabled on a vanilla server. Seasons and saga need the matching mod or source. An unavailable value displays a placeholder; select only groups that make sense for your host. The selected groups are recorded in the public /api/features.json.

Modpack list

The home page reads mods.json. When a Hexium pack is selected, the installer imports its site list. The separate server-install choice downloads the package and its pinned dependencies into BepInEx, skipping packages explicitly labeled client-only. The panel reads the resulting mods.lock.json. Some mods need additional server configuration.

When the pack gets a new version, open Jarl → Aparência → Modpack. The page checks Hexium on its own and compares the published list with the new one: mods that are new, that left and that changed version. Mods without a reviewed description get a field for a Portuguese text; left empty, the site uses the original Hexium text, and what you write is kept for later updates. Nothing changes on the site until Aplicar e publicar. This updates the site list only; mods on the server are managed in Mod Manager.

Content

A new site starts with placeholder text, the Heimdall favicon and a neutral palette. Set its identity in Aparência and its text in the Layout Editor. Page publishing does not run page generators.

Clone this wiki locally