
Wiki & Guides
Enshrouded
Survival · Action-RPG · Keen Games
Enshrouded Server konfigurieren: enshrouded_server.json komplett erklärt
Die enshrouded_server.json als komplette Referenz: alle Top-Level-Felder, userGroups mit Permissions, Schwierigkeits-Presets und sämtliche Custom-gameSettings.
Zuletzt aktualisiert am 20. Juli 2026 · RespawnHost
Auf dieser Seite
Die enshrouded_server.json
Dein Enshrouded-Server wird über eine einzige Datei konfiguriert: die enshrouded_server.json im Server-Verzeichnis. Sie steuert Name, Port, Slots, Chat, Passwörter (über userGroups) und die komplette Spielbalance (über gameSettingsPreset und gameSettings). Bei RespawnHost bearbeitest du sie über den File-Manager im Panel oder per SFTP — dieser Guide ist die vollständige Referenz aller Felder, basierend auf der offiziellen Dokumentation von Keen Games (Stand Server-Version 0.9.0.0).
Warnung
Server immer stoppen, bevor du die Datei bearbeitest — und auf gültige JSON-Syntax achten (Kommas, Anführungszeichen). Bei ungültigen Textwerten startet der Server nicht und nennt den fehlerhaften Wert im Log. Zahlenwerte außerhalb des erlaubten Bereichs werden automatisch auf Minimum/Maximum begrenzt.
Top-Level-Felder
| Feld | Default | Bedeutung |
|---|---|---|
name | "Enshrouded Server" | Servername in der Server-Liste — für alle Spieler sichtbar |
saveDirectory | "./savegame" | Ordner für den Weltspielstand |
logDirectory | "./logs" | Ordner für Logs; ältere Logs wandern automatisch nach ./logs/backup |
ip | "0.0.0.0" | Bind-IP — nur für spezielle Netzwerk-Setups relevant |
queryPort | 15637 | Der einzige Port des Servers (UDP) — bei Bedarf an die Firewall anpassen |
slotCount | 16 | Spieler-Slots, 1–16. Weniger Slots entlasten CPU und RAM |
tags | [] | Liste von Server-Tags |
voiceChatMode | "Proximity" | Proximity (Nähe) oder Global (serverweit) |
enableVoiceChat | false | Voice-Chat an/aus |
enableTextChat | false | Text-Chat an/aus |
gameSettingsPreset | "Default" | Schwierigkeits-Preset, siehe unten |
gameSettings | { … } | Einzeleinstellungen — greifen nur bei Preset Custom |
userGroups | [ … ] | Rollen mit Passwörtern und Rechten, siehe unten |
bans | [] | Liste gebannter Spieler |
Hinweis
Einen separaten Game-Port gibt es seit Content Update #2 nicht mehr — der Server nutzt ausschließlich den queryPort. Auch das frühere Top-Level-Feld password wird seitdem nicht mehr für den Serverschutz verwendet: Findet der Server dort noch ein Passwort, legt er daraus automatisch eine userGroup namens „default" mit den bisherigen Standard-Rechten an. Neue Setups regeln Passwörter komplett über userGroups.
Wie funktionieren Passwörter und Rollen (userGroups)?
Es gibt kein einzelnes Server-Passwort mehr: Das Passwort, das ein Spieler beim Verbinden eingibt, bestimmt seine Gruppe — und damit seine Rechte. Jede Gruppe in userGroups hat diese Felder:
| Feld | Typ | Bedeutung |
|---|---|---|
name | String | Name der Gruppe |
password | String | Passwort, das dieser Gruppe zugeordnet ist. Bei frisch erzeugter Datei werden Zufallspasswörter generiert |
canKickBan | true/false | Darf andere Spieler kicken und bannen |
canAccessInventories | true/false | Darf Truhen, Container und Stationen benutzen |
canEditWorld | true/false | Darf die Spielwelt außerhalb der Basis verändern (z. B. Terraforming) |
canEditBase | true/false | Darf in Basen bauen: Blöcke und Props setzen/entfernen, terraformen |
canExtendBase | true/false | Darf Flammenaltäre setzen, upgraden und entfernen |
reservedSlots | Zahl | Reservierte Slots für diese Gruppe — für andere gilt der Server dann früher als „voll” |
Eine frisch erzeugte enshrouded_server.json startet mit vier Standard-Gruppen:
| Gruppe | canKickBan | canAccessInventories | canEditWorld | canEditBase | canExtendBase |
|---|---|---|---|---|---|
| Admin | ✓ | ✓ | ✓ | ✓ | ✓ |
| Friend | ✗ | ✓ | ✓ | ✓ | ✗ |
| Guest | ✗ | ✗ | ✓ | ✗ | ✗ |
| Visitor | ✗ | ✗ | ✗ | ✗ | ✗ |
Alle Gruppen können unabhängig von den Rechten kämpfen, looten, erkunden und Quests abschließen. Du kannst eigene Gruppen ergänzen — einfach einen weiteren Block mit eigenem Namen, Passwort und Rechte-Kombination anlegen:
"userGroups": [
{
"name": "Admin",
"password": "DeinSicheresAdminPasswort",
"canKickBan": true,
"canAccessInventories": true,
"canEditWorld": true,
"canEditBase": true,
"canExtendBase": true,
"reservedSlots": 1
}
]
Tipp
Setze für die Admin-Gruppe "reservedSlots": 1 — dann kommst du auch dann noch auf den Server, wenn alle übrigen Slots belegt sind.
Welche Schwierigkeits-Presets gibt es?
| Preset | Beschreibung |
|---|---|
Default | Alle Werte auf Standard — die Balance wie bis Version 0.7.3.0, empfohlen für Einsteiger |
Relaxed | Weniger Gegner, mehr Ressourcen und Loot — für Basenbauer und entspanntes Abenteuern |
Hard | Mehr und aggressivere Gegner — für ein fordernderes Kampferlebnis |
Survival | Zusätzliche Survival-Mechaniken plus aggressivere Gegner |
Custom | Erst mit diesem Preset greifen die Einzelwerte aus gameSettings |
Alle Custom-Einstellungen (gameSettings)
Die folgenden Werte wirken nur, wenn gameSettingsPreset auf "Custom" steht. Faktoren werden im Spiel als Prozentwert angezeigt.
Spieler
| Feld | Default | Bereich | Wirkung |
|---|---|---|---|
playerHealthFactor | 1 | 0.25–4 | Maximale Spieler-Gesundheit |
playerManaFactor | 1 | 0.25–4 | Maximales Mana |
playerStaminaFactor | 1 | 0.25–4 | Maximale Ausdauer |
playerBodyHeatFactor | 1 | 0.5 / 1 / 1.5 / 2 | Körperwärme — höher = länger in Kältegebieten bis zur Unterkühlung |
playerDivingTimeFactor | 1 | 0.5–2 | Sauerstoffvorrat beim Tauchen |
Überleben & Welt
| Feld | Default | Bereich/Optionen | Wirkung |
|---|---|---|---|
enableDurability | true | true/false | Bei false gehen Waffen nicht mehr kaputt |
enableStarvingDebuff | false | true/false | Hunger & Verhungern: Ohne Essen verliert der Spieler periodisch Leben |
foodBuffDurationFactor | 1 | 0.5–2 | Dauer von Nahrungs-Buffs |
fromHungerToStarving | 600000000000 | 5–20 Min. (in Nanosekunden) | Dauer des Hungrig-Zustands, bevor das Verhungern einsetzt |
shroudTimeFactor | 1 | 0.5–2 | Wie lange Spieler im Shroud bleiben können |
tombstoneMode | "AddBackpackMaterials" | AddBackpackMaterials / Everything / NoTombstone | Was beim Tod im Grabstein landet: nur Materialien, alles oder nichts |
enableGliderTurbulences | true | true/false | Luftturbulenzen beim Gleiten |
weatherFrequency | "Normal" | Disabled / Rare / Normal / Often | Häufigkeit von Wetterphänomenen |
fishingDifficulty | "Normal" | VeryEasy / Easy / Normal / Hard / VeryHard | Stärke der Fische im Angel-Minispiel |
curseModifier | "Normal" | Easy / Normal / Hard | Shroud-Fluch: Easy schaltet ihn ab, Hard verdoppelt die Chance |
dayTimeDuration | 1800000000000 (30 Min.) | 2–60 Min. (in Nanosekunden) | Länge des Tages |
nightTimeDuration | 720000000000 (12 Min.) | 2–60 Min. (in Nanosekunden) | Länge der Nacht |
Hinweis
Zeitwerte stehen in Nanosekunden: 1 Minute = 60000000000. Der Standard-Tag hat 30 Minuten (1800000000000), die Standard-Nacht 12 Minuten (720000000000); erlaubt sind je 2 bis 60 Minuten (120000000000 bis 3600000000000).
Gegner & Bosse
| Feld | Default | Bereich/Optionen | Wirkung |
|---|---|---|---|
randomSpawnerAmount | "Normal" | Few / Normal / Many / Extreme | Gegneranzahl in der Welt |
aggroPoolAmount | "Normal" | Few / Normal / Many / Extreme | Wie viele Gegner gleichzeitig angreifen dürfen |
enemyDamageFactor | 1 | 0.25–5 | Gegnerschaden (ohne Bosse) |
enemyHealthFactor | 1 | 0.25–4 | Gegner-Gesundheit (ohne Bosse) |
enemyStaminaFactor | 1 | 0.5–2 | Gegner-Ausdauer — höher = Gegner sind schwerer zu betäuben |
enemyPerceptionRangeFactor | 1 | 0.5–2 | Wie weit Gegner sehen und hören (ohne Bosse) |
bossDamageFactor | 1 | 0.2–5 | Schaden von Boss-Angriffen |
bossHealthFactor | 1 | 0.2–5 | Boss-Gesundheit |
threatBonus | 1 | 0.25–4 | Häufigkeit von Gegnerangriffen (ohne Bosse) |
pacifyAllEnemies | false | true/false | Gegner greifen erst an, wenn sie angegriffen werden (ohne Bosse) |
tamingStartleRepercussion | "LoseSomeProgress" | KeepProgress / LoseSomeProgress / LoseAllProgress | Folgen, wenn Wildtiere beim Zähmen aufgeschreckt werden |
Ressourcen, XP & Wirtschaft
| Feld | Default | Bereich | Wirkung |
|---|---|---|---|
miningDamageFactor | 1 | 0.5–2 | Abbau-Schaden — mehr Terraforming und Ertrag pro Schlag |
plantGrowthSpeedFactor | 1 | 0.25–2 | Wachstumsgeschwindigkeit von Pflanzen |
resourceDropStackAmountFactor | 1 | 0.25–2 | Materialmenge pro Loot-Stack (Kisten, besiegte Gegner …) |
factoryProductionSpeedFactor | 1 | 0.25–2 | Produktionszeiten an Werkstationen |
perkUpgradeRecyclingFactor | 0.5 | 0–1 | Runen-Rückerstattung beim Zerlegen aufgewerteter Waffen |
perkCostFactor | 1 | 0.25–2 | Runen-Kosten für Waffen-Upgrades |
experienceCombatFactor | 1 | 0.25–2 | XP aus Kämpfen |
experienceMiningFactor | 1 | 0–2 | XP aus Ressourcenabbau |
experienceExplorationQuestsFactor | 1 | 0.25–2 | XP aus Erkundung und Quests |
Häufige Fragen
Wie setze ich ein Server-Passwort bei Enshrouded?
Über die userGroups: Das Passwort jeder Gruppe ist gleichzeitig das Beitritts-Passwort. Ohne Passwort in einer Gruppe kann jeder mit deren Rechten joinen — daher für alle Gruppen Passwörter vergeben.
Warum greifen meine gameSettings nicht?
Die Einzelwerte wirken nur, wenn gameSettingsPreset auf "Custom" steht. Bei jedem anderen Preset werden sie ignoriert.
Welchen Port muss ich freigeben?
Nur den queryPort (Standard 15637, UDP). Der frühere separate Game-Port wurde mit Content Update #2 entfernt. Bei RespawnHost sind die Ports bereits fertig eingerichtet.
Meine enshrouded_server.json ist kaputt — was tun? Datei löschen (vorher sichern) und den Server starten: Er erzeugt eine frische Datei mit allen Standardwerten. Nach fehlerhaften Updates der Datei empfiehlt Keen genau dieses Vorgehen.
Verwandte Guides
- Enshrouded Server mieten — bis 16 Slots, in unter 90 Sekunden online
- Server erstellen und einrichten — Von der Bestellung bis zum ersten Login
- Wie viel RAM brauche ich? — Offizielle Hardware-Angaben & Pakete
- Singleplayer-Welt umziehen — Bestehende Welt auf den Server bringen
