Guide

Enshrouded Server Settings Explained: Every Option in enshrouded_server.json

Countach
Countach
November 21, 2026 at 12:43 AM · 5 min read
Clan MemberGeneral of the Army
Two characters overlook a foggy valley and tower at sunset

Enshrouded Server Settings: Every Option in enshrouded_server.json

All Enshrouded server settings live in one file, enshrouded_server.json, which the server writes next to enshrouded_server.exe the first time it starts. It holds the identity fields (name, slotCount from 1 to 16, queryPort defaulting to 15637), userGroups that act as passwords and permissions, a gameSettingsPreset, and the individual gameSettings values. The single biggest trap: individual gameplay values are ignored unless gameSettingsPreset is set to Custom. Stop the server, edit the file, validate the JSON, then restart.

If you have not installed the server yet, start with How to Do an Enshrouded Dedicated Server Setup on Windows and come back here for the tuning. The dedicated server is bundled free with Enshrouded and appears in the Steam library's Tools section once you own the game. It runs on Windows only for now.

Two characters rest by a campfire under a starry night sky
Two characters rest by a campfire under a starry night sky

Find and edit enshrouded_server.json safely

The config sits in the root of your server installation. If it is missing, start the server once so it generates a fresh file with default values.

  1. Stop the server completely. It writes its current state back to the file on shutdown, so live edits are overwritten.
  2. Open enshrouded_server.json in a text editor.
  3. Make your changes and save the file.
  4. Paste the saved file's contents into a JSON validator. A missing comma or an extra bracket is enough for the server to silently replace your entire config with defaults on the next startup.
  5. Fix anything the validator flags, save again, then start the server.

Invalid text values stop the server from booting and name the faulty value in the log. Numbers outside the allowed range are clamped to the minimum or maximum automatically.

Back up the file before major changes and before every game update. Keen Games warns that older config files can sometimes be incorrectly updated by newer server builds, and 1.0 converted Early Access saves to a new format while resetting the skill tree.

Server identity and connection fields

These are the top-level keys that decide what the server is called, where it saves, and how players reach it.

Field Default Meaning
name "Enshrouded Server" Server name in the server list
saveDirectory "./savegame" Folder for the world save
logDirectory "./logs" Log folder; older logs archived to ./logs/backup
ip "0.0.0.0" Bind IP, only for special network setups
queryPort 15637 The server's only port (UDP)
slotCount 16 Player slots, 1 to 16; fewer slots ease CPU and RAM load
tags [] List of server tags
voiceChatMode "Proximity" Proximity or Global
enableVoiceChat false Voice chat on/off
enableTextChat false Text chat on/off
gameSettingsPreset "Default" Difficulty preset
gameSettings { … } Individual values, only applied with Custom
userGroups [ … ] Roles with passwords and permissions
bans [] List of banned players

There is no top-level password field in the current file. Passwords are set per group in userGroups; if the server still finds a password there, it automatically creates a userGroup named "default" with the old standard permissions.

Keen's published default file sets enableVoiceChat and enableTextChat to false; some host guides list them as true. Read your own generated file for the live defaults.

On slotCount: every extra player adds CPU and RAM load. If you run a small group, matching the slot count to your actual player count keeps the server responsive. Keen's recommended specs for 4 to 6 players are an Intel Core i7 at 3.2 GHz or equivalent AMD with 6 cores and 12 threads, 16 GB of RAM, an SSD with 30 GB free, and roughly 2 Mbit/s of upload per player.

Set the difficulty preset to Custom

Enshrouded ships five presets: Default, Relaxed, Hard, Survival, and Custom. Default is the intended baseline, Relaxed reduces pressure, and Hard and Survival make combat and survival systems more demanding.

Individual gameSettings values only apply when the file reads "gameSettingsPreset": "Custom". If your changes do nothing, check this line first. Use Custom only after your group agrees which systems to change, because it replaces the curated preset with your own numbers.

On a hosted panel, the sequence is: stop the server, select Custom from the Game Settings Preset dropdown, expand the "Game Settings (Custom)" section, edit your values, save, then start.

How factor settings work

Most gameplay values use a factor. A factor of 1 keeps the normal value, shown in-game as 100%. A factor of 2 doubles it to 200%, and 0.5 halves it to 50%.

Every factor has a minimum and maximum. The tables below list the limits, and panels display them under each field.

Combat and enemy settings

Enemy and boss values scale separately, so you can soften regular fights without touching boss encounters.

