25% off on first order withAPEX25
Minecraft
Posted on Nov 16, 2026

Enshrouded Server Settings Explained

Running a dedicated Enshrouded server gives your group total control over how Embervale plays, whether you want a relaxed building session or a punishing survival challenge. Every world rule, from enemy damage and loot drops to day length a...
Enshrouded Server Settings Explained

Table of Contents

Share on
Read Progress

Running a dedicated Enshrouded server gives your group total control over how Embervale plays, whether you want a relaxed building session or a punishing survival challenge. Every world rule, from enemy damage and loot drops to day length and player roles, is controlled inside a single configuration file. In this Apex Hosting guide, we will show you how to access and edit this file so you can take control over your Enshrouded server.

How Enshrouded Server Settings Work

Your group wants longer days, fewer enemies, or a gentler death penalty, and the default world offers none of that. Enshrouded server settings fix it, located in enshrouded_server.json.

The file has three parts you’ll touch. The top holds the basics: name, player slots, and chat. The gameSettings block holds the gameplay values. The userGroups block holds passwords and permissions.

One trap catches almost everyone. Keen Games, the studio behind Enshrounded, says you can tweak the individual gameSettings values only when gameSettingsPreset is set to "Custom". Under any other preset, expect your edits not to apply.

Keen also states two safety rules. In gameSettings, a number outside the allowed range is replaced by the nearest limit, so 10 in a 0.25 to 4 slot becomes 4. But text the server can’t read stops it from booting.
 

How to Change Server Settings on Apex

Gameplay settings live in the file, so you edit it through FTP File Access. You’ll need a server first! Our Enshrouded server hosting page has the plans.

  1. Head towards your Apex server panel and stop your server.
  2. Click File Management > FTP File Access at the top left, then login
  3. Double-click enshrouded_server.json to open it in the editor.
  4. Set gameSettingsPreset to "Custom".
  5. Change the values you want inside gameSettings.
  6. Press Ctrl or Cmd+S to save the file.
  7. Return to the main panel and start (or restart) the server.

 
Our FTP File Access guide covers the editor in more detail.

Keep every quote mark and comma exactly where you found it. Each line in a block ends with a comma except the last one. Invalid text stops the server from booting, so check your last edit first if it won’t start.

Here’s the pattern for halving enemy damage and stretching the day to 45 minutes. Change three lines: "gameSettingsPreset": "Custom", "enemyDamageFactor": 0.5, and "dayTimeDuration": 2700000000000. Leave every other line as it is.

The server name has its own field. Open Customizations, then Server Settings, and edit Public Server Name. Our guide to changing your Enshrouded server name has the steps.
 

Difficulty Presets

The gameSettingsPreset setting takes one of five values. Keen describes them like this.

Preset What It Does
"Default" Every value at its default. Keen recommends it for first-time players.
"Relaxed" Fewer enemies, plus more resources and loot. It targets players who care most about base-building and light-hearted adventuring.
"Hard" More enemies, and more aggressive ones, for tougher combat.
"Survival" More aggressive enemies plus extra survival mechanics, for players who want some punishment.
"Custom" Lets you set each value in the gameSettings block by hand.

 
Keen doesn’t publish the exact numbers behind Relaxed, Hard, or Survival. So if you want one change to a preset, pick "Custom" and set the values you care about from the tables below.
 

Server Settings: Name, Slots, and Chat

These settings sit at the top of the file, above gameSettings.

Setting Default Range or Options What It Does
name "Enshrouded Server" Text The name players see in the server list. Keen asks for a non-offensive one.
slotCount 16 1 to 16 The number of player slots. Each slot adds load, so lower it if CPU or RAM is the bottleneck.
voiceChatMode "Proximity" "Proximity" or "Global" Switches between proximity voice chat and server-wide global voice chat.
enableVoiceChat false true or false Turns voice chat on or off completely.
enableTextChat false true or false Turns text chat on or off completely.

 
Four more settings are ip ("0.0.0.0"), queryPort (15637), saveDirectory ("./savegame"), and logDirectory ("./logs"). Keen ties the first two to internal network and firewall setups, and the last two set where saves and logs go.

Leave all four alone unless our 24/7 Support Team asks you to change one.

 

Gameplay Settings

Every option in this section sits inside gameSettings. Most are factors that scale a value. They default to 1, and the game shows them as percentages. Most enemy settings leave out bosses, which have their own.
 

Player Stats and Gear

Setting Default Range or Options What It Does
playerHealthFactor 1 0.25 to 4 Scales maximum player health.
playerManaFactor 1 0.25 to 4 Scales maximum player mana.
playerStaminaFactor 1 0.25 to 4 Scales maximum player stamina.
playerBodyHeatFactor 1 0.5 to 2 Scales the body heat a player can hold. Higher values let players stay in very cold areas longer before hypothermia.
playerDivingTimeFactor 1 0.5 to 2 Scales starting oxygen, which sets the time available underwater.
enableDurability true true or false Set it to false and weapons stop breaking.

 

Survival and Food

Setting Default Range or Options What It Does
enableStarvingDebuff false true or false Turns on hunger and starvation. A starving player loses health periodically until death unless they eat or drink.
foodBuffDurationFactor 1 0.5 to 2 Scales how long food buffs last.
fromHungerToStarving 600000000000 (10 minutes) 5 to 20 minutes Sets how long the hungry state lasts before starving begins. The unit is nanoseconds.
tombstoneMode "AddBackpackMaterials" "AddBackpackMaterials", "Everything", "NoTombstone" With the default, players lose only materials on death. Lost items wait in a tombstone and can be recovered there.
shroudTimeFactor 1 0.5 to 2 Scales how long player characters can stay in the Shroud.
curseModifier "Normal" "Easy", "Normal", "Hard" Sets the chance of receiving the Shroud curse when the matching enemies attack. "Easy" turns it off, and "Hard" doubles the chance.

 

