Egg Repository

Pterodactyl Community Egg Repository

HumanitZ

HumanitZ is a co-op, isometric, open world survival game in a world ended by the zombie outbreak. As one of the few human survivors, try to last as long as “humanly” possible. The past can’t be changed, but you can make a difference today for the future of humanity.

Read Me

HumanitZ

Documentation

HumanitZ is a co-op, isometric, open world survival game in a world ended by the zombie outbreak. As one of the few human survivors, try to last as long as “humanly” possible. The past can’t be changed, but you can make a difference today for the future of humanity.

Install notes

The current version of the server software is slightly buggy, and as of this writing has no proper documentation.

They include a README.txt file with the server software, that includes a description of most of the variables, but not more than that. This is only obtainable via the SteamCMD tool.

Installation/System Requirements

Requires a 64-bit processor and operating system

Server Ports

Ports required to run the server in a table format.

Portdefault
Game Port7777
Query Port27015

Notes

7777 is the default port, but any port can be used.

Yolks
NameTag
ghcr.io/ptero-eggs/steamcmd:debianghcr.io/ptero-eggs/steamcmd:debian
Variables and Startup

Startup Command

./TSSGame/Binaries/Linux/TSSGameServer-Linux-Shipping TSSGame -log -port={{SERVER_PORT}} -queryport={{QUERY_PORT}} -steamservername="{{SERVER_NAME}}"

Variables

[REQUIRED] Steam App ID

Steam App ID of HumanitZ Server

Environment Variable: SRCDS_APPID
Default Value: 2728330
User Viewable:
User Editable:
Auto Update

Enable automatic updates on boot

Environment Variable: AUTO_UPDATE
Default Value: 1
User Viewable:
User Editable:
[REQUIRED] Steam Beta Branch

This ensures the script will grab the Linux version of the server

Environment Variable: SRCDS_BETAID
Default Value: linuxbranch
User Viewable:
User Editable:
[REQUIRED] Steam Query Port

Steam Query Port

Environment Variable: QUERY_PORT
Default Value: 27015
User Viewable:
User Editable:
Server Name

Name of the server

Environment Variable: SERVER_NAME
Default Value: HumanitZ [Dedicated]
User Viewable:
User Editable:
Server Password

Server password (if any)

Environment Variable: PASSWORD
Default Value:
User Viewable:
User Editable:
Save Name

Name of the save-file for the server

Environment Variable: SAVE_NAME
Default Value: DedicatedSaveMP
User Viewable:
User Editable:
Admin Password

Password for the admin

Environment Variable: ADMIN_PASS
Default Value:
User Viewable:
User Editable:
Max Players

Maximum number of players allowed

Environment Variable: MAX_PLAYERS
Default Value: 16
User Viewable:
User Editable:
Only Allowed Players

Restrict server to allowed players only

Environment Variable: ONLY_ALLOWED_PLAYERS
Default Value: 0
User Viewable:
User Editable:
Saving World Interval

Save game every x seconds.

Environment Variable: SAVE_INTERVAL_SEC
Default Value: 300
User Viewable:
User Editable:
Permanent Death

0=Off, 1=Individual perma-death, 2=All players experience perma-death

Environment Variable: PERMA_DEATH
Default Value: 0
User Viewable:
User Editable:
On Death

0=Only lose backpack, and weapon in hand, 1=Previous + pockets, and backpack, 2=All previous + Equipment

Environment Variable: ON_DEATH
Default Value: 2
User Viewable:
User Editable:
PvP

0/1 Off/On. Enable or disable Player vs Player.

Environment Variable: PVP
Default Value: 1
User Viewable:
User Editable:
Clear Infection

0=Respawning does not rid you of the infection, 1=You lose it upon respawning

Environment Variable: CLEAR_INFECTION
Default Value: 1
User Viewable:
User Editable:
Eagle Eye

1=Able to purchase the eagle eye skill, 0=You can't

Environment Variable: EAGLE_EYE
Default Value: 1
User Viewable:
User Editable:
Air Drop

1=Enabled, 0=Disabled. Controls whether air drops are enabled.

Environment Variable: AIR_DROP
Default Value: 1
User Viewable:
User Editable:
Weapon Durability

1=Weapons break when reaching 0% durability except crowbar, 0=Only improvised weapons break at 0% durability

Environment Variable: WEAPON_BREAK
Default Value: 1
User Viewable:
User Editable:
Multiplayer Sleep

1=Time passes if everyone performs the sleep emote at the same time, 0=Passing time is disabled

Environment Variable: MULTIPLAYER_SLEEP
Default Value: 0
User Viewable:
User Editable:
Building Health

Health multiplier of player placed buildings. By default set to "1".

Environment Variable: BUILDING_HEALTH
Default Value: 1
User Viewable:
User Editable:
Loot Respawn

1=Loot does respawn, 0=Never respawn

Environment Variable: LOOT_RESPAWN
Default Value: 1
User Viewable:
User Editable:
Loot Respawn Timer

If loot respawns how long does it take in minutes

Environment Variable: LOOT_RESPAWN_TIMER
Default Value: 60
User Viewable:
User Editable:
Pickup Respawn Timer

Time in minutes it takes to respawn pickups, 0 to disable.

Environment Variable: PICKUP_RESPAWN_TIMER
Default Value: 90
User Viewable:
User Editable:
Loot Rarity

0=Scarce, 1=Low, 2=Default, 3=Plentiful, 4=Abundant

Environment Variable: LOOT_RARITY
Default Value: 2
User Viewable:
User Editable:
Air Drop Interval

Air drop every X day

Environment Variable: AIR_DROP_INTERVAL
Default Value: 1
User Viewable:
User Editable:
Zombie Difficulty (Health)

