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.

egg-humanitz.json

updated

Ports
7777, 27015
Runtime
SteamCMD, Debian
Variables
52

Ports

Add an allocation on the node for each port.

  • Game Port 7777
  • Query Port 27015

Install

Installer image
ghcr.io/ptero-eggs/installers:debian
Steam app
2728330
Steam login
not required
Install script
65 lines

Image

  • SteamCMD, Debian ghcr.io/ptero-eggs/steamcmd:debian

Startup

The Panel runs this command to start the server. It replaces each variable in the command with the value of that variable.

52 variables

Startup command

./TSSGame/Binaries/Linux/TSSGameServer-Linux-Shipping TSSGame -log -port=7777 -queryport=27015 -steamservername="HumanitZ [Dedicated]"

Dotted values come from the server settings. These values are examples.

  • Steam App ID of HumanitZ Server

    SRCDS_APPIDUsers cannot see

    required|string|in:2728330

  • Enable automatic updates on boot

    AUTO_UPDATEUsers can edit

    required|boolean

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

    SRCDS_BETAIDUsers cannot see

    required|string|in:linuxbranch

  • Steam Query Port

    QUERY_PORTUsers can edit

    required|numeric

  • Name of the server

    SERVER_NAMEUsers can edit

    required|string

  • Server password (if any)

    PASSWORDUsers can edit

    nullable|string

  • Name of the save-file for the server

    SAVE_NAMEUsers can edit

    required|string

  • Password for the admin

    ADMIN_PASSUsers can edit

    nullable|string

  • Maximum number of players allowed

    MAX_PLAYERSUsers can edit

    required|numeric

  • Restrict server to allowed players only

    ONLY_ALLOWED_PLAYERSUsers can edit

    required|boolean

  • Save game every x seconds.

    SAVE_INTERVAL_SECUsers can edit

    required|numeric

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

    PERMA_DEATHUsers can edit

    required|numeric

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

    ON_DEATHUsers can edit

    required|numeric

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

    PVPUsers can edit

    required|boolean

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

    CLEAR_INFECTIONUsers can edit

    required|boolean

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

    EAGLE_EYEUsers can edit

    required|boolean

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

    AIR_DROPUsers can edit

    required|boolean

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

    WEAPON_BREAKUsers can edit

    required|boolean

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

    MULTIPLAYER_SLEEPUsers can edit

    required|boolean

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

    BUILDING_HEALTHUsers can edit

    required|numeric

  • 1=Loot does respawn, 0=Never respawn

    LOOT_RESPAWNUsers can edit

    required|boolean

  • If loot respawns how long does it take in minutes

    LOOT_RESPAWN_TIMERUsers can edit

    required|numeric

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

    PICKUP_RESPAWN_TIMERUsers can edit

    required|numeric

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

    LOOT_RARITYUsers can edit

    required|numeric

  • Air drop every X day

    AIR_DROP_INTERVALUsers can edit

    required|numeric

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

    ZOMBIE_DIFF_HEALTHUsers can edit

    required|numeric

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

    ZOMBIE_DIFF_SPEEDUsers can edit

    required|numeric

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

    ZOMBIE_DIFF_DAMAGEUsers can edit

    required|numeric

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

    HUMAN_DIFFICULTYUsers can edit

    required|numeric

  • Zombie spawn count multiplier

    ZOMBIE_AMOUNT_MULTIUsers can edit

    required|numeric

  • Hostile humans spawn count multiplier

    HUMAN_AMOUNT_MULTIUsers can edit

    required|numeric

  • Zombie dog spawn count multiplier

    ZOMBIE_DOG_MULTIUsers can edit

    required|numeric

  • Time in minutes for zombies to respawn

    ZOMBIE_RESPAWN_TIMERUsers can edit

    required|numeric

  • Time in minutes for hostile humans to respawn

    HUMAN_RESPAWN_TIMERUsers can edit

    required|numeric

  • Time in minutes for animals to respawn

    ANIMAL_RESPAWN_TIMERUsers can edit

    required|numeric

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

    STARTING_SEASONUsers can edit

    required|numeric

  • How many days each season lasts

    DAYS_PER_SEASONUsers can edit

    required|numeric

  • Day duration in minutes

    DAY_DURUsers can edit

    required|numeric

  • Night duration in minutes

    NIGHT_DURUsers can edit

    required|numeric

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

    VITAL_DRAINUsers can edit

    required|numeric

  • Enable finding dog companions you can recruit

    DOG_ENABLEDUsers can edit

    required|boolean

  • Number of companion dogs that could spawn randomly

    DOG_NUMUsers can edit

    required|numeric

  • Allow players to recruit companion dog

    RECRUIT_DOGUsers can edit

    required|boolean

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

    COMPANION_HEALTHUsers can edit

    required|numeric

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

    COMPANION_DMGUsers can edit

    required|numeric

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

    NO_DEATH_FEEDBACKUsers can edit

    required|boolean

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

    ALLOW_DISMANTLEUsers can edit

    required|boolean

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

    ALLOW_HOUSE_DISMANTLEUsers can edit

    required|boolean

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

    TERRITORYUsers can edit

    required|boolean

  • 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.

    DECAYUsers can edit

    required|numeric

  • 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_CLEANUPUsers can edit

    required|numeric

  • 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_CLEANUPUsers can edit

    required|numeric

