Egg Repository

Pterodactyl Community Egg Repository

Palworld Proton

Fight, farm, build and work alongside mysterious creatures called "Pals" in this completely new multiplayer, open world survival and crafting game!

Read Me

Palworld

Steam Description

Fight, farm, build and work alongside mysterious creatures called "Pals" in this completely new multiplayer, open world survival and crafting game!

Authors / Contributors

Known Issues / FAQ

  1. The server won't show up in the Community-Server tab. -> This is a known problem and the devs will hopefully fix that asap. Best choice is to connect by IP and Password.

  2. The server has a memory leak. -> This is also an issue that they are aware of. -> The bEnableInvaderEnemy option seems to have a huge impact on the current RAM usage. Disabling it might be choice. -> Tip: Schedule a server restart every 6h. You might adjust the value according to your system!

  3. The server does not show up in the steam server list. -> This is currently and might never be supported.

  4. The config file gets deleted / reset on server restart. -> Before editing the config file always make sure to fully stop the server first. Otherwise all changes wont be saved.

Recommended server settings

RAM

Due to at least one memory leak the server requires about 16-32GB RAM. Referring to the official documentation you can start the server with 8GB but you will run out of memory very quickly. The minimum should be 16GB but 32GB are fairly recommended for now.

CPU

Intel / AMD processor with at least 4 cores.

Storage

As of January 19th 2024 the server requires about 5GB of storage capacity. This might extend with further content/updates.

Server Ports

Port Default
Game 8211
RCON (optional) 25575

The RCON port does not need to be allocated.

Updating

  1. Update your egg
  2. Update the startup of all already made servers to the one that now comes with the egg
  3. Then hit reinstall because the parser application has to be downloaded
  4. Because the Palworld devs forgot with the v0.1.5.0 to add the new bShowPlayerList key to the config you will need to add it yourself. This maybe fixt in the future. Its default value is False

Example of the end of the config: bUseAuth=True,bShowPlayerList=False,BanListURL="https://api.palworldgame.com/api/banlist.txt")

Variable Parsing

The parser application that is currently being shipped is capable of editing all variables that are present in the Palworld configuration file as of February 1, 2024.

However, only the most basic and necessary variables are present in the egg. Those who need more variables will have to add them themselves.

See a list of what key matches with what variable Here

Variables that do not exist will automatically be skipped parsing so you do not have to worry about it emptying your config file

Proton

There is a special egg that uses proton instad of the native linux version what shipes with winmm.dll and RE-UE4SS so for they who want to run mods then that is possible.

Keep in mind this eggs console output is broken (thanks proton / wine) so you will only see the parser output. The RCON console does still work.

Config

The config is found at the following path: Pal/Saved/Config/LinuxServer/PalWorldSettings.ini or if you are running the proton egg Pal/Saved/Config/WindowsServer/PalWorldSettings.ini

Yolks
NameTag
Protonghcr.io/ptero-eggs/steamcmd:proton
Variables
NameDescriptionEnvironment VariableDefault ValueUser ViewableUser Editable
App IDDo not edit!SRCDS_APPID2394010NoNo
Auto UpdateAuto update the server on start.AUTO_UPDATE1YesYes
Max PlayersMAX_PLAYERS32YesYes
Server NameSERVER_NAMEA Pterodactyl hosted Palworld ServerYesYes
Server PasswordIf specified, players must provide this password to join the server.SERVER_PASSWORDYesYes
Admin PasswordIf specified, players must provide this password (via the in-game chat or RCON) to gain access to administrator commands on the server.ADMIN_PASSWORDYesYes
Public IPSet this to the server public ip address. Only needed if the allocation is a local ip, else the allocate ip will be used automaticallyPUBLIC_IPYesNo
RCON PortDoes not need to be allocated!RCON_PORT25575YesNo
Enable RCONMust Be ONRCON_ENABLETrueNoNo
Server DescriptionThe description of the server.SERVER_DESCRIPTIONYesYes
WINDOWS_INSTALLWINDOWS_INSTALL1NoNo
Connection PlatfromThe platform players will be able to connect fromALLOW_CONNECT_PLATFORMSteamYesYes
Install Script
#!/bin/bash
# steamcmd Base Installation Script
#
# Server Files: /mnt/server
# Image to install with is 'ghcr.io/ptero-eggs/installers:debian'


# 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

## add below your custom commands if needed
## copy template config file
echo "Copy template config file into config folder!"

if [ -f "/mnt/server/Pal/Saved/Config/WindowsServer/PalWorldSettings.ini" ]; then
    echo "Config file already exitis, backing up and overwriting with a new one"
    mv /mnt/server/Pal/Saved/Config/WindowsServer/PalWorldSettings.ini /mnt/server/Pal/Saved/Config/WindowsServer/PalWorldSettings_$(date +"%Y%m%d%H%M%S").ini
    cp /mnt/server/DefaultPalWorldSettings.ini /mnt/server/Pal/Saved/Config/WindowsServer/PalWorldSettings.ini
else 
    echo "Creating new config file"
    mkdir -p /mnt/server/Pal/Saved/Config/WindowsServer
    cp /mnt/server/DefaultPalWorldSettings.ini /mnt/server/Pal/Saved/Config/WindowsServer/PalWorldSettings.ini
fi

cd /mnt/server
# Download self made replace tool
echo "Downloading config parser aplication"
curl -sSL -o PalworldServerConfigParser https://github.com/pelican-eggs/Palworld-Config-Parser-Tool/releases/latest/download/PalworldServerConfigParser-linux-amd64
chmod +x PalworldServerConfigParser

cd /tmp
curl -sSL -o /mnt/server/Pal/Binaries/Win64/winmm.dll https://raw.githubusercontent.com/ptero-eggs/game-eggs/main/palworld/winmm.dll

LATEST_JSON=$(curl --silent "https://api.github.com/repos/UE4SS-RE/RE-UE4SS/releases/latest")
MATCH="UE4SS_"
DOWNLOAD_URL=$(echo ${LATEST_JSON} | jq .assets | jq -r .[].browser_download_url | grep -i ${MATCH})
echo ${DOWNLOAD_URL}
curl -sSL -o ue4ss.zip ${DOWNLOAD_URL}
unzip -o ue4ss.zip -d /mnt/server/Pal/Binaries/Win64

## install end
echo "-----------------------------------------"
echo "Installation completed..."
echo "-----------------------------------------"