Egg Repository

Pterodactyl Community Egg Repository

Enshrouded

Enshrouded is a game of survival, crafting, and Action RPG combat, set within a sprawling voxel-based continent. As you journey across the mountains and deserts of an open world, you are free to choose your path and shape your destiny.

Read Me

Enshrouded

Game Description

Enshrouded is a game of survival, crafting, and Action RPG combat, set within a sprawling voxel-based continent. As you journey across the mountains and deserts of an open world, you are free to choose your path and shape your destiny.

Ignite the Ancient power of the Flame, and piece together the fragments of a story that unfolds below the surface.

Usefull links

Author & Contributers

NameGithub ProfileBuy me a Coffee
Red-Banana-Officialhttps://github.com/Red-Banana-Official/
Vapokhttps://github.com/Vapokhttps://www.buymeacoffee.com/vapok
QuintenQVD0https://github.com/QuintenQVD0/
gOOvERhttps://github.com/gOOvERhttps://ko-fi.com/B0B351D0Q

Server Ports

By default Enshrouded requires 1 port.

Portdefault
Game/Query15637

Configuration

Where is the Server Configuration Stored?

The Enshrouded dedicated server configuration is stored in enshrouded_server.json, which is automatically managed by this egg.

Instead of manually editing this file, you can set most key values directly in the Pterodactyl Panel using environment variables.


How to Configure the Server

Most settings can be modified via Pterodactyl's environment variables.
Go to your Pterodactyl Panel → Server Settings, where you can edit:

  • Server Name (SRV_NAME) – The name players will see in the server list.
  • User Group Passwords:
    • Admin Group (SRV_PW) – Grants admin privileges.
    • Friend Group (SRV_PW2) – Grants reduced admin privileges.
    • Guest Group (SRV_PW3) – General access for users.
  • Max Players (MAX_PLAYERS) – Number of player slots (1-16).

Other settings, such as game settings, IP binding, and log locations, are still managed in enshrouded_server.json


Default Configuration File (enshrouded_server.json)

On first startup, the server will generate the following structure:

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

Installation/System Requirements

RecommendedExtra info
ProcessorRecent x86/64 (AMD/Intel) processor.You need min 4 Cores for the Server.
RAM4-6 GB
Storage30 GB (or more, depending on save size or frequency)

Server not showing in Serverlist?

The fact that the server is not displayed in the server list is a known problem.

As a workaround, you can add the server as a favourite via IP:queryport in the Steam server browser. The server should then be at the top of the ingame server list

Yolks
NameTag
ghcr.io/ptero-eggs/steamcmd:protonghcr.io/ptero-eggs/steamcmd:proton
Variables and Startup

Startup Command

rm ./logs/enshrouded_server.log; proton run ./enshrouded_server.exe & ENS_PID=$! ; tail -c0 -F ./logs/enshrouded_server.log --pid=$ENS_PID

Variables

[SERVER] Server Name

Name of the server

Environment Variable: SRV_NAME
Default Value: My Enshrouded Server
User Viewable:
User Editable:
[SERVER] Max Players

Maximum number of players allowed

Environment Variable: MAX_PLAYERS
Default Value: 16
User Viewable:
User Editable:
[USER GROUP] ''Admin'' Group Password

Password for the Admin user-group. Players using this password get: The passwords for the usergroups can not all be the same or empty - canAccessInventories: true - canEditBase: true - canExtendBase: true - canKickBan: true. The passwords for the usergroups can not all be the same/ empty

Environment Variable: SRV_PW
Default Value: ChangeMe1
User Viewable:
User Editable:
[USER GROUP] ''Friend'' Group Password

Password for the Friend user-group. Players using this password get: The passwords for the usergroups can not all be the same or empty - canAccessInventories: true - canEditBase: true - canExtendBase: true - canKickBan: false. The passwords for the usergroups can not all be the same/ empty

Environment Variable: SRV_PW2
Default Value: ChangeMe2
User Viewable:
User Editable:
[USER GROUP] ''Guest'' Group Password

Password for the Guest user-group. Players using this password get: The passwords for the usergroups can not all be the same or empty - canAccessInventories: false - canEditBase: false - canExtendBase: false - canKickBan: false. The passwords for the usergroups can not all be the same/ empty

Environment Variable: SRV_PW3
Default Value: ChangeMe3
User Viewable:
User Editable:
[STEAM] Steam App ID

Steam App ID

Environment Variable: SRCDS_APPID
Default Value: 2278520
User Viewable:
User Editable:
[SYSTEM] Windows Install

Whether to install the Windows version