Field Default Range/Options Effect
enemyDamageFactor 1 0.25 to 5 Enemy damage (excludes bosses)
enemyHealthFactor 1 0.25 to 4 Enemy health (excludes bosses)
enemyStaminaFactor 1 0.5 to 2 Enemy stamina; higher means harder to stun
enemyPerceptionRangeFactor 1 0.5 to 2 How far enemies see and hear (excludes bosses)
bossDamageFactor 1 0.2 to 5 Boss attack damage
bossHealthFactor 1 0.2 to 5 Boss health
threatBonus 1 0.25 to 4 Enemy attack frequency (excludes bosses)
randomSpawnerAmount "Normal" Few / Normal / Many / Extreme Enemies in the world
aggroPoolAmount "Normal" Few / Normal / Many / Extreme Enemies attacking simultaneously
pacifyAllEnemies false true/false Enemies only attack once attacked (excludes bosses)
curseModifier "Normal" Easy / Normal / Hard Shroud curse chance; Easy turns it off, Hard doubles it

Enshrouded 1.0 added an Automatic option for enemies per encounter that scales to party size, and reworked the enemy damage slider values; Keen has not published the corresponding enshrouded_server.json values, so the ranges above predate 1.0.

Survival and world settings

This block covers hunger, death penalties, weather, fishing, taming, and the length of day and night.

Field Default Range/Options Effect
enableDurability true true/false false means weapons no longer break
enableStarvingDebuff false true/false Without food, periodic health loss
fromHungerToStarving 600000000000 5 to 20 min (nanoseconds) Hungry state length before starving
foodBuffDurationFactor 1 0.5 to 2 Food buff duration
shroudTimeFactor 1 0.5 to 2 Time players can stay in the Shroud
tombstoneMode "AddBackpackMaterials" AddBackpackMaterials / Everything / NoTombstone What drops on death
enableGliderTurbulences true true/false Glider turbulence
weatherFrequency "Normal" Disabled / Rare / Normal / Often Weather frequency
fishingDifficulty "Normal" VeryEasy / Easy / Normal / Hard / VeryHard Fish strength in the minigame
tamingStartleRepercussion "LoseSomeProgress" KeepProgress / LoseSomeProgress / LoseAllProgress Taming progress lost when startling wildlife
dayTimeDuration 1800000000000 (30 min) 2 to 60 min (nanoseconds) Daytime length
nightTimeDuration 720000000000 (12 min) 2 to 60 min (nanoseconds) Nighttime length

Time values are written in nanoseconds, which is why 30 minutes shows up as 1800000000000.

Resource, crafting and XP settings

Gathering and progression values are where most co-op groups make their first changes.

Field Default Range Effect
miningDamageFactor 1 0.5 to 2 Mining damage, terraforming and yield per hit
plantGrowthSpeedFactor 1 0.25 to 2 Plant growth speed
resourceDropStackAmountFactor 1 0.25 to 2 Materials per loot stack (chests, enemies)
factoryProductionSpeedFactor 1 0.25 to 2 Production times at workstations
perkUpgradeRecyclingFactor 0.5 0 to 1 Rune refund when salvaging upgraded weapons
perkCostFactor 1 0.25 to 2 Rune cost for weapon upgrades
experienceCombatFactor 1 0.25 to 2 XP from combat
experienceMiningFactor 1 0 to 2 XP from mining
experienceExplorationQuestsFactor 1 0.25 to 2 XP from exploration and quests
flameLevelForShroudRemoval not documented 0 to 11 Flame level a world needs before Flame Altars push back the Shroud; lower it to unlock Shroud removal earlier

Player settings

Character stats scale independently of enemy values, which lets you raise survivability without lowering difficulty. The keys below are the ones that appear under gameSettings; check the exact casing against your own generated file, since panels sometimes display them as plain-language labels.

Field Default Range/Options Effect
playerHealthFactor 1 0.25 to 4 Max health
playerManaFactor 1 0.25 to 4 Max mana
playerStaminaFactor 1 0.25 to 4 Max stamina
playerBodyHeatFactor 1 0.5 to 2 Body heat; higher means slower heat loss in cold areas
playerDivingTimeFactor 1 0.5 to 2 Time underwater before oxygen runs out

Enshrouded server roles: passwords and permissions

Enshrouded has no console commands. Administration on a dedicated server is entirely role passwords plus this JSON file, so plan your groups before you invite anyone.

Last updated: November 21, 2026 at 12:43 AM

Comments

0 Comments

Join the Conversation

Share your thoughts, ask questions, and connect with other community members.

No comments yet

Be the first to share your thoughts!