{"meta":{"slug":"enshrouded","name":"Enshrouded","category":"enshrouded","source":"pterodactyl","owner":"pterodactyl","repo":"game-eggs","branch":"main","path":"enshrouded/egg-enshrouded.json","rawUrl":"https://raw.githubusercontent.com/pterodactyl/game-eggs/main/enshrouded/egg-enshrouded.json","indexedAt":1792246788483},"egg":{"_comment":"DO NOT EDIT: FILE GENERATED AUTOMATICALLY BY PTERODACTYL PANEL - PTERODACTYL.IO","meta":{"version":"PTDL_v2","update_url":null},"exported_at":"2025-11-11T10:40:06+01:00","name":"Enshrouded","author":"ptero@redbananaofficial.com","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.","features":["steam_disk_space"],"docker_images":{"ghcr.io/ptero-eggs/steamcmd:proton":"ghcr.io/ptero-eggs/steamcmd:proton"},"file_denylist":[],"startup":"rm ./logs/enshrouded_server.log; proton run ./enshrouded_server.exe & ENS_PID=$! ; tail -c0 -F ./logs/enshrouded_server.log --pid=$ENS_PID","config":{"files":"{\r\n    \"enshrouded_server.json\": {\r\n        \"parser\": \"json\",\r\n        \"find\": {\r\n            \"name\": \"{{server.build.env.SRV_NAME}}\",\r\n            \"queryPort\": \"{{server.build.default.port}}\",\r\n            \"slotCount\": \"{{server.build.env.MAX_PLAYERS}}\",\r\n            \"userGroups[0].password\": \"{{server.build.env.SRV_PW}}\",\r\n            \"userGroups[1].name\": \"Friend\",\r\n            \"userGroups[1].password\": \"{{server.build.env.SRV_PW2}}\",\r\n            \"userGroups[2].name\": \"Guest\",\r\n            \"userGroups[2].password\": \"{{server.build.env.SRV_PW3}}\",\r\n            \"userGroups[3].name\": \"Visitor\",\r\n            \"userGroups[3].password\": \"{{server.build.env.SRV_PW4}}\"\r\n        }\r\n    }\r\n}","startup":"{\r\n    \"done\": \"[Session] 'HostOnline' (up)!\"\r\n}","logs":"{}","stop":"^C"},"scripts":{"installation":{"script":"#!/bin/bash\r\n# steamcmd Base Installation Script\r\n#\r\n# Server Files: /mnt/server\r\n# Image to install with is 'ghcr.io/ptero-eggs/installers:debian'\r\n#\r\n# Variables\r\n# 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.\r\n# WINDOWS_INSTALL - if it's a windows server you want to install set to 1\r\n# SRCDS_APPID - steam app id found here - https://developer.valvesoftware.com/wiki/Dedicated_Servers_List\r\n# SRCDS_BETAID - beta branch of a steam app. Leave blank to install normal branch\r\n# SRCDS_BETAPASS - password for a beta branch should one be required during private or closed testing phases.. Leave blank for no password.\r\n# 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.\r\n# 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.\r\n#\r\n\r\n# Install packages. Default packages below are not required if using our existing install image thus speeding up the install process.\r\n#apt -y update\r\n#apt -y --no-install-recommends install curl lib32gcc-s1 ca-certificates\r\n\r\n## just in case someone removed the defaults.\r\nif [[ \"${STEAM_USER}\" == \"\" ]] || [[ \"${STEAM_PASS}\" == \"\" ]]; then\r\n    echo -e \"steam user is not set.\\n\"\r\n    echo -e \"Using anonymous user.\\n\"\r\n    STEAM_USER=anonymous\r\n    STEAM_PASS=\"\"\r\n    STEAM_AUTH=\"\"\r\nelse\r\n    echo -e \"user set to ${STEAM_USER}\"\r\nfi\r\n\r\n## Download and install SteamCMD\r\ncd /tmp\r\nmkdir -p /mnt/server/steamcmd\r\ncurl -sSL -o steamcmd.tar.gz https://steamcdn-a.akamaihd.net/client/installer/steamcmd_linux.tar.gz\r\ntar -xzvf steamcmd.tar.gz -C /mnt/server/steamcmd\r\nmkdir -p /mnt/server/steamapps # Fix steamcmd disk write error when this folder is missing\r\ncd /mnt/server/steamcmd\r\n\r\n# SteamCMD fails otherwise for some reason, even running as root.\r\n# This is changed at the end of the install process anyways.\r\nchown -R root:root /mnt\r\nexport HOME=/mnt/server\r\n\r\n## install game using steamcmd\r\n./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\r\n\r\n## set up 32 bit libraries\r\nmkdir -p /mnt/server/.steam/sdk32\r\ncp -v linux32/steamclient.so ../.steam/sdk32/steamclient.so\r\n\r\n## set up 64 bit libraries\r\nmkdir -p /mnt/server/.steam/sdk64\r\ncp -v linux64/steamclient.so ../.steam/sdk64/steamclient.so\r\n\r\n## Downloading the servers default config file\r\nFILE=$HOME/enshrouded_server.json\r\nif [ -f \"$FILE\" ]; then\r\n  echo -e \"ennshrouded_server.json configuration found\"\r\nelse  \r\n  echo -e \"No enshrouded_server.json found. Downloading default configuration..\"\r\n  cd $HOME\r\n  curl -sSL -o enshrouded_server.json https://raw.githubusercontent.com/Ptero-Eggs/game-eggs/refs/heads/main/enshrouded/enshrouded_server.json\r\n  echo -e \"Configuration file downloaded\"\r\nfi\r\n\r\n## End of installation\r\necho -e \"${BLUE}-------------------------------------------------${NC}\"\r\necho -e \"${GREEN}Installation completed...${NC}\"\r\necho -e \"${BLUE}-------------------------------------------------${NC}\"","container":"ghcr.io/ptero-eggs/installers:debian","entrypoint":"bash"}},"variables":[{"name":"[SERVER] Server Name","description":"Name of the server","env_variable":"SRV_NAME","default_value":"My Enshrouded Server","user_viewable":true,"user_editable":true,"rules":"required|string","field_type":"text"},{"name":"[SERVER] Max Players","description":"Maximum number of players allowed","env_variable":"MAX_PLAYERS","default_value":"16","user_viewable":true,"user_editable":true,"rules":"required|numeric","field_type":"text"},{"name":"[USER GROUP] ''Admin'' Group Password","description":"Password for the Admin user-group.\r\nPlayers using this password get:\r\n- canAccessInventories: true\r\n- canEditBase: true\r\n- canExtendBase: true\r\n- canKickBan: true.\r\nThe passwords for the usergroups can not all be the same/empty/only numerical","env_variable":"SRV_PW","default_value":"ChangeMe1","user_viewable":true,"user_editable":true,"rules":"required|string|not_regex:/^\\d+$/","field_type":"text"},{"name":"[USER GROUP] ''Friend'' Group Password","description":"Password for the Friend user-group.\r\nPlayers using this password get:\r\n- canAccessInventories: true\r\n- canEditBase: true\r\n- canExtendBase: true\r\n- canKickBan: false.\r\nThe passwords for the usergroups can not all be the same/empty/only numerical","env_variable":"SRV_PW2","default_value":"ChangeMe2","user_viewable":true,"user_editable":true,"rules":"required|string|not_regex:/^\\d+$/","field_type":"text"},{"name":"[USER GROUP] ''Guest'' Group Password","description":"Password for the Guest user-group.\r\nPlayers using this password get:\r\n- canAccessInventories: false\r\n- canEditBase: false\r\n- canExtendBase: false\r\n- canKickBan: false.\r\nThe passwords for the usergroups can not all be the same/empty/only numerical","env_variable":"SRV_PW3","default_value":"ChangeMe3","user_viewable":true,"user_editable":true,"rules":"required|string|not_regex:/^\\d+$/","field_type":"text"},{"name":"[USER GROUP] ''Visitor'' Group Password","description":"Password for the Visitor user-group.\r\nPlayers using this password get:\r\n- canAccessInventories: false\r\n- canEditBase: false\r\n- canExtendBase: false\r\n- canKickBan: false\r\n- canEditWorld: false\r\nThe passwords for the usergroups can not all be the same/empty/only numerical","env_variable":"SRV_PW4","default_value":"ChangeMe4","user_viewable":true,"user_editable":true,"rules":"required|string|not_regex:/^\\d+$/","field_type":"text"},{"name":"[STEAM] Steam App ID","description":"Steam App ID","env_variable":"SRCDS_APPID","default_value":"2278520","user_viewable":false,"user_editable":false,"rules":"required|string|in:2278520","field_type":"text"},{"name":"[SYSTEM] Windows Install","description":"Whether to install the Windows version","env_variable":"WINDOWS_INSTALL","default_value":"1","user_viewable":false,"user_editable":false,"rules":"required|boolean","field_type":"text"},{"name":"[SYSTEM] Auto Update","description":"Enable automatic updates on boot","env_variable":"AUTO_UPDATE","default_value":"1","user_viewable":true,"user_editable":true,"rules":"required|boolean","field_type":"text"},{"name":"[SYSTEM] Validate","description":"Validate the server files through Steam","env_variable":"VALIDATE","default_value":"0","user_viewable":true,"user_editable":true,"rules":"required|boolean","field_type":"text"}]},"readme":"# Enshrouded\n\n### Game Description\n\nEnshrouded 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.\n\nIgnite the Ancient power of the Flame, and piece together the fragments of a story that unfolds below the surface.\n\n### Usefull links\n\n- Homepage: https://enshrouded.com/\n- Steam: https://store.steampowered.com/app/1203620/Enshrouded/\n- Wiki: https://enshrouded.wiki.gg/wiki/Enshrouded_Wiki\n- Discord: https://discord.gg/enshrouded\n\n### Author & Contributers\n| Name        | Github Profile  | Buy me a Coffee |\n| ------------- |-------------|-------------|\n|   Red-Banana-Official  | https://github.com/Red-Banana-Official | / |\n|   Vapok   | https://github.com/Vapok | https://www.buymeacoffee.com/vapok |\n|   QuintenQVD0   | https://github.com/QuintenQVD0 | / |\n|   gOOvER   | https://github.com/gOOvER | https://ko-fi.com/B0B351D0Q  |\n\n### Server Ports\n\nBy default Enshrouded requires 1 port.\n\n| Port    | default       |\n|---------|---------------|\n|Game/Query   |     15637     |\n\n## Configuration\n\n### **Where is the Server Configuration Stored?**\nThe Enshrouded dedicated server configuration is stored in `enshrouded_server.json`, which is automatically managed by this egg.\n\nInstead of manually editing this file, **you can set most key values directly in the Pterodactyl Panel** using environment variables.\n\n---\n\n### **How to Configure the Server**\n**Most settings can be modified via Pterodactyl's environment variables.**  \nGo to your **Pterodactyl Panel → Server Settings**, where you can edit:\n- **Server Name (`SRV_NAME`)** – The name players will see in the server list.\n- **User Group Passwords**:\n  - **Admin Group (`SRV_PW`)** – Grants admin privileges.\n  - **Friend Group (`SRV_PW2`)** – Grants reduced admin privileges.\n  - **Guest Group (`SRV_PW3`)** – General access for users.\n  - **Visitor Group (`SRV_PW4`)** – Minimal access for visitors.\n- **Max Players (`MAX_PLAYERS`)** – Number of player slots (1-16).\n\nOther settings, such as **game settings, IP binding, and log locations**, are still managed in `enshrouded_server.json`\n\n---\n\n### **Default Configuration File (`enshrouded_server.json`)**\nOn first startup, the server will generate the following structure:\n\n```json\n{\n    \"enableTextChat\": false,\n    \"enableVoiceChat\": false,\n    \"gameSettings\": {\n        \"aggroPoolAmount\": \"Normal\",\n        \"bossDamageFactor\": 1,\n        \"bossHealthFactor\": 1,\n        \"dayTimeDuration\": 1800000000000,\n        \"enableDurability\": true,\n        \"enableGliderTurbulences\": true,\n        \"enableStarvingDebuff\": false,\n        \"enemyDamageFactor\": 1,\n        \"enemyHealthFactor\": 1,\n        \"enemyPerceptionRangeFactor\": 1,\n        \"enemyStaminaFactor\": 1,\n        \"experienceCombatFactor\": 1,\n        \"experienceExplorationQuestsFactor\": 1,\n        \"experienceMiningFactor\": 1,\n        \"factoryProductionSpeedFactor\": 1,\n        \"foodBuffDurationFactor\": 1,\n        \"fromHungerToStarving\": 600000000000,\n        \"miningDamageFactor\": 1,\n        \"nightTimeDuration\": 720000000000,\n        \"pacifyAllEnemies\": false,\n        \"perkCostFactor\": 1,\n        \"perkUpgradeRecyclingFactor\": 0.5,\n        \"plantGrowthSpeedFactor\": 1,\n        \"playerBodyHeatFactor\": 1,\n        \"playerHealthFactor\": 1,\n        \"playerManaFactor\": 1,\n        \"playerStaminaFactor\": 1,\n        \"randomSpawnerAmount\": \"Normal\",\n        \"resourceDropStackAmountFactor\": 1,\n        \"shroudTimeFactor\": 1,\n        \"tamingStartleRepercussion\": \"LoseSomeProgress\",\n        \"threatBonus\": 1,\n        \"tombstoneMode\": \"AddBackpackMaterials\",\n        \"weatherFrequency\": \"Normal\",\n        \"playerDivingTimeFactor\": 1,\n        \"fishingDifficulty\": \"Normal\",\n        \"curseModifier\": \"Normal\"\n    },\n    \"gameSettingsPreset\": \"Default\",\n    \"ip\": \"0.0.0.0\",\n    \"logDirectory\": \"./logs\",\n    \"name\": \"My Enshrouded Server\",\n    \"queryPort\": 15637,\n    \"saveDirectory\": \"./savegame\",\n    \"slotCount\": 16,\n    \"tags\": [],\n    \"userGroups\": [\n        {\n            \"canAccessInventories\": true,\n            \"canEditBase\": true,\n            \"canExtendBase\": true,\n            \"canKickBan\": true,\n            \"canEditWorld\": true,\n            \"name\": \"Admin\",\n            \"password\": \"ChangeMe1\",\n            \"reservedSlots\": 0\n        },\n        {\n            \"canAccessInventories\": true,\n            \"canEditBase\": true,\n            \"canExtendBase\": true,\n            \"canKickBan\": false,\n            \"canEditWorld\": true,\n            \"name\": \"Friend\",\n            \"password\": \"ChangeMe2\",\n            \"reservedSlots\": 1\n        },\n        {\n            \"canAccessInventories\": false,\n            \"canEditBase\": false,\n            \"canExtendBase\": false,\n            \"canKickBan\": false,\n            \"canEditWorld\": false,\n            \"name\": \"Guest\",\n            \"password\": \"ChangeMe3\",\n            \"reservedSlots\": 3\n        },\n        {\n            \"canAccessInventories\": false,\n            \"canEditBase\": false,\n            \"canExtendBase\": false,\n            \"canKickBan\": false,\n            \"canEditWorld\": false,\n            \"name\": \"Visitor\",\n            \"password\": \"ChangeMe4\",\n            \"reservedSlots\": 0\n        }\n    ],\n    \"bannedAccounts\": [],\n    \"voiceChatMode\": \"Proximity\"\n}\n```\n\n### Installation/System Requirements\n\n|           | Recommended  | Extra info  |\n|-----------|--------------|-------------|\n| Processor | Recent x86/64 (AMD/Intel) processor. | You need min 4 Cores for the Server. |\n| RAM       |  4-6 GB     |\n| Storage   |  30 GB (or more, depending on save size or frequency) |\n\n### Server not showing in Serverlist?\n\nThe fact that the server is not displayed in the server list is a known problem.\n\nAs a workaround, you can add the server as a favourite via IP:queryport in the Steam server browser.\nThe server should then be at the top of the ingame server list\n"}