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.
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.
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.
Requires a 64-bit processor and operating system
Ports required to run the server in a table format.
Port | default |
---|---|
Game Port | 7777 |
Query Port | 27015 |
7777 is the default port, but any port can be used.
Name | Tag |
---|---|
ghcr.io/ptero-eggs/steamcmd:debian | ghcr.io/ptero-eggs/steamcmd:debian |
Name | Description | Environment Variable | Default Value | User Viewable | User Editable |
---|---|---|---|---|---|
[REQUIRED] Steam App ID | Steam App ID of HumanitZ Server | SRCDS_APPID | 2728330 | No | No |
Auto Update | Enable automatic updates on boot | AUTO_UPDATE | 1 | Yes | Yes |
[REQUIRED] Steam Beta Branch | This ensures the script will grab the Linux version of the server | SRCDS_BETAID | linuxbranch | No | No |
[REQUIRED] Steam Query Port | Steam Query Port | QUERY_PORT | 27015 | Yes | Yes |
Server Name | Name of the server | SERVER_NAME | HumanitZ [Dedicated] | Yes | Yes |
Server Password | Server password (if any) | PASSWORD | Yes | Yes | |
Save Name | Name of the save-file for the server | SAVE_NAME | DedicatedSaveMP | Yes | Yes |
Admin Password | Password for the admin | ADMIN_PASS | Yes | Yes | |
Max Players | Maximum number of players allowed | MAX_PLAYERS | 16 | Yes | Yes |
Only Allowed Players | Restrict server to allowed players only | ONLY_ALLOWED_PLAYERS | 0 | Yes | Yes |
Saving World Interval | Save game every x seconds. | SAVE_INTERVAL_SEC | 300 | Yes | Yes |
Permanent Death | 0=Off, 1=Individual perma-death, 2=All players experience perma-death | PERMA_DEATH | 0 | Yes | Yes |
On Death | 0=Only lose backpack, and weapon in hand, 1=Previous + pockets, and backpack, 2=All previous + Equipment | ON_DEATH | 2 | Yes | Yes |
PvP | 0/1 Off/On. Enable or disable Player vs Player. | PVP | 1 | Yes | Yes |
Clear Infection | 0=Respawning does not rid you of the infection, 1=You lose it upon respawning | CLEAR_INFECTION | 1 | Yes | Yes |
Eagle Eye | 1=Able to purchase the eagle eye skill, 0=You can't | EAGLE_EYE | 1 | Yes | Yes |
Air Drop | 1=Enabled, 0=Disabled. Controls whether air drops are enabled. | AIR_DROP | 1 | Yes | Yes |
Weapon Durability | 1=Weapons break when reaching 0% durability except crowbar, 0=Only improvised weapons break at 0% durability | WEAPON_BREAK | 1 | Yes | Yes |
Multiplayer Sleep | 1=Time passes if everyone performs the sleep emote at the same time, 0=Passing time is disabled | MULTIPLAYER_SLEEP | 0 | Yes | Yes |
Building Health | Health multiplier of player placed buildings. By default set to "1". | BUILDING_HEALTH | 1 | Yes | Yes |
Loot Respawn | 1=Loot does respawn, 0=Never respawn | LOOT_RESPAWN | 1 | Yes | Yes |
Loot Respawn Timer | If loot respawns how long does it take in minutes | LOOT_RESPAWN_TIMER | 60 | Yes | Yes |
Pickup Respawn Timer | Time in minutes it takes to respawn pickups, 0 to disable. | PICKUP_RESPAWN_TIMER | 90 | Yes | Yes |
Loot Rarity | 0=Scarce, 1=Low, 2=Default, 3=Plentiful, 4=Abundant | LOOT_RARITY | 2 | Yes | Yes |
Air Drop Interval | Air drop every X day | AIR_DROP_INTERVAL | 1 | Yes | Yes |
Zombie Difficulty (Health) | 0=Very Easy, 1=Easy, 2=Default, 3=Hard, 4=Very Hard, 5=Nightmare | ZOMBIE_DIFF_HEALTH | 1 | Yes | Yes |
Zombie Difficulty (Speed) | 0=Very Easy, 1=Easy, 2=Default, 3=Hard, 4=Very Hard, 5=Nightmare | ZOMBIE_DIFF_SPEED | 2 | Yes | Yes |
Zombie Difficulty (Damage) | 0=Very Easy, 1=Easy, 2=Default, 3=Hard, 4=Very Hard, 5=Nightmare | ZOMBIE_DIFF_DAMAGE | 3 | Yes | Yes |
Human Difficulty | 0=Very Easy, 1=Easy, 2=Default, 3=Hard, 4=Very Hard, 5=Nightmare | HUMAN_DIFFICULTY | 3 | Yes | Yes |
Zombie Amount Multiplier | Zombie spawn count multiplier | ZOMBIE_AMOUNT_MULTI | 1 | Yes | Yes |
Human Amount Multiplier | Hostile humans spawn count multiplier | HUMAN_AMOUNT_MULTI | 1 | Yes | Yes |
Zombie Dog Multiplier | Zombie dog spawn count multiplier | ZOMBIE_DOG_MULTI | 1 | Yes | Yes |
Zombie Respawn Timer | Time in minutes for zombies to respawn | ZOMBIE_RESPAWN_TIMER | 90 | Yes | Yes |
Human Respawn Timer | Time in minutes for hostile humans to respawn | HUMAN_RESPAWN_TIMER | 90 | Yes | Yes |
Animal Respawn Timer | Time in minutes for animals to respawn | ANIMAL_RESPAWN_TIMER | 90 | Yes | Yes |
Starting Season | 0=Summer, 1=Autum, 2=Winter, 3=Spring | STARTING_SEASON | 1 | Yes | Yes |
Days Per Season | How many days each season lasts | DAYS_PER_SEASON | 5 | Yes | Yes |
Day Duration | Day duration in minutes | DAY_DUR | 40 | Yes | Yes |
Night Duration | Night duration in minutes | NIGHT_DUR | 20 | Yes | Yes |
Vital Drain | How fast your vitals drain 0=Slow, 1=Normal, 2=Fast | VITAL_DRAIN | 1 | Yes | Yes |
Dog Companions Enabled | Enable finding dog companions you can recruit | DOG_ENABLED | 1 | Yes | Yes |
Dog Companion Amount | Number of companion dogs that could spawn randomly | DOG_NUM | 8 | Yes | Yes |
Recruit Companion Dogs | Allow players to recruit companion dog | RECRUIT_DOG | 1 | Yes | Yes |
Companion Health | Dog companion health - 0=Low 1=Default 2=High | COMPANION_HEALTH | 1 | Yes | Yes |
Companion Damage | Dog companion damage - 0=Low 1=Default 2=High | COMPANION_DMG | 1 | Yes | Yes |
No Death Feedback | 0 to enable player died notification in chat - 1 to disable player died notification in chat. | NO_DEATH_FEEDBACK | 0 | Yes | Yes |
Allow Dismantle | 1 = Enable players to dismantle their own buildings, 0 = Disable | ALLOW_DISMANTLE | 1 | Yes | Yes |
Allow House Dismantle | 1 = Players are able to dismantle house props, 0 = Disable | ALLOW_HOUSE_DISMANTLE | 1 | Yes | Yes |
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 | TERRITORY | 1 | Yes | Yes |
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. | DECAY | 3600 | Yes | Yes |
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. | PICKUP_CLEANUP | 3000 | Yes | Yes |
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. | FAKE_BUILDING_CLEANUP | 3000 | Yes | Yes |
#!/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 "-----------------------------------------"