HumanitZ

Games
Report Issue

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.

Contributors:
danielb@purpleflaghosting.com
README

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.

Port default
Game Port 7777
Query Port 27015

Notes

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

Docker Images (1)
Name Image
ghcr.io/ptero-eggs/steamcmd:debian ghcr.io/ptero-eggs/steamcmd:debian
Startup Command 
./TSSGame/Binaries/Linux/TSSGameServer-Linux-Shipping TSSGame -log -port={{SERVER_PORT}} -queryport={{QUERY_PORT}} -steamservername="{{SERVER_NAME}}"
Variables (52)

[REQUIRED] Steam App ID

Steam App ID of HumanitZ Server

Environment:
SRCDS_APPID
Default:
2728330
User Viewable:
❌
User Editable:
❌
Rules:
required|string|in:2728330

Auto Update

Enable automatic updates on boot

Environment:
AUTO_UPDATE
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|boolean

[REQUIRED] Steam Beta Branch

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

Environment:
SRCDS_BETAID
Default:
linuxbranch
User Viewable:
❌
User Editable:
❌
Rules:
required|string|in:linuxbranch

[REQUIRED] Steam Query Port

Steam Query Port

Environment:
QUERY_PORT
Default:
27015
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Server Name

Name of the server

Environment:
SERVER_NAME
Default:
HumanitZ [Dedicated]
User Viewable:
❌
User Editable:
❌
Rules:
required|string

Server Password

Server password (if any)

Environment:
PASSWORD
Default:
None
User Viewable:
❌
User Editable:
❌
Rules:
nullable|string

Save Name

Name of the save-file for the server

Environment:
SAVE_NAME
Default:
DedicatedSaveMP
User Viewable:
❌
User Editable:
❌
Rules:
required|string

Admin Password

Password for the admin

Environment:
ADMIN_PASS
Default:
None
User Viewable:
❌
User Editable:
❌
Rules:
nullable|string

Max Players

Maximum number of players allowed

Environment:
MAX_PLAYERS
Default:
16
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Only Allowed Players

Restrict server to allowed players only

Environment:
ONLY_ALLOWED_PLAYERS
Default:
0
User Viewable:
❌
User Editable:
❌
Rules:
required|boolean

Saving World Interval

Save game every x seconds.

Environment:
SAVE_INTERVAL_SEC
Default:
300
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Permanent Death

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

Environment:
PERMA_DEATH
Default:
0
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

On Death

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

Environment:
ON_DEATH
Default:
2
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

PvP

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

Environment:
PVP
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|boolean

Clear Infection

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

Environment:
CLEAR_INFECTION
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|boolean

Eagle Eye

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

Environment:
EAGLE_EYE
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|boolean

Air Drop

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

Environment:
AIR_DROP
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|boolean

Weapon Durability

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

Environment:
WEAPON_BREAK
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|boolean

Multiplayer Sleep

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

Environment:
MULTIPLAYER_SLEEP
Default:
0
User Viewable:
❌
User Editable:
❌
Rules:
required|boolean

Building Health

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

Environment:
BUILDING_HEALTH
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Loot Respawn

1=Loot does respawn, 0=Never respawn

Environment:
LOOT_RESPAWN
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|boolean

Loot Respawn Timer

If loot respawns how long does it take in minutes

Environment:
LOOT_RESPAWN_TIMER
Default:
60
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Pickup Respawn Timer

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

Environment:
PICKUP_RESPAWN_TIMER
Default:
90
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Loot Rarity

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

Environment:
LOOT_RARITY
Default:
2
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Air Drop Interval

Air drop every X day

Environment:
AIR_DROP_INTERVAL
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Zombie Difficulty (Health)

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

Environment:
ZOMBIE_DIFF_HEALTH
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Zombie Difficulty (Speed)

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

Environment:
ZOMBIE_DIFF_SPEED
Default:
2
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Zombie Difficulty (Damage)

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

Environment:
ZOMBIE_DIFF_DAMAGE
Default:
3
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Human Difficulty

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

Environment:
HUMAN_DIFFICULTY
Default:
3
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Zombie Amount Multiplier

Zombie spawn count multiplier

Environment:
ZOMBIE_AMOUNT_MULTI
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Human Amount Multiplier

Hostile humans spawn count multiplier

Environment:
HUMAN_AMOUNT_MULTI
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Zombie Dog Multiplier

Zombie dog spawn count multiplier

Environment:
ZOMBIE_DOG_MULTI
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Zombie Respawn Timer

Time in minutes for zombies to respawn

Environment:
ZOMBIE_RESPAWN_TIMER
Default:
90
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Human Respawn Timer

Time in minutes for hostile humans to respawn

Environment:
HUMAN_RESPAWN_TIMER
Default:
90
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Animal Respawn Timer

Time in minutes for animals to respawn

Environment:
ANIMAL_RESPAWN_TIMER
Default:
90
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Starting Season

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

Environment:
STARTING_SEASON
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Days Per Season

How many days each season lasts

Environment:
DAYS_PER_SEASON
Default:
5
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Day Duration

Day duration in minutes

Environment:
DAY_DUR
Default:
40
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Night Duration

Night duration in minutes

Environment:
NIGHT_DUR
Default:
20
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Vital Drain

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

Environment:
VITAL_DRAIN
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Dog Companions Enabled

Enable finding dog companions you can recruit

Environment:
DOG_ENABLED
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|boolean

Dog Companion Amount

Number of companion dogs that could spawn randomly

Environment:
DOG_NUM
Default:
8
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Recruit Companion Dogs

Allow players to recruit companion dog

Environment:
RECRUIT_DOG
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|boolean

Companion Health

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

Environment:
COMPANION_HEALTH
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

Companion Damage

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

Environment:
COMPANION_DMG
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

No Death Feedback

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

Environment:
NO_DEATH_FEEDBACK
Default:
0
User Viewable:
❌
User Editable:
❌
Rules:
required|boolean

Allow Dismantle

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

Environment:
ALLOW_DISMANTLE
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|boolean

Allow House Dismantle

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

Environment:
ALLOW_HOUSE_DISMANTLE
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|boolean

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:
TERRITORY
Default:
1
User Viewable:
❌
User Editable:
❌
Rules:
required|boolean

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:
DECAY
Default:
3600
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

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:
PICKUP_CLEANUP
Default:
3000
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric

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:
FAKE_BUILDING_CLEANUP
Default:
3000
User Viewable:
❌
User Editable:
❌
Rules:
required|numeric
Installation Script
Container: ghcr.io/ptero-eggs/installers:debian
Entrypoint: bash
#!/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 "-----------------------------------------"