0=Very Easy, 1=Easy, 2=Default, 3=Hard, 4=Very Hard, 5=Nightmare

Environment Variable: ZOMBIE_DIFF_HEALTH
Default Value: 1
User Viewable:
User Editable:
Zombie Difficulty (Speed)

0=Very Easy, 1=Easy, 2=Default, 3=Hard, 4=Very Hard, 5=Nightmare

Environment Variable: ZOMBIE_DIFF_SPEED
Default Value: 2
User Viewable:
User Editable:
Zombie Difficulty (Damage)

0=Very Easy, 1=Easy, 2=Default, 3=Hard, 4=Very Hard, 5=Nightmare

Environment Variable: ZOMBIE_DIFF_DAMAGE
Default Value: 3
User Viewable:
User Editable:
Human Difficulty

0=Very Easy, 1=Easy, 2=Default, 3=Hard, 4=Very Hard, 5=Nightmare

Environment Variable: HUMAN_DIFFICULTY
Default Value: 3
User Viewable:
User Editable:
Zombie Amount Multiplier

Zombie spawn count multiplier

Environment Variable: ZOMBIE_AMOUNT_MULTI
Default Value: 1
User Viewable:
User Editable:
Human Amount Multiplier

Hostile humans spawn count multiplier

Environment Variable: HUMAN_AMOUNT_MULTI
Default Value: 1
User Viewable:
User Editable:
Zombie Dog Multiplier

Zombie dog spawn count multiplier

Environment Variable: ZOMBIE_DOG_MULTI
Default Value: 1
User Viewable:
User Editable:
Zombie Respawn Timer

Time in minutes for zombies to respawn

Environment Variable: ZOMBIE_RESPAWN_TIMER
Default Value: 90
User Viewable:
User Editable:
Human Respawn Timer

Time in minutes for hostile humans to respawn

Environment Variable: HUMAN_RESPAWN_TIMER
Default Value: 90
User Viewable:
User Editable:
Animal Respawn Timer

Time in minutes for animals to respawn

Environment Variable: ANIMAL_RESPAWN_TIMER
Default Value: 90
User Viewable:
User Editable:
Starting Season

0=Summer, 1=Autum, 2=Winter, 3=Spring

Environment Variable: STARTING_SEASON
Default Value: 1
User Viewable:
User Editable:
Days Per Season

How many days each season lasts

Environment Variable: DAYS_PER_SEASON
Default Value: 5
User Viewable:
User Editable:
Day Duration

Day duration in minutes

Environment Variable: DAY_DUR
Default Value: 40
User Viewable:
User Editable:
Night Duration

Night duration in minutes

Environment Variable: NIGHT_DUR
Default Value: 20
User Viewable:
User Editable:
Vital Drain

How fast your vitals drain 0=Slow, 1=Normal, 2=Fast

Environment Variable: VITAL_DRAIN
Default Value: 1
User Viewable:
User Editable:
Dog Companions Enabled

Enable finding dog companions you can recruit

Environment Variable: DOG_ENABLED
Default Value: 1
User Viewable:
User Editable:
Dog Companion Amount

Number of companion dogs that could spawn randomly

Environment Variable: DOG_NUM
Default Value: 8
User Viewable:
User Editable:
Recruit Companion Dogs

Allow players to recruit companion dog

Environment Variable: RECRUIT_DOG
Default Value: 1
User Viewable:
User Editable:
Companion Health

Dog companion health - 0=Low 1=Default 2=High

Environment Variable: COMPANION_HEALTH
Default Value: 1
User Viewable:
User Editable:
Companion Damage

Dog companion damage - 0=Low 1=Default 2=High

Environment Variable: COMPANION_DMG
Default Value: 1
User Viewable:
User Editable:
No Death Feedback

0 to enable player died notification in chat - 1 to disable player died notification in chat.

Environment Variable: NO_DEATH_FEEDBACK
Default Value: 0
User Viewable:
User Editable:
Allow Dismantle

1 = Enable players to dismantle their own buildings, 0 = Disable

Environment Variable: ALLOW_DISMANTLE
Default Value: 1
User Viewable:
User Editable:
Allow House Dismantle

1 = Players are able to dismantle house props, 0 = Disable

Environment Variable: ALLOW_HOUSE_DISMANTLE
Default Value: 1
User Viewable:
User Editable:
Territory

1 = Enabled. In PVE you are not allowed to build in someone's spawn point area. Only non recruit clan members can. 0 = Disable

Environment Variable: TERRITORY
Default Value: 1
User Viewable:
User Editable:
Decay

By default 3600, the crafted "Spawn Point" loses 1 durability every 1 hour. This is used to deal with territory build restrictions, so players have to repair their spawn point.

Environment Variable: DECAY
Default Value: 3600
User Viewable:
User Editable:
Pickup Cleanup

How long in minutes it takes for dropped pickups to be destroyed (Pickups part of the world will not be considered), a value of 0 means no cleanup is done.

Environment Variable: PICKUP_CLEANUP
Default Value: 3000
User Viewable:
User Editable:
Fake Building Cleanup

How long in minutes it takes for the white blueprint building to be destroyed, a value of 0 means no cleanup is done.

Environment Variable: FAKE_BUILDING_CLEANUP
Default Value: 3000
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 

## 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

## making server files executable
chmod +x /mnt/server/TSSGame/Binaries/Linux/TSSGameServer-Linux-Shipping

## install end
echo "-----------------------------------------"
echo "Installation completed..."
echo "-----------------------------------------"
Installation Imageghcr.io/ptero-eggs/installers:debianInstallation Entrypointbash