Server Configuration Guide
Valheim offers extensive server configuration options allowing you to customize your gaming experience. This comprehensive guide covers all available settings, their effects, and how to configure them through the Supercraft panel or directly in configuration files.
Configuration Overview
Valheim uses Command-line arguments for server configuration. Settings can be adjusted through the Supercraft configuration panel or by editing files directly.
Basic Server Settings
| Setting | Type | Default | Description |
|---|---|---|---|
name |
String | String, max 100 chars | `-name` Valid values: Server name visible in browser |
password |
strProp` | Alphanumeric + `_-`, max 24 chars | `-password` Valid values: Server join password |
public |
Boolean | Boolean | `-public 1/0` Valid values: List in public server browser |
crossplay |
Boolean | Boolean (flag) | `-crossplay` Valid values: Enable PlayFab cross-platform |
World Settings
| Setting | Type | Default | Description |
|---|---|---|---|
mapName |
String | String, max 100 chars | `-world` Valid values: World name (creates or loads) |
customSeed |
String | Alphanumeric, max 10 chars | `-worldseed` Valid values: World generation seed |
preset |
Select | See presets below | `-preset` Valid values: World modifier preset |
World Modifiers
| Setting | Type | Default | Description |
|---|---|---|---|
mod_combat |
Select | `veryeasy`, `easy`, `hard`, `veryhard` | `-modifier combat Valid values: Combat difficulty |
mod_deathPenalty |
Select | `casual`, `veryeasy`, `easy`, `hard`, `hardcore` | `-modifier deathPenalty Valid values: Death consequences |
mod_resources |
Select | `muchless`, `less`, `more`, `muchmore`, `most` | `-modifier resources Valid values: Resource abundance |
mod_raids |
Select | `none`, `muchless`, `less`, `more`, `muchmore` | `-modifier raids Valid values: Raid frequency |
mod_portals |
Select | `casual`, `hard`, `veryhard` | `-modifier portals Valid values: Portal restrictions |
World Keys/Flags
| Setting | Type | Default | Description |
|---|---|---|---|
key_nobuildcost |
Boolean | No | `-setkey nobuildcost` Valid values: Free building (no resources needed) |
key_playerevents |
Boolean | No | `-setkey playerevents` Valid values: Enable player-triggered events |
key_passivemobs |
Boolean | No | `-setkey passivemobs` Valid values: Non-aggressive creatures |
key_nomap |
Boolean | No | `-setkey nomap` Valid values: Disable map/minimap |
Admin/Access Control
| Setting | Type | Default | Description |
|---|---|---|---|
adminlist |
List | No | `adminlist.txt` Valid values: Steam IDs with admin privileges |
bannedlist |
List | No | `bannedlist.txt` Valid values: Banned Steam IDs |
permittedlist |
List | No | `permittedlist.txt` Valid values: Whitelist Steam IDs |
Mod Support
| Setting | Type | Default | Description |
|---|---|---|---|
bepinex |
Boolean | No | Enable BepInEx mod loader Valid values: `false` |
Frequently Asked Questions
How do I change the difficulty in Valheim?
To change difficulty in Valheim, navigate to the Configuration panel in Supercraft and locate the 'Difficulty' or 'Preset' setting under Gameplay Settings. Select your preferred difficulty level and save your configuration. Restart your server for changes to take effect.
How do I set a password for my Valheim server?
Set a server password in the Basic Server Settings section. Enter your desired password in the 'Server Password' field. Leave it empty for a public server without password protection. Save and restart your server.
How do I configure admin access?
Admin access can be configured through the Admin/Access Control settings. Add Steam IDs or usernames to the admin list, depending on your game's authentication system. Consult the specific admin list documentation for your game.
How do I set a custom world seed?
Set a custom world seed in the World Settings section before first starting your server. Enter your desired seed value in the 'World Seed' or 'Map Seed' field. Note that changing the seed after world generation will not affect existing worlds.
Why aren't my configuration changes applying?
Configuration changes require a server restart to take effect. After saving your settings in the Supercraft panel, restart your server. If changes still don't apply, verify the configuration file syntax is correct and check server logs for errors.
Can I upload a custom configuration file?
Yes, you can upload custom configuration files through the Supercraft file manager. Navigate to the configuration directory, upload your file, and restart the server. Ensure your file follows the correct format for your game.
Do I need to restart the server after changing settings?
Yes, most configuration changes require a server restart to take effect. Some games support hot-reloading for specific settings, but it's recommended to always restart after making configuration changes.
Using the Supercraft Configuration Panel
Our platform provides a user-friendly interface for managing your Valheim server configuration without editing files manually.
- Log in to your Supercraft panel at https://supercraft.host/my-account
- Navigate to your Valheim server from the deployments list
- Click the "Configuration" tab
- Adjust settings using the intuitive form controls
- Click "Save Configuration" to apply changes
- Restart your server for changes to take effect
The configuration panel validates your inputs and prevents invalid values, ensuring your server starts correctly.
Troubleshooting
Settings not applying after save
Ensure you've restarted the server after saving configuration changes. Most settings require a full server restart. Check the server logs for any configuration errors that might prevent the server from starting.
Configuration file validation errors
Verify that your configuration file follows the correct format for your game. Check for syntax errors like missing quotes, incorrect separators, or invalid values. Use the Supercraft configuration panel to validate settings before applying them.
Server won't start after config change
Revert to the previous working configuration using the Supercraft file manager's backup feature. Check server logs for specific error messages. Common issues include invalid port numbers, malformed file paths, or out-of-range numeric values.