Environment Variable: WINDOWS_INSTALL
Default Value: 1
User Viewable:
User Editable:
[SYSTEM] Auto Update

Enable automatic updates on boot

Environment Variable: AUTO_UPDATE
Default Value: 1
User Viewable:
User Editable:
[SYSTEM] Validate

Validate the server files through Steam

Environment Variable: VALIDATE
Default Value: 0
User Viewable:
User Editable:
Install Script
#!/bin/bash
# steamcmd Base Installation Script
#
# Server Files: /mnt/server
# Image to install with is 'ghcr.io/ptero-eggs/installers:debian'
#
# Variables
# STEAM_USER, STEAM_PASS, STEAM_AUTH - Steam user setup. If a user has 2fa enabled it will most likely fail due to timeout. Leave blank for anon install.
# WINDOWS_INSTALL - if it's a windows server you want to install set to 1
# SRCDS_APPID - steam app id found here - https://developer.valvesoftware.com/wiki/Dedicated_Servers_List
# SRCDS_BETAID - beta branch of a steam app. Leave blank to install normal branch
# SRCDS_BETAPASS - password for a beta branch should one be required during private or closed testing phases.. Leave blank for no password.
# INSTALL_FLAGS - Any additional SteamCMD  flags to pass during install.. Keep in mind that steamcmd auto update process in the docker image might overwrite or ignore these when it performs update on server boot.
# AUTO_UPDATE - Adding this variable to the egg allows disabling or enabling automated updates on boot. Boolean value. 0 to disable and 1 to enable.
#

# Install packages. Default packages below are not required if using our existing install image thus speeding up the install process.
#apt -y update
#apt -y --no-install-recommends install curl lib32gcc-s1 ca-certificates

## just in case someone removed the defaults.
if [[ "${STEAM_USER}" == "" ]] || [[ "${STEAM_PASS}" == "" ]]; then
    echo -e "steam user is not set.\n"
    echo -e "Using anonymous user.\n"
    STEAM_USER=anonymous
    STEAM_PASS=""
    STEAM_AUTH=""
else
    echo -e "user set to ${STEAM_USER}"
fi

## Download and install SteamCMD
cd /tmp
mkdir -p /mnt/server/steamcmd
curl -sSL -o steamcmd.tar.gz https://steamcdn-a.akamaihd.net/client/installer/steamcmd_linux.tar.gz
tar -xzvf steamcmd.tar.gz -C /mnt/server/steamcmd
mkdir -p /mnt/server/steamapps # Fix steamcmd disk write error when this folder is missing
cd /mnt/server/steamcmd

# SteamCMD fails otherwise for some reason, even running as root.
# This is changed at the end of the install process anyways.
chown -R root:root /mnt
export HOME=/mnt/server

## install game using steamcmd
./steamcmd.sh +force_install_dir /mnt/server +login ${STEAM_USER} ${STEAM_PASS} ${STEAM_AUTH} $( [[ "${WINDOWS_INSTALL}" == "1" ]] && printf %s '+@sSteamCmdForcePlatformType windows' ) +app_update ${SRCDS_APPID} $( [[ -z ${SRCDS_BETAID} ]] || printf %s "-beta ${SRCDS_BETAID}" ) $( [[ -z ${SRCDS_BETAPASS} ]] || printf %s "-betapassword ${SRCDS_BETAPASS}" ) ${INSTALL_FLAGS} validate +quit ## other flags may be needed depending on install. looking at you cs 1.6

## set up 32 bit libraries
mkdir -p /mnt/server/.steam/sdk32
cp -v linux32/steamclient.so ../.steam/sdk32/steamclient.so

## set up 64 bit libraries
mkdir -p /mnt/server/.steam/sdk64
cp -v linux64/steamclient.so ../.steam/sdk64/steamclient.so

## Downloading the servers default config file
FILE=$HOME/enshrouded_server.json
if [ -f "$FILE" ]; then
  echo -e "ennshrouded_server.json configuration found"
else  
  echo -e "No enshrouded_server.json found. Downloading default configuration.."
  cd $HOME
  curl -sSL -o enshrouded_server.json https://raw.githubusercontent.com/Ptero-Eggs/game-eggs/refs/heads/main/enshrouded/enshrouded_server.json
  echo -e "Configuration file downloaded"
fi

## End of installation
echo -e "${BLUE}-------------------------------------------------${NC}"
echo -e "${GREEN}Installation completed...${NC}"
echo -e "${BLUE}-------------------------------------------------${NC}"
Installation Imageghcr.io/ptero-eggs/installers:debianInstallation Entrypointbash