Wings

Stop command
^C (SIGINT)
Running when the console shows
LogKaiHelper: Session created!

Files Wings edits

Wings sets these values in these files before each start.

TSSGame/GameServerSettings.ini ini

[Host Settings].ServerName
{{server.build.env.SERVER_NAME}}
[Host Settings].Password
{{server.build.env.PASSWORD}}
[Host Settings].SaveName
{{server.build.env.SAVE_NAME}}
[Host Settings].AdminPass
{{server.build.env.ADMIN_PASS}}
[Host Settings].MaxPlayers
{{server.build.env.MAX_PLAYERS}}
[Host Settings].OnlyAllowedPlayers
{{server.build.env.ONLY_ALLOWED_PLAYERS}}
[World Settings].SaveIntervalSec
{{server.build.env.SAVE_INTERVAL_SEC}}
[World Settings].NoDeathFeedback
{{server.build.env.NO_DEATH_FEEDBACK}}
[World Settings].PermaDeath
{{server.build.env.PERMA_DEATH}}
[World Settings].OnDeath
{{server.build.env.ON_DEATH}}
[World Settings].PVP
{{server.build.env.PVP}}
[World Settings].ClearInfection
{{server.build.env.CLEAR_INFECTION}}
[World Settings].EagleEye
{{server.build.env.EAGLE_EYE}}
[World Settings].AirDrop
{{server.build.env.AIR_DROP}}
[World Settings].WeaponBreak
{{server.build.env.WEAPON_BREAK}}
[World Settings].MultiplayerSleep
{{server.build.env.MULTIPLAYER_SLEEP}}
[World Settings].LootRespawn
{{server.build.env.LOOT_RESPAWN}}
[World Settings].LootRespawnTimer
{{server.build.env.LOOT_RESPAWN_TIMER}}
[World Settings].PickupRespawnTimer
{{server.build.env.PICKUP_RESPAWN_TIMER}}
[World Settings].LootRarity
{{server.build.env.LOOT_RARITY}}
[World Settings].AirDropInterval
{{server.build.env.AIR_DROP_INTERVAL}}
[World Settings].ZombieDiffHealth
{{server.build.env.ZOMBIE_DIFF_HEALTH}}
[World Settings].ZombieDiffSpeed
{{server.build.env.ZOMBIE_DIFF_SPEED}}
[World Settings].ZombieDiffDamage
{{server.build.env.ZOMBIE_DIFF_DAMAGE}}
[World Settings].HumanDifficulty
{{server.build.env.HUMAN_DIFFICULTY}}
[World Settings].ZombieAmountMulti
{{server.build.env.ZOMBIE_AMOUNT_MULTI}}
[World Settings].HumanAmountMulti
{{server.build.env.HUMAN_AMOUNT_MULTI}}
[World Settings].ZombieDogMulti
{{server.build.env.ZOMBIE_DOG_MULTI}}
[World Settings].ZombieRespawnTimer
{{server.build.env.ZOMBIE_RESPAWN_TIMER}}
[World Settings].HumanRespawnTimer
{{server.build.env.HUMAN_RESPAWN_TIMER}}
[World Settings].AnimalRespawnTimer
{{server.build.env.ANIMAL_RESPAWN_TIMER}}
[World Settings].StartingSeason
{{server.build.env.STARTING_SEASON}}
[World Settings].DaysPerSeason
{{server.build.env.DAYS_PER_SEASON}}
[World Settings].DayDur
{{server.build.env.DAY_DUR}}
[World Settings].NightDur
{{server.build.env.NIGHT_DUR}}
[World Settings].VitalDrain
{{server.build.env.VITAL_DRAIN}}
[World Settings].DogEnabled
{{server.build.env.DOG_ENABLED}}
[World Settings].DogNum
{{server.build.env.DOG_NUM}}
[World Settings].RecruitDog
{{server.build.env.RECRUIT_DOG}}
[World Settings].BuildingHealth
{{server.build.env.BUILDING_HEALTH}}
[World Settings].CompanionHealth
{{server.build.env.COMPANION_HEALTH}}
[World Settings].CompanionDmg
{{server.build.env.COMPANION_DMG}}
[World Settings].AllowDismantle
{{server.build.env.ALLOW_DISMANTLE}}
[World Settings].AllowHouseDismantle
{{server.build.env.ALLOW_HOUSE_DISMANTLE}}
[World Settings].Territory
{{server.build.env.TERRITORY}}
[World Settings].Decay
{{server.build.env.DECAY}}
[World Settings].PickupCleanup
{{server.build.env.PICKUP_CLEANUP}}
[World Settings].FakeBuildingCleanup
{{server.build.env.FAKE_BUILDING_CLEANUP}}

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.

Changes

  1. Add steamcmd based eggs

    · Daniel Barton · 60ef9fb

All changes on GitHub

Problem with this egg?

Open an issue on GitHub. Include your Panel and Wings versions.

Report an issue
Install script 65 lines bash in ghcr.io/ptero-eggs/installers:debian 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 "-----------------------------------------"