Skip to content

HumanitZ: Update to 1.02a #470

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
TimoWolle wants to merge 2 commits into
base: main
Choose a base branch
from
Open

HumanitZ: Update to 1.02a #470

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a0cebd7
Update to 1.x
TimoWolle Feb 27, 2026
6d95ed7
Update HumanitZ egg configuration to version 1.02a
TimoWolle Mar 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
84 changes: 69 additions & 15 deletions humanitz/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,30 +1,84 @@
# HumanitZ


## [Documentation](https://store.steampowered.com/app/2728330/HZ_SERVER)

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.
## Install Notes

## Install notes
This egg provides comprehensive server configuration options for HumanitZ dedicated servers. All server settings can be configured through the Pterodactyl panel interface.

The current version of the server software is slightly buggy, and as of this writing has no proper documentation.
### Features
- Full server customization through environment variables
- RCON support for remote management
- Configurable difficulty settings for zombies, bandits, and animals
- Extensive loot rarity controls
- Weather system customization
- Building and decay mechanics
- Day/night cycle configuration
- Welcome message with color tag support

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.
## Server Ports

## Installation/System Requirements
| Port | Default | Protocol |
|------------|---------|----------|
| Game Port | 7777 | UDP |
| Query Port | 27015 | UDP |
| RCON Port | 8888 | TCP |

Requires a 64-bit processor and operating system
**Note:** The game port can be customized to any available port. RCON is disabled by default and must be enabled in server settings.

## Server Ports
## Configuration

### Boolean Values
All boolean settings use numeric values:
- `1` = Enabled/True
- `0` = Disabled/False

### Key Settings

#### Server Identity
- **Server Name**: Display name in the server browser
- **Server Password**: Optional password protection
- **Search ID**: Custom identifier for server grouping (changing hides server from default list)
- **Admin Password**: Use `/adminaccess <password>` in-game for admin privileges

#### Difficulty Settings
Configure zombie, human bandit, and animal difficulty:
- **Health/Speed/Damage**: 0=Very Easy, 1=Easy, 2=Default, 3=Hard, 4=Very Hard, 5=Nightmare
- **Spawn Multipliers**: Adjust population (1=Default, 2=Double, 0.5=Half)
- **Respawn Timers**: Minutes until respawn (0=Disabled)

#### Loot Configuration
- **Rarity Levels**: 0=Scarce, 1=Low, 2=Default, 3=Plentiful, 4=Abundant
- Categories: Food, Drink, Melee, Ranged, Ammo, Armor, Resources, Other
- **Loot Respawn**: Enable/disable with configurable timer (minutes)

#### Survival Mechanics
- **PVP**: Player combat and item interaction
- **Perma Death**: Character loss on death
- **On Death Mode**: What items are lost (0=Nothing → 3=Everything)
- **Vital Drain**: Resource consumption rate (0=Slow, 1=Normal, 2=Fast)

Ports required to run the server in a table format.
#### World Settings
- **Day/Night Duration**: Real-time minutes for each cycle
- **Seasons**: Starting season and days per season
- **Weather Weights**: Customize spawn probability for each weather type
- **Time Freeze**: Pause time when server is empty

| Port | default |
|--------------|---------|
| Game Port | 7777 |
| Query Port | 27015 |
#### Building & Decay
- **Building Health**: Multiplier for player structures
- **Building Decay**: Real-life days until full decay (0=Disabled)
- **Territory Protection**: Prevent building in spawn point areas
- **Dismantle Options**: Allow players to remove their buildings/props

### Notes
#### Companion Animals
- **Dog Companions**: Enable/disable dog spawns
- **Recruit Dogs**: Allow food-based recruitment
- **Companion Stats**: Health and damage levels (0=Low, 1=Default, 2=High)

7777 is the default port, but any port can be used.
### Advanced Options
- **RCON**: Enable remote console for server management and ping display
- **AI Events**: Raid frequency (0=Disabled → 4=Insane)
- **Multiplayer Sleep**: Time advancement when all players sleep
- **Voice Chat**: In-game VoIP communication
Loading