{"meta":{"slug":"pterodactyl-arma3","name":"Pterodactyl Arma3","category":"arma","source":"pelican","owner":"pelican-eggs","repo":"games-steamcmd","branch":"main","path":"arma/arma3/egg-pterodactyl-arma3.json","rawUrl":"https://raw.githubusercontent.com/pelican-eggs/games-steamcmd/main/arma/arma3/egg-pterodactyl-arma3.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-10-06T15:23:36-07:00","name":"Arma 3","author":"red_thirten@yahoo.com","description":"Experience true combat gameplay in a massive military sandbox. Deploying a wide variety of single and multiplayer content, over 20 vehicles and 40 weapons, and limitless opportunities for content creation, this is the PC's premier military game. Authentic, diverse, open - Arma 3 sends you to war.","features":["steam_disk_space"],"docker_images":{"ghcr.io/parkervcp/games:arma3":"ghcr.io/parkervcp/games:arma3"},"file_denylist":[],"startup":"./{{SERVER_BINARY}} -par=startup_params_server.txt","config":{"files":"{\r\n \"server.cfg\": {\r\n \"parser\": \"file\",\r\n \"find\": {\r\n \"password=\": \"password = \\\"{{server.build.env.SERVER_PASSWORD}}\\\";\",\r\n \"//password=\": \"password = \\\"{{server.build.env.SERVER_PASSWORD}}\\\";\",\r\n \"password =\": \"password = \\\"{{server.build.env.SERVER_PASSWORD}}\\\";\",\r\n \"//password =\": \"password = \\\"{{server.build.env.SERVER_PASSWORD}}\\\";\",\r\n \"maxPlayers\": \"maxPlayers = {{server.build.env.MAX_PLAYERS}};\",\r\n \"headlessClients\": \"headlessClients[] = { \\\"127.0.0.1\\\" };\",\r\n \"localClient\": \"localClient[] = { \\\"127.0.0.1\\\" };\"\r\n }\r\n },\r\n \"battleye/launch/beserver.cfg\": {\r\n \"parser\": \"file\",\r\n \"find\": {\r\n \"RConPassword\": \"RConPassword {{server.build.env.RCON_PASSWORD}}\",\r\n \"RConPort\": \"RConPort {{server.build.env.RCON_PORT}}\"\r\n }\r\n },\r\n \"battleye/launch/beserver_x64.cfg\": {\r\n \"parser\": \"file\",\r\n \"find\": {\r\n \"RConPassword\": \"RConPassword {{server.build.env.RCON_PASSWORD}}\",\r\n \"RConPort\": \"RConPort {{server.build.env.RCON_PORT}}\"\r\n }\r\n }\r\n}","startup":"{\r\n \"done\": \"Host identity created.\"\r\n}","logs":"{}","stop":"^C"},"scripts":{"installation":{"script":"#!/bin/bash\r\n\r\n## File: Pterodactyl Arma 3 Egg - egg-pterodactyl-arma3.json\r\n## Author: David Wolfe (Red-Thirten)\r\n## Date: 2025/10/06\r\n## License: MIT License\r\n## Image to install with is 'ghcr.io/parkervcp/installers:debian'\r\n\r\n# Download URL for a default Arma 3 server.cfg\r\n# (Feel free to modify to your own preferred, self-hosted file if you wish)\r\nSERVER_CFG_URL=\"https://raw.githubusercontent.com/pelican-eggs/games-steamcmd/main/arma/arma3/egg-arma3-config/server.cfg\"\r\n\r\n# Install packages. Default packages below are skipped if using image noted above, thus speeding up the install process.\r\napt -y update\r\napt -y --no-install-recommends install curl lib32gcc-s1 ca-certificates\r\n\r\n# Check for valid Steam credentials to download Arma 3 with (requires valid Steam account)\r\nif [[ \"${STEAM_USER}\" == \"\" ]] || [[ \"${STEAM_USER}\" == \"anonymous\" ]] || [[ \"${STEAM_PASS}\" == \"\" ]]; then\r\n echo -e \"INSTALLATION ERROR: A valid REAL Steam account is required to download the Arma 3 Dedicated Server.\"\r\n echo -e \"\\t(\\\"anonymous\\\" account cannot be used. Game ownership is not required.)\"\r\n exit 1\r\nfi\r\n\r\n# Download and install SteamCMD\r\ncd /tmp\r\nmkdir -p /mnt/server/steamcmd /mnt/server/steamapps\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\ncd /mnt/server/steamcmd\r\n\r\n# SteamCMD fails otherwise for some reason, even running as root.\r\nchown -R root:root /mnt\r\nexport HOME=/mnt/server\r\n\r\n# Install game server using SteamCMD\r\necho -e \"\\nInstalling/Validating Arma 3 Dedicated Server Files...\"\r\necho -e \"(It is okay to ignore any \\\"SDL\\\", \\\"steamservice\\\", and \\\"thread priority\\\" errors during this process)\"\r\nif [[ -n ${STEAMCMD_BETAID} ]]; then\r\n echo -e \"\\tDownload/Update of \\\"${STEAMCMD_BETAID}\\\" branch enabled.\"\r\nfi\r\necho -e \"\"\r\n./steamcmd.sh +force_install_dir /mnt/server \"+login \\\"${STEAM_USER}\\\" \\\"${STEAM_PASS}\\\"\" +app_update ${STEAMCMD_APPID} $( [[ -n ${STEAMCMD_BETAID} ]] && printf %s \"-beta ${STEAMCMD_BETAID}\" ) validate +quit\r\n\r\n# Set up 32 and 64 bit libraries\r\nmkdir -p /mnt/server/.steam/sdk{32,64}\r\ncp -v linux32/steamclient.so /mnt/server/.steam/sdk32/steamclient.so\r\ncp -v linux64/steamclient.so /mnt/server/.steam/sdk64/steamclient.so\r\n\r\n# Arma 3 setup\r\ncd /mnt/server/\r\n[[ -f server.cfg ]] || curl -sSLO ${SERVER_CFG_URL} # Download default server.cfg file\r\n[[ -f basic.cfg ]] || curl -sSLO ${BASIC_CFG_URL} # Download default basic.cfg file\r\nchmod 644 server.cfg basic.cfg\r\nmkdir -p ./battleye/launch # Create BattlEye config files\r\ntee ./battleye/launch/beserver.cfg ./battleye/launch/beserver_x64.cfg > /dev/null < [!IMPORTANT]\n> **(September 2025) *This Egg has just been majorly updated.*** Please see [How to Update Egg](#how-to-update-egg) to avoid any migration issues!\\\n> \\\n> If you need time to update, you can continue using the old Egg with this image for the time being: `ghcr.io/ptero-eggs/games:arma3`\n___\n\n## Authors / Contributors\n\n\n\n\n \n \n \n \n \n \n
\n \n \"\"/
Red-Thirten\n \n
\n 💻\n 🔨\n 		\n \n \"\"/
Aussie Server Hosts\n \n
\n 💻\n 💡\n 		\n \n \"\"/
IAmSilK\n \n
\n 💻\n 💡\n 		\n \n \"\"/
Daave\n \n
\n 💻\n ⭐\n 💤\n
\n\n\n\n___\n\n### Game Description\n\nFrom Bohemia Interactive's [Website](https://arma3.com/):\n> Experience true combat gameplay in a massive military sandbox. Deploying a wide variety of single and multiplayer content, over 20 vehicles and 40 weapons, and limitless opportunities for content creation, this is the PC’s premier military game. Authentic, diverse, open - Arma 3 sends you to war.\n___\n\n### Egg Capabilities\n\n- Configurable to run 32 or 64-bit versions of the server\n- Max Players is configurable and able to be host enforced (\\*see [Recommended Egg Modifications](#recommended-egg-modifications))\n- Able to download server updates on startup\n- Able to download, update, and load Steam Workshop mods on startup (\\*see [Installation Requirements](#installationsystem-requirements))\n - Accepts uploaded HTML modlist files exported from the Arma 3 Launcher to define mods to load on the server.\n - Also accepts manually listed mods, CDLCs, server-side only mods, and optional client-side only mods.\n - Checks for mod updates against their Steam Workshop page's last update for quick and efficient update checks.\n - Automatically moves mod `.bikey`'s to the `/keys/` directory.\n- Configurable to download Creator DLCs (`creatordlc` branch)\n- Configurable to run Profiling/Performance binaries of the server (if desired; advanced users only)\n- Most popular [Arma 3 startup parameters](https://community.bistudio.com/wiki/Arma_3_Startup_Parameters) can be added via Startup Variables.\n- Configurable to run up to 5 Headless Clients in parallel with the main server (may require additional performance overhead)\n- Configurable to allow remote RCon connections\n- [WHMCS](https://www.whmcs.com/) compatible (\\*see [Recommended Egg Modifications](#recommended-egg-modifications))\n\n___\n\n### Installation/System Requirements\n\n> [!IMPORTANT]\n> - A valid, **real** Steam account, with **Steam Guard turned off**, is required to install the server (default \"anonymous\" login cannot be used). This account *does not* need to own Arma 3 (unless downloading mods; see below). For security reasons it is [recommended by Valve](https://developer.valvesoftware.com/wiki/SteamCMD#With_a_Steam_account) that you create a new Steam account just for your dedicated servers.\n> - For automatic Steam Workshop **mod downloading** to work, the Steam account ***does*** need to ****own Arma 3**. However, this is optional functionality, and mods can be manually uploaded to the server if desired. See [Recommended Egg Modifications](#recommended-egg-modifications) if you would like to disable mod downloading.\n\n| | Bare Minimum | Recommended | Notes |\n|---------|---------|---------|---------|\n| Processor | 2.4 GHz Dual-Core x86-64-v3. No ARM support. | 3.5+ GHz Quad-Core | ARMA 3 is mainly CPU intensive. Contrary to popular belief, the server binary *can* run on multiple cores/threads. However, it's ability to manage asynchronous tasks and hyperthread is somewhat limited, meaning additional cores/threads reach diminishing returns very quickly. In addition, it's ability to utilize all of the CPU allotted to it for AI processing seems to be limited as well. Therefore, a Headless Client ***and*** a properly written mission file are highly recommended if large amounts of AI units will be used. |\n| RAM | 2048 MiB | 4096 MiB | If used, every Headless Client uses an additional 2048 MB of RAM as well. |\n| Storage | 32 GB HDD | 50+ GB SSD | Mods can drastically increase usage if many are downloaded. |\n| Network | 0.512 Mbit/s/player | 1-5 Mbit/s/player | Arma 3 server does not support IPv6 or DSlite IPv4 via IPv6 tunnel. You must have a real IPv4 connection. Multihome (ie. host with multiple WAN IPs) is not supported. |\n| Host OS | Most stable Linux OS branches should work. | Using the latest kernel version for your installed OS can prevent some edge-case installation/boot issues. |\n\n> [!WARNING]\n> It has recently been found that newer CPUs with \"efficiency cores\" can sometimes cause major issues with Arma's performance. If Arma arbitrarily chooses to use any of these cores, this issue can occur.\\\n> \\\n> This issue **should not** be fixed by telling the panel to pin the server to specific CPU cores as this has caused issues in the past. Instead, hosts should manually add the [`-cpuCount`](https://community.bistudio.com/wiki/Arma_3:_Startup_Parameters#cpuCount) or [`-cpuAffinity`](https://community.bistudio.com/wiki/Arma_3:_Startup_Parameters#cpuAffinity) flag to the Startup Command of the Egg/Server.\\\n> \\\n> Which one you should use depends on where your efficiency cores are indexed for your CPU model. Examples for a 24-core CPU:\n> - Cores 0 to 7 are efficiency cores: `-cpuAffinity=0xFFFF00` (use cores 8-24)\n> - Cores 16 to 23 are efficiency cores: `-cpuCount=16` (use cores 0-15)\n\n> [!NOTE]\n> This Egg no longer supports the Wisp SaaS Panel.\n\n___\n\n### Server Ports\n\n> [!TIP]\n> - Default server ports are listed below, but the Main port can be any port.\n> - There are three more ports after the Main port that are relative to the Main port (For example: The BattlEye port is always 4 ports higher than the Main port).\n> - It is [recommended](https://community.bistudio.com/wiki/Arma_3:_Dedicated_Server#Port_Forwarding) that each server on a single host be 100 ports separate from each other.\n\n| Port | Default | Protocol | Required | Notes |\n|---------|---------|---------|---------|---------|\n| **Arma 3 Game & VON** | 2302 | UDP | **Yes** | Must be **Primary** port in panel. |\n| Steam Query (+1) | 2303 | UDP | **Yes** | |\n| Steam Port (+2) | 2304 | UDP | **Yes** | |\n| VON (+3) | 2305 | UDP | No | No need to forward; currently depreciated. |\n| BattleEye traffic (+4) | 2306 | UDP | **Yes** | |\n| BattleEye RCon | 2301 | UDP | No | Can be any port, except for those listed above (including +3). |\n\n___\n\n### Mounting Workshop Mods\n\nServer hosts may wish to save space and avoid download issues by mounting large and/or common mods. Unfortunately, Arma only allows mods to be loaded from directories down-stream of the server binary (ie. `/home/container/*`). This makes properly mounting the mod directories tricky. I have tried both mounting the mod folder directly into the `container` directory, and mounting into `/` (root) with a symlink to the folder placed in `container`. In both scenarios, `ls` showed files were mounted properly, but Arma was not able to see the folder for some reason. If anyone knows a solution to this, please open an Issue to let us know. I have a feeling it might be permissions related to NSS Wrapper, but I'm not sure.\n\n___\n\n### Recommended Egg Modifications\n\nThe following are highly recommended Startup Variable modifications you can make to the Egg after importing it to your panel. While viewing this Egg, simply go to the \"Variables\" tab of the Egg editor to make these changes.\n\n#### Default Steam Username & Password\n\n- To make deploying servers easy (**or if you are using WHMCS**), it is recommended to edit the default values of \"Steam Username\" and \"Steam Password\" to your Steam account dedicated for hosting. This will make all newly installed servers use these credentials. **DO NOT** make these fields visible to the end user so that they can use their own Steam accounts; the panel will save their Steam credentials in **plain text**, which is a BIG NO NO for security and privacy.\n\n#### Restrict Max Players\n\n- If you would like to restrict the maximum number of players that can join your client's server, you can change the permissions of the \"Max Players\" variable so that clients can only view this value (and not edit it). It's default value can also be changed, or the value can be changed on a server-by-server basis as desired.\n\n#### Disable Mod Downloads/Updates\n\n- If the Steam account does not own Arma 3, attempts to download mods will fail. If you would like to prevent end-users from downloading mods, simply delete the following Startup Variables:\n - \"Modlist File (Exported from A3 Launcher)\"\n - \"Additional Mods\"\n - \"[Advanced] Server-Side Only Mods\"\n - \"[Advanced] Optional Client-Side Mods\"\n\n___\n\n### How to Update Egg\n\nIf you already have an Arma 3 Egg installed on your panel, there are a couple things to consider after updating this Egg:\n\n#### September 2025 Update\n\n- Please **delete all existing mod folders** and have the system download and install them again. The mod management system was completely rehauled, and there is unfortunately no easy way to convert the mod files of the old system to the new system. Appologies for this, but the new system will dramatically reduce mod download errors.\n- If you are still getting the \"Your Arma 3 Egg is outdated and no longer supported\" error after updating the Egg, please toggle the \"Disable Verbose Logging\" startup variable on or off once for every server that is using this Egg. This is due to a small bug in the panel where default values for new variables are set to `null` instead of their defaults.\n- If you use a custom Arma3Profile file, **its location and name has changed**. You can move the contents of your old Arma3Profile to its new location at: `/home/container/.local/share/Arma 3 - Other Profiles/server/server.Arma3Profile`\n- The Startup Command has changed, but does not update across all your existing servers. Servers will still boot with their old Startup Command, but will not operate as intended. Servers will have to be manually updated to the new Startup Command via the Startup tab.\n\n#### Pterodactyl specific\n- Startup Variables have been completely re-hauled. While most existing variables have retained their Environment Variable names, some have been completely changed or removed. Simply updating your existing Egg with this Egg may lead to Startup Variables being terribly out of order and cluttered. Therefore, the following steps are recommended to avoid this:\n 1. Inform your end-users that some Startup Variable values may be lost and must be reconfigured.\n 2. Change the name of your existing Arma 3 Egg to \"Arma 3 (Old)\".\n 3. Import this updated Egg.\n 4. Make any Egg modifications you would like. (\\*see [Recommended Egg Modifications](#recommended-egg-modifications))\n 5. Change all existing Arma 3 servers to the new Egg via the Startup tab.\n 6. Delete the old Egg.\n"}