Skip to content

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.

Report an issue
updated
variables
52
images
1
author
engels74@marx.ps
sha256
c41d0a8ec9f6

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.

Startup command

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

The parts in blue are filled in by the panel when the server starts, from the variables below.

Docker image

  • ghcr.io/ptero-eggs/steamcmd:debian

1 contributor

Variables

52 settings

  • [REQUIRED] Steam App ID

    Steam App ID of HumanitZ Server

    env
    SRCDS_APPID
    default
    2728330
    rules
    required|string|in:2728330
  • Auto Update

    Enable automatic updates on boot

    env
    AUTO_UPDATE
    default
    1
    rules
    required|boolean
    • viewable
    • editable
  • [REQUIRED] Steam Beta Branch

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

    env
    SRCDS_BETAID
    default
    linuxbranch
    rules
    required|string|in:linuxbranch
  • [REQUIRED] Steam Query Port

    Steam Query Port

    env
    QUERY_PORT
    default
    27015
    rules
    required|numeric
    • viewable
    • editable
  • Server Name

    Name of the server

    env
    SERVER_NAME
    default
    HumanitZ [Dedicated]
    rules
    required|string
    • viewable
    • editable
  • Server Password

    Server password (if any)

    env
    PASSWORD
    default
    none
    rules
    nullable|string
    • viewable
    • editable
  • Save Name

    Name of the save-file for the server

    env
    SAVE_NAME
    default
    DedicatedSaveMP
    rules
    required|string
    • viewable
    • editable
  • Admin Password

    Password for the admin

    env
    ADMIN_PASS
    default
    none
    rules
    nullable|string
    • viewable
    • editable
  • Max Players

    Maximum number of players allowed

    env
    MAX_PLAYERS
    default
    16
    rules
    required|numeric
    • viewable
    • editable
  • Only Allowed Players

    Restrict server to allowed players only

    env
    ONLY_ALLOWED_PLAYERS
    default
    0
    rules
    required|boolean
    • viewable
    • editable
  • Saving World Interval

    Save game every x seconds.

    env
    SAVE_INTERVAL_SEC
    default
    300
    rules
    required|numeric
    • viewable
    • editable
  • Permanent Death

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

    env
    PERMA_DEATH
    default
    0
    rules
    required|numeric
    • viewable
    • editable
  • On Death

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

    env
    ON_DEATH
    default
    2
    rules
    required|numeric
    • viewable
    • editable
  • PvP

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

    env
    PVP
    default
    1
    rules
    required|boolean
    • viewable
    • editable
  • Clear Infection

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

    env
    CLEAR_INFECTION
    default
    1
    rules
    required|boolean
    • viewable
    • editable
  • Eagle Eye

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

    env
    EAGLE_EYE
    default
    1
    rules
    required|boolean
    • viewable
    • editable
  • Air Drop

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

    env
    AIR_DROP
    default
    1
    rules
    required|boolean
    • viewable
    • editable
  • Weapon Durability

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

    env
    WEAPON_BREAK
    default
    1
    rules
    required|boolean
    • viewable
    • editable
  • Multiplayer Sleep

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

    env
    MULTIPLAYER_SLEEP
    default
    0
    rules
    required|boolean
    • viewable
    • editable
  • Building Health

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

    env
    BUILDING_HEALTH
    default
    1
    rules
    required|numeric
    • viewable
    • editable
  • Loot Respawn

    1=Loot does respawn, 0=Never respawn

    env
    LOOT_RESPAWN
    default
    1
    rules
    required|boolean
    • viewable
    • editable
  • Loot Respawn Timer

    If loot respawns how long does it take in minutes

    env
    LOOT_RESPAWN_TIMER
    default
    60
    rules
    required|numeric
    • viewable
    • editable
  • Pickup Respawn Timer

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

    env
    PICKUP_RESPAWN_TIMER
    default
    90
    rules
    required|numeric
    • viewable
    • editable
  • Loot Rarity

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

    env
    LOOT_RARITY
    default
    2
    rules
    required|numeric
    • viewable
    • editable
  • Air Drop Interval

    Air drop every X day

    env
    AIR_DROP_INTERVAL
    default
    1
    rules
    required|numeric
    • viewable
    • editable
  • Zombie Difficulty (Health)

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

    env
    ZOMBIE_DIFF_HEALTH
    default
    1
    rules
    required|numeric
    • viewable
    • editable
  • Zombie Difficulty (Speed)

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

    env
    ZOMBIE_DIFF_SPEED
    default
    2
    rules
    required|numeric
    • viewable
    • editable
  • Zombie Difficulty (Damage)

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

    env
    ZOMBIE_DIFF_DAMAGE
    default
    3
    rules
    required|numeric
    • viewable
    • editable
  • Human Difficulty

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

    env
    HUMAN_DIFFICULTY
    default
    3
    rules
    required|numeric
    • viewable
    • editable
  • Zombie Amount Multiplier

    Zombie spawn count multiplier

    env
    ZOMBIE_AMOUNT_MULTI
    default
    1
    rules
    required|numeric
    • viewable
    • editable
  • Human Amount Multiplier

    Hostile humans spawn count multiplier

    env
    HUMAN_AMOUNT_MULTI
    default
    1
    rules
    required|numeric
    • viewable
    • editable
  • Zombie Dog Multiplier

    Zombie dog spawn count multiplier

    env
    ZOMBIE_DOG_MULTI
    default
    1
    rules
    required|numeric
    • viewable
    • editable
  • Zombie Respawn Timer

    Time in minutes for zombies to respawn

    env
    ZOMBIE_RESPAWN_TIMER
    default
    90
    rules
    required|numeric
    • viewable
    • editable
  • Human Respawn Timer

    Time in minutes for hostile humans to respawn

    env
    HUMAN_RESPAWN_TIMER
    default
    90
    rules
    required|numeric
    • viewable
    • editable
  • Animal Respawn Timer

    Time in minutes for animals to respawn

    env
    ANIMAL_RESPAWN_TIMER
    default
    90
    rules
    required|numeric
    • viewable
    • editable
  • Starting Season

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

    env
    STARTING_SEASON
    default
    1
    rules
    required|numeric
    • viewable
    • editable
  • Days Per Season

    How many days each season lasts

    env
    DAYS_PER_SEASON
    default
    5
    rules
    required|numeric
    • viewable
    • editable
  • Day Duration

    Day duration in minutes

    env
    DAY_DUR
    default
    40
    rules
    required|numeric
    • viewable
    • editable
  • Night Duration

    Night duration in minutes

    env
    NIGHT_DUR
    default
    20
    rules
    required|numeric
    • viewable
    • editable
  • Vital Drain

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

    env
    VITAL_DRAIN
    default
    1
    rules
    required|numeric
    • viewable
    • editable
  • Dog Companions Enabled

    Enable finding dog companions you can recruit

    env
    DOG_ENABLED
    default
    1
    rules
    required|boolean
    • viewable
    • editable
  • Dog Companion Amount

    Number of companion dogs that could spawn randomly

    env
    DOG_NUM
    default
    8
    rules
    required|numeric
    • viewable
    • editable
  • Recruit Companion Dogs

    Allow players to recruit companion dog

    env
    RECRUIT_DOG
    default
    1
    rules
    required|boolean
    • viewable
    • editable
  • Companion Health

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

    env
    COMPANION_HEALTH
    default
    1
    rules
    required|numeric
    • viewable
    • editable
  • Companion Damage

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

    env
    COMPANION_DMG
    default
    1
    rules
    required|numeric
    • viewable
    • editable
  • No Death Feedback

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

    env
    NO_DEATH_FEEDBACK
    default
    0
    rules
    required|boolean
    • viewable
    • editable
  • Allow Dismantle

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

    env
    ALLOW_DISMANTLE
    default
    1
    rules
    required|boolean
    • viewable
    • editable
  • Allow House Dismantle

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

    env
    ALLOW_HOUSE_DISMANTLE
    default
    1
    rules
    required|boolean
    • viewable
    • 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

    env
    TERRITORY
    default
    1
    rules
    required|boolean
    • viewable
    • 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.

    env
    DECAY
    default
    3600
    rules
    required|numeric
    • viewable
    • 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.

    env
    PICKUP_CLEANUP
    default
    3000
    rules
    required|numeric
    • viewable
    • 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.

    env
    FAKE_BUILDING_CLEANUP
    default
    3000
    rules
    required|numeric
    • viewable
    • editable
Installation script 65 lines container ghcr.io/ptero-eggs/installers:debian entrypoint bash show
#!/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 "-----------------------------------------"