_                             _             _                                                                                _           ___      
                    ( )                           ( )           ( )                                                     _                        (_)        /'___)     
   __    ___    ___ | |__   _ __   _    _   _    _| |   __     _| |        ___    __   _ __  _   _    __   _ __        (_)  ___    _     ___     | |  ___  | (__   _   
 /'__`\/' _ `\/',__)|  _ `\( '__)/'_`\ ( ) ( ) /'_` | /'__`\ /'_` |      /',__) /'__`\( '__)( ) ( ) /'__`\( '__)       | |/',__) /'_`\ /' _ `\   | |/' _ `\| ,__)/'_`\ 
(  ___/| ( ) |\__, \| | | || |  ( (_) )| (_) |( (_| |(  ___/( (_| |      \__, \(  ___/| |   | \_/ |(  ___/| |    _     | |\__, \( (_) )| ( ) |   | || ( ) || |  ( (_) )
`\____)(_) (_)(____/(_) (_)(_)  `\___/'`\___/'`\__,_)`\____)`\__,_)      (____/`\____)(_)   `\___/'`\____)(_)   (_) _  | |(____/`\___/'(_) (_)   (_)(_) (_)(_)  `\___/'
                                                                   ______                                          ( )_| |                                             
                                                                  (______)                                         `\___/'                                             

Version: 0.9.0.0


The following paragraphs describe options and valid values for admins of dedicated servers. The settings can be configured by editing the file enshrouded_server.json, located in the same folder as the enshrouded_server.exe



SERVER SETTINGS

With version 0.9.0.0 the server settings have been expanded:


name
Default is: "Enshrouded Server". This can be freely modified. Server names appear in the Join menu server list, please don't use offensive language.

saveDirectory
Default is: "./savegame". At this location, a custom directory can be defined to store the world savegame of the server.

logDirectory
Default is: "./logs". At this location, a custom directory can be defined to store the logfiles of the server.

ip
Default: "0.0.0.0". At this location, the IP of the server can be set. This setting should only be changed with caution and when there is a specific reason for the change. 

queryPort
Default: 15637. At this location the port for the server can be set. This setting should only be changed with caution.

slotCount
Default: 16. The slotcount refers to the maximum of allowed players on the server. The number can only be between 1 and 16.

tags
Default: [
	]
Update 0.9.0.0 introduced the concept of optional dedicated server filter tags. Admins can select from a range of available tags to help other players find a fitting server to join by filtering their search using the same tags. For now, the tags allow describing if the server is happy to have new players (lookingForPlayers), what languages are spoken on the server and if there is a main gameplay focus, such as exploration or base building.
List of available tags:
		LookingForPlayers,
		English,
		German,
		French,
		Italian,
		Japanese,
		Korean,
		Polish,
		Portuguese,
		Russian,
		Spanish,
		Thai,
		Turkish,
		Ukrainian,
		Chinese,
		Taiwanese,
		BaseBuilding,
		Exploration,
		Roleplay,
Example syntax:
"tags": [
		"LookingForPlayers",
		"English",
		"BaseBuilding"
	],

voiceChatMode
Default: "Proximity". This setting allows switching between the proximity voice chat and the global, server-wide voice chat.
Options: Proximity / Global

enableVoiceChat
Default: false. This setting allows switching voice chat on or off for the server.
Options: true / false

enableTextChat
Default: false. This setting allows switching text chat completely off or enabling it.
Options: true / false

gameSettingsPreset
Default: "Default". This setting allows to either define custom difficulty and gameplay option settings or pick one of the pre-defined gameplay difficulty settings. For more information jump to the chapter "DIFFICULTY- AND GAMEPLAY SETTINGS" of this document.

userGroups
Default: Admin, Friend, Guest, Visitor.
Via "usergroups" server admins can either provide predefined roles for players or create new roles with individually selected permissions. For more information jump to the chapter "PERMISSION SETTINGS" of this document.

bans
Default: [
	]
On top of the previously available "kick"-option for server hosts, update 0.9.0.0 introduced the option to permanently ban individual players from a server. The list of banned players can be accessed ingame via the Social-tab and players can be added or removed there. It can also be manually edited in the enshrouded_server.json when the server is not running. The information stored in the enshrouded_server.json is accountIDHash (an identifier for the Steam account ID without violating the protected personal data of the player), displayName (a.k.a Steam account name), characterName and banDate (which is stored as unix timestamp).




PERMISSION SETTINGS

Enshrouded allows hosts to define permissions for groups of players. 
This document leads through the options and also highlights areas that hosts need to be aware of.


Dedicated server hosting - Setting up user groups

Player permissions for playing on dedicated servers are handled via user groups. Each group can be set up in the “enshrouded_server.json” with a unique configuration of permissions and an accompanying password that grants the permissions to the logged-in player. 
By default, since version 0.9.0.0 of Enshrouded the “enshrouded_server.json” starts with 4 user groups which may serve as a base for hosts. The presets are:

Admin:
Changes to the player bases are allowed.
Using chests and other containers are allowed.
Kicking and banning other players is allowed.

Friend:
Changes to the player bases are allowed.
Using chests and other containers are allowed.

Guest: 
Changes to the player bases are not allowed.
Using chests and other containers are not allowed.

Visitor:
Changes to the player bases are not allowed.
Using chests and other containers are not allowed.
Changes to the game world outside the base are not allowed.


Please note: all user groups (except the "Visitor"-role) have full access to the game world outside the player bases and can engage in combat, collect materials, dig for resources, solve quests etc. 
Please also note: the presets mentioned above are only generated when the “enshrouded_server.json” is freshly created (and the version of Enshrouded is higher than update 2, released on 2024-06-05). Sidenote: When the game detects an already defined password from an old version, only the “default” user group is created with the permission configuration identical to “Friend” from the presets above.
When a fresh enshrouded_server.json is created in the current version, randomized passwords are set to prevent unwanted players from joining the server.


Custom player permission groups 

The “enshrouded_server.json” also allows setting up new and unique user groups. Simply add a new user group section with a new name, define a password and select the permissions needed for the player group. 

In update 0.9.0.0 there are the following permission options:
"canKickBan": This permission allows or disallows for players to either kick or permanently ban other players. It is recommended for admin-level player roles.
"canAccessInventories": This permission allows or disallows players to access storage chests, factories, collections and other containers with potentially valuable items. The setting only refers to objects in player bases, it does not prevent access to treasure chests in the open world.
"canEditWorld": This permission allows or disallows players to terraform or destroy areas in the open world. It is recommended for visitor-only player roles and protects against grieving attempts.
"canEditBase": This permission allows or disallows terraforming, building and removing constructions in player bases. It also includes adding and removing water in player bases. 
"canExtendBase": This permission allows or disallows the addition of new Flame Altars, removal of Flame Altars and upgrading Flame Altars.

Another setting that can be configured for each user group is a number of reserved slots for that particular user group.
This is set by adding this line to the user group:
"reservedSlots": 1
When 1 or more reserved slots are set, the lobby will be marked as “full” for players who try to log into the server under a different user group and would fill up all session slots. This allows for example Admins or Friends to join even if there is a high demand for slots by “Guests”. 

Legacy notes: Dedicated server hosting - Using the pre-update 2 settings

In Update 2 of Enshrouded released on 2024-06-05 the structure of the “enshrouded_server.json” had to be adapted to support multiple passwords.
The password for a server was previously defined in line 3 of the file “enshrouded_server.json” via “password”: “” 
This line is no longer used to setup the password for dedicated servers!
However, if the game detects a password defined in line 3, it will set up a new “userGroup” called “default” which uses the password and automatically grants the same permission level as what players were accustomed to up until Update 2. 




DIFFICULTY- AND GAMEPLAY SETTINGS


Update 0.7.3.0 (Released 2024-07-29) introduced a number of difficulty- and gameplay settings that can be configured for the dedicated server via the enshrouded_server.json - file.
Note: when no enshrouded_server.json config file is found, then a fresh file is created with the start of the enshrouded_server.exe.


Difficulty setting presets

"gameSettingsPreset":

The options are:
"Default” - The “Default” difficulty setting configures all values to default. It is the direct continuation of how Enshrouded was configured up until update 0.7.3.0 and is the recommended setting for first-time players.
“Relaxed” - The “Relaxed” preset reduces the amount of enemies and provides players with more resources and loot. This mode targets players who are most interested in base-building and light-hearted adventuring.
“Hard” - The “Hard” preset increases the amount of enemies and makes them more aggressive to give players a tougher combat experience.
“Survival” - The “Survival” preset is for those who seek some punishment with additional survival mechanics on top of more aggressive enemies.
“Custom” - When “Custom” is selected, a long list of individual settings can be tweaked. 


Individual Custom Settings incl. Default values:
Updated with new settings from version 0.9.0.0!

Player Health
"gameSettings": {
"playerHealthFactor": 1,
}
Scales the max health for players by a factor. Ingame, the factor is represented by a percentage.
Min value: 0.25
Max value: 4


Player Mana
"gameSettings": {
"playerManaFactor": 1,
}
Scales the max mana for players by a factor. Ingame, the factor is represented by a percentage.
Min value: 0.25
Max value: 4


Player Stamina
"gameSettings": {
"playerStaminaFactor": 1,
}
Scales the max stamina for players by a factor. Ingame, the factor is represented by a percentage.
Min value: 0.25
Max value: 4


Player body heat against cold weather
"gameSettings": {
"playerBodyHeatFactor": 1,
}
Scales the max amount of available body heat in the player. The higher the factor the longer the player can stay in very cold areas before hypothermia sets in. 
Min value: 0.5
Max value: 2


NEW! Diving time
"gameSettings": {
"playerDivingTimeFactor": 1,
}
Modifies the initial amount of oxygen for players and therefore the time available underwater.
Min value: 0.5
Max value: 2


Weapon Durability
"gameSettings": {
"enableDurability": true,
}
If this setting is set to “false”, weapons don't break anymore.
Options: true / false


Hunger and Starvation
"gameSettings": {
"enableStarvingDebuff": false,
}
Enables hunger and starvation. During starvation, the player loses health periodically until death if no food or drink is consumed.
Options: true / false


Food Buff Duration
"gameSettings": {
"foodBuffDurationFactor": 1,
}
Scales food buff durations. Ingame, the factor is represented by a percentage.
Min value: 0.5
Max value: 2


Hungry State Duration
"gameSettings": {
"fromHungerToStarving": 600000000000,
}
This setting controls the length of the hungry state before the starving sets in. The unit in this setting is nanoseconds. Ingame the time is displayed in minutes.
Min value: 5 minutes
Max value: 20 minutes


Shroud time duration modifier
"gameSettings": {
"shroudTimeFactor": 1,
}
Scales how long player characters can remain within the Shroud. Ingame, the factor is represented by a percentage.
Min value: 0.5 
Max value: 2


Tombstone Mode
"gameSettings": {
"tombstoneMode": "AddBackpackMaterials"
}
The players can either keep or lose all items from their backpack when dying. In the default setting, they only lose materials. Lost items are stored in a tombstone and can be recovered there.
Options: AddBackpackMaterials / Everything / NoTombstone 


Air turbulences while gliding
"gameSettings": {
"enableGliderTurbulences": true,
}
If turned off, the glider will not be affected by air turbulences, just as in previous versions of the game.
Options: true / false


Weather phenomena frequency
"gameSettings": {
"weatherFrequency": "Normal",
}
This setting allows defining how often new weather phenomena appear in the game world.
Options: Disabled / Rare / Normal / Often


NEW! Fishing difficulty
"gameSettings": {
"fishingDifficulty": "Normal",
}
This setting defines the strength of the fish during the fishing minigame. The stronger a fish is, the longer the minigame will proceed.
Options: VeryEasy, Easy, Normal, Hard, VeryHard


Mining Effectiveness
"gameSettings": {
"miningDamageFactor": 1,
}
This scales the mining damage. A higher mining damage leads to increased terraforming and more yield of resources per hit. Ingame, the factor is represented by a percentage.
Min value: 0.5 
Max value: 2


Plant Growth Speed
"gameSettings": {
"plantGrowthSpeedFactor": 1,
}
Scales the value of the plant growth speed. Ingame, the factor is represented by a percentage.
Min value: 0.25 
Max value: 2


Resources Gain Modifier
"gameSettings": {
"resourceDropStackAmountFactor": 1,
}
Scales the amount of materials per loot stack in chests, defeated enemies etc. Ingame, the factor is represented by a percentage.
Min value: 0.25 
Max value: 2


Workstation Effectiveness
"gameSettings": {
"factoryProductionSpeedFactor": 1,
}
Scales the length of production times for workshop items. Ingame, the factor is represented by a percentage.
Min value: 0.25 
Max value: 2


Weapon Recycling Yield Modifier
"gameSettings": {
"perkUpgradeRecyclingFactor": 0.100000,
}
Scales the amount of Runes that are returned to you when salvaging upgraded weapons. Ingame, the factor is represented by a percentage.
Min value: 0 
Max value: 1


Weapon Upgrading Costs
"gameSettings": {
"perkCostFactor": 1,
}
Scales the amount of Runes required for upgrading weapons. Ingame, the factor is represented by a percentage.
Min value: 0.25 
Max value: 2


Combat Experience Modifier
"gameSettings": {
"experienceCombatFactor": 1,
}
Scales the amount of XP received through combat. Ingame, the factor is represented by a percentage.
Min value: 0.25 
Max value: 2


Mining Experience Modifier
"gameSettings": {
"experienceMiningFactor": 1,
}
Scales the amount of XP received by mining resources. Ingame, the factor is represented by a percentage.
Min value: 0 
Max value: 2


Exploration Experience Modifier
"gameSettings": {
"experienceExplorationQuestsFactor": 1,
}
Scales the amount of XP received by exploring and completing quests. Ingame, the factor is represented by a percentage.
Min value: 0.25 
Max value: 2


Enemy Amount
"gameSettings": {
"randomSpawnerAmount": "Normal"
}
This setting controls the amount of enemies in the world. 
Options: Few / Normal / Many / Extreme 


Modifier for simultaneous Enemy Attacks
"gameSettings": {
"aggroPoolAmount": "Normal"
}
This setting controls how many enemies are allowed to attack at the same time. Ingame, the factor is represented by a percentage.
Options: Few / Normal / Many / Extreme


Enemy Damage
"gameSettings": {
"enemyDamageFactor": 1,
}
Scales all enemy damage by this value - except for bosses. Ingame, the factor is represented by a percentage.
Min value: 0.25 
Max value: 5


Enemy Health
"gameSettings": {
"enemyHealthFactor": 1,
}
Scales all enemy health by this value - except for bosses. Ingame, the factor is represented by a percentage.
Min value: 0.25 
Max value: 4


Enemy Stun Modifier
"gameSettings": {
"enemyStaminaFactor": 1,
}
Scales all enemy stamina by this value. It will take longer to stun enemies with a higher enemy stamina. This excludes bosses. Ingame, the factor is represented by a percentage.
Min value: 0.5 
Max value: 2


Enemy Perception Modifier
"gameSettings": {
"enemyPerceptionRangeFactor": 1,
}
Scales how far enemies can see and hear the player. This excludes bosses. Ingame, the factor is represented by a percentage.
Min value: 0.5 
Max value: 2


Boss Damage Modifier
"gameSettings": {
"bossDamageFactor": 1,
}
This setting scales the damage of boss attacks. Ingame, the factor is represented by a percentage.
Min value: 0.2 
Max value: 5


Boss Health Modifier
"gameSettings": {
"bossHealthFactor": 1,
}
Scales all health of bosses by this value. Ingame, the factor is represented by a percentage.
Min value: 0.2 
Max value: 5


Enemy Attacks Modifier
"gameSettings": {
"threatBonus": 1,
}
Scales the frequency of enemy attacks. This excludes bosses. Ingame, the factor is represented by a percentage.
Min value: 0.25
Max value: 4


Pacified Enemies
"gameSettings": {
"pacifyAllEnemies": false,
}
If turned on, enemies won't attack the players until they are attacked. This excludes bosses.
Options: true / false


Taming failure repercussions
"gameSettings": {
"tamingStartleRepercussion": "LoseSomeProgress",
}
This setting allows defining how the game reacts when the player startles the wildlife during taming. Progress is visualized by hearts in the game.
Options: KeepProgress / LoseSomeProgress / LoseAllProgress


Daytime 
"gameSettings": {
"dayTimeDuration": 1800000000000
}
Scales the length of daytime. A smaller value equals shorter daytime. The unit is nanoseconds. Ingame, the time is displayed in minutes.
Min value: 2 minutes
Max value: 60 minutes


Nighttime 
"gameSettings": {
"nightTimeDuration": 720000000000
}
Scales the length of daytime. A smaller value equals a shorter nighttime. The unit is nanoseconds. Ingame, the time is displayed in minutes.
Min value: 2 minutes
Max value: 60 minutes


Modify Shroud curse
"gameSettings": {
"curseModifier": "Normal"
}
This setting allows switching the Shroud curse off or modifying the chance for receiving the curse when being attacked by the corresponding enemies.
Options: Easy (which turns the feature off) / Normal / Hard (which doubles the chance relative to normal)



DEFAULT enshrouded_server.json / VERSION 0.9.0.0

{
	"name": "Enshrouded Server",
	"saveDirectory": "./savegame",
	"logDirectory": "./logs",
	"ip": "0.0.0.0",
	"queryPort": 15637,
	"slotCount": 16,
	"tags": [
	],
	"voiceChatMode": "Proximity",
	"enableVoiceChat": false,
	"enableTextChat": false,
	"gameSettingsPreset": "Default",
	"gameSettings": {
		"playerHealthFactor": 1,
		"playerManaFactor": 1,
		"playerStaminaFactor": 1,
		"playerBodyHeatFactor": 1,
		"playerDivingTimeFactor": 1,
		"enableDurability": true,
		"enableStarvingDebuff": false,
		"foodBuffDurationFactor": 1,
		"fromHungerToStarving": 600000000000,
		"shroudTimeFactor": 1,
		"tombstoneMode": "AddBackpackMaterials",
		"enableGliderTurbulences": true,
		"weatherFrequency": "Normal",
		"fishingDifficulty": "Normal",
		"miningDamageFactor": 1,
		"plantGrowthSpeedFactor": 1,
		"resourceDropStackAmountFactor": 1,
		"factoryProductionSpeedFactor": 1,
		"perkUpgradeRecyclingFactor": 0.500000,
		"perkCostFactor": 1,
		"experienceCombatFactor": 1,
		"experienceMiningFactor": 1,
		"experienceExplorationQuestsFactor": 1,
		"randomSpawnerAmount": "Normal",
		"aggroPoolAmount": "Normal",
		"enemyDamageFactor": 1,
		"enemyHealthFactor": 1,
		"enemyStaminaFactor": 1,
		"enemyPerceptionRangeFactor": 1,
		"bossDamageFactor": 1,
		"bossHealthFactor": 1,
		"threatBonus": 1,
		"pacifyAllEnemies": false,
		"tamingStartleRepercussion": "LoseSomeProgress",
		"dayTimeDuration": 1800000000000,
		"nightTimeDuration": 720000000000,
		"curseModifier": "Normal"
	},
	"userGroups": [
		{
			"name": "Admin",
			"password": "AdminXXXXXXXX",
			"canKickBan": true,
			"canAccessInventories": true,
			"canEditWorld": true,
			"canEditBase": true,
			"canExtendBase": true,
			"reservedSlots": 0
		},
		{
			"name": "Friend",
			"password": "FriendXXXXXXXX",
			"canKickBan": false,
			"canAccessInventories": true,
			"canEditWorld": true,
			"canEditBase": true,
			"canExtendBase": false,
			"reservedSlots": 0
		},
		{
			"name": "Guest",
			"password": "GuestXXXXXXXX",
			"canKickBan": false,
			"canAccessInventories": false,
			"canEditWorld": true,
			"canEditBase": false,
			"canExtendBase": false,
			"reservedSlots": 0
		},
		{
			"name": "Visitor",
			"password": "VisitorXXXXXXXX",
			"canKickBan": false,
			"canAccessInventories": false,
			"canEditWorld": false,
			"canEditBase": false,
			"canExtendBase": false,
			"reservedSlots": 0
		}
	],
	"bans": [
	]
}