Enshrouded enshrouded_server.json: Every Setting Explained
Enshrouded offers extensive server configuration options allowing you to customize your gaming experience. This guide covers every setting, what it does, and the range the game will actually accept, whether you edit through the Supercraft panel or the file directly.
The file is called enshrouded_server.json and it sits beside the server executable. There is no serverconfig.json and no server.cfg in Enshrouded; if a guide names one of those, it is describing a different game.
Configuration Overview
Enshrouded uses a single JSON file for all server configuration. If it is missing, the server writes a fresh one with defaults the first time it starts. Settings can be adjusted through the Supercraft configuration panel or by editing the file directly with the server stopped.
The Custom gate. The whole gameSettings block below is ignored unless gameSettingsPreset is set to Custom. With any other preset the server discards your values and writes a line into its log saying it did. This is the most common reason a change appears to do nothing. See config changes not applying.
Basic Server Settings
| Setting | Type | Accepted values | Description |
|---|---|---|---|
name |
String | String | nameValid values: Server name |
slotCount |
Integer | 1-16 | slotCountValid values: Max players |
userGroups |
Array | Admin, Friend, Guest, Visitor | Roles, each with its own password and permissions. This is where server passwords live. The old top-level password key has not set a server password since Update 2 in June 2024; if the server still finds one it quietly builds a group called "default" around it with Friend-level rights. |
Communication Settings
| Setting | Type | Accepted values | Description |
|---|---|---|---|
enableVoiceChat |
Boolean | Boolean | enableVoiceChatValid values: Voice chat enabled |
enableTextChat |
Boolean | Boolean | enableTextChatValid values: Text chat enabled |
voiceChatMode |
Select | Proximity, Global |
voiceChatModeValid values: Voice mode |
Difficulty Presets
| Setting | Type | Accepted values | Description |
|---|---|---|---|
gameSettingsPreset |
Select | See below | gameSettingsPresetValid values: Difficulty preset |
Custom Game Settings
| Setting | Type | Accepted values | Description |
|---|---|---|---|
playerHealthFactor |
Float | 0.25-4.0 | gameSettings.playerHealthFactorValid values: HP multiplier |
playerManaFactor |
Float | 0.25-4.0 | gameSettings.playerManaFactorValid values: Mana multiplier |
playerStaminaFactor |
Float | 0.25-4.0 | gameSettings.playerStaminaFactorValid values: Stamina multiplier |
playerBodyHeatFactor |
Float | 0.5-2.0 | gameSettings.playerBodyHeatFactorValid values: Cold resistance |
Shroud Settings
| Setting | Type | Accepted values | Description |
|---|---|---|---|
shroudTimeFactor |
Float | 0.5-2.0 | gameSettings.shroudTimeFactorValid values: Time in Shroud |
playerDivingTimeFactor |
Float | 0.5-2.0 | gameSettings.playerDivingTimeFactorValid values: Underwater time |
Frequently Asked Questions
How do I change the difficulty in Enshrouded?
To change difficulty in Enshrouded, 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 Enshrouded server?
Enshrouded sets passwords per user group, not once for the whole server. Open the userGroups section and give each role its own password: Admin, Friend, Guest and Visitor exist by default, each with a different permission set. A player joins with whichever password they were given and gets that group's rights for the session. The old top-level password key no longer sets a server password. Save and restart your server.
Why aren't my configuration changes applying?
Configuration changes require a server restart to take effect; Enshrouded has no reload command. After saving your settings, restart the server. If a difficulty or gameplay change still does nothing, check gameSettingsPreset: the whole gameSettings block is ignored unless it is set to Custom, and the server writes a line into its log saying so. Also check the log for a parse error naming a value it did not understand.
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. Every setting in this file is read at startup and Enshrouded has no hot reload and no admin console, so a restart is the only way to apply a change. Stop the server before editing the file by hand, or the server will overwrite your edit when it shuts down.
Using the Supercraft Configuration Panel
Our platform provides a user-friendly interface for managing your Enshrouded server configuration without editing files manually.
- Log in to your Supercraft panel at https://supercraft.host/my-account/
- Navigate to your Enshrouded 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.