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
NameDescriptionEnvironment VariableDefault ValueUser ViewableUser Editable
[SERVER] Server NameName of the serverSRV_NAMEMy Enshrouded ServerYesYes
[SERVER] Max PlayersMaximum number of players allowedMAX_PLAYERS16YesYes
[USER GROUP] ''Admin'' Group PasswordPassword 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/ emptySRV_PWChangeMe1YesYes
[USER GROUP] ''Friend'' Group PasswordPassword 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/ emptySRV_PW2ChangeMe2YesYes
[USER GROUP] ''Guest'' Group PasswordPassword 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/ emptySRV_PW3ChangeMe3YesYes
[STEAM] Steam App IDSteam App IDSRCDS_APPID2278520NoNo
[SYSTEM] Windows InstallWhether to install the Windows versionWINDOWS_INSTALL1NoNo
[SYSTEM] Auto UpdateEnable automatic updates on bootAUTO_UPDATE1YesYes
[SYSTEM] ValidateValidate the server files through SteamVALIDATE0YesYes
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}"