World and Resources

Setting Default Range or Options What It Does
weatherFrequency "Normal" "Disabled", "Rare", "Normal", "Often" Sets how often new weather phenomena appear in the world.
enableGliderTurbulences true true or false Turn it off and air turbulence no longer affects the glider.
fishingDifficulty "Normal" "VeryEasy", "Easy", "Normal", "Hard", "VeryHard" Sets how strong fish are in the fishing minigame. Stronger fish make the minigame last longer.
miningDamageFactor 1 0.5 to 2 Scales mining damage. More damage means more terraforming and more resources per hit.
plantGrowthSpeedFactor 1 0.25 to 2 Scales how fast plants grow.
resourceDropStackAmountFactor 1 0.25 to 2 Scales the amount of materials per loot stack in chests, defeated enemies, and similar sources.
factoryProductionSpeedFactor 1 0.25 to 2 Scales the length of production times for workshop items.
perkUpgradeRecyclingFactor Not listed 0 to 1 Scales the Runes you get back when salvaging upgraded weapons.
perkCostFactor 1 0.25 to 2 Scales the Runes needed to upgrade weapons.
experienceCombatFactor 1 0.25 to 2 Scales the XP earned in combat.
experienceMiningFactor 1 0 to 2 Scales the XP earned by mining resources.
experienceExplorationQuestsFactor 1 0.25 to 2 Scales the XP earned by exploring and completing quests.

 

Enemies and Bosses

Setting Default Range or Options What It Does
randomSpawnerAmount "Normal" "Few", "Normal", "Many", "Extreme" Controls the number of enemies in the world.
aggroPoolAmount "Normal" "Few", "Normal", "Many", "Extreme" Controls how many enemies can attack at the same time.
enemyDamageFactor 1 0.25 to 5 Scales all enemy damage except bosses.
enemyHealthFactor 1 0.25 to 4 Scales all enemy health except bosses.
enemyStaminaFactor 1 0.5 to 2 Scales enemy stamina. Enemies with more stamina take longer to stun. Bosses are excluded.
enemyPerceptionRangeFactor 1 0.5 to 2 Scales how far enemies can see and hear a player. Bosses are excluded.
bossDamageFactor 1 0.2 to 5 Scales the damage of boss attacks.
bossHealthFactor 1 0.2 to 5 Scales all boss health.
threatBonus 1 0.25 to 4 Scales how often enemies attack. Bosses are excluded.
pacifyAllEnemies false true or false When on, enemies don’t attack a player until the player attacks them. Bosses are excluded.
tamingStartleRepercussion "LoseSomeProgress" "KeepProgress", "LoseSomeProgress", "LoseAllProgress" Decides what happens when a player startles wildlife during taming. The game shows taming progress as hearts.

 

Day and Night

Setting Default Range What It Does
dayTimeDuration 1800000000000 (30 minutes) 120000000000 to 3600000000000 (2 to 60 minutes) Sets the length of daytime. A smaller value gives a shorter day.
nightTimeDuration 720000000000 (12 minutes) 120000000000 to 3600000000000 (2 to 60 minutes) Sets the length of nighttime. A smaller value gives a shorter night.

 
Both options count in nanoseconds, and so does fromHungerToStarving. To convert, multiply the minutes by 60,000,000,000 and type the result without commas. A 45-minute day is 45 times 60,000,000,000, which gives 2700000000000.

 

Roles and Passwords

Passwords and permissions live in the userGroups block. Each group has a name, a password, and a set of permissions. The password a player types decides which group they join, and so what they can do. Keen’s server roles article explains the system.

The default file holds four groups: Admin, Friend, Guest, and Visitor. You can add more. Copy a group block, then give it a new name, a new password, and the permissions you want.

Setting Admin, Friend, Guest, Visitor What It Does
name Group name The label for the group.
password Text, one per group The password players enter to join as that group.
canKickBan true, false, false, false Lets the group kick and ban other players.
canAccessInventories true, true, false, false Lets the group use chests and other containers.
canEditWorld true, true, true, false Lets the group change the world outside bases.
canEditBase true, true, false, false Lets the group change player bases.
canExtendBase true, false, false, false Keen gives no description for this option.
reservedSlots 0, 0, 0, 0 Holds slots for the group.

 
Reserved slots matter on a busy server. Reserved slots stay free for their group. Players in other groups see the lobby as full once only the reserved slots are left, so your admins can still get in. The developers highly recommends setting a password, because every player can see and join a server without one.

So set a password for every group first. Our guide to setting an Enshrouded server password walks through it. Then share the right password with each player and point them to our guide on how to join an Enshrouded server.

 

Enshrouded Server Settings FAQ

 

Why Aren’t My Enshrouded Server Settings Applying?

Check gameSettingsPreset first. Keen says individual settings can be tweaked only when it’s set to "Custom". Then confirm you saved the file and restarted the server.
 

Why Won’t My Server Start After I Edited the File?

Keen says text the server can’t read stops it from booting. Look for a word where a number belongs, then check for a missing quote or comma, a common cause in any JSON file. Also check that choice values match the spelling in the tables. A gameSettings number outside the range isn’t the cause, because the server replaces it with the nearest limit. If you can’t spot the problem, our 24/7 Support Team can help.
 

How Many Player Slots Can I Set?

The slotCount optiong takes a number from 1 to 16. Keen notes that each slot adds load, so lower it if CPU or RAM is the bottleneck.