Documentation

This is a small writeup of how to use the various features in Zombie:Reborn.

---

Toggling Respawn

With the remake of the Zombie:Reloaded plugin into CS2 with Zombie:Reborn, a new feature has been added that mappers need to use to disable (or re-enable) zombie respawns, typically after a "nuke" at the end of the map. This replaces the old trigger_hurt based automatic "repeat kill detectors", which were often vulnerable to false positives.

To toggle zombie respawning, create an additional output on whatever entity triggers the nuke targeting zr_toggle_respawn, using whatever delay is necessary, and using one of the following three inputs:

• Trigger - A simple toggle: Disables respawns if enabled, enables respawning if disabled
• Disable - Disables respawns if enabled, does nothing if already disabled
• Enable - Enables respawns if disabled, does nothing if already enabled

Here is an example of using Trigger to immediately toggle zombie respawning in Hammer:

It will appear as an invalid output, but it will work on a live server

---

Convars

Name	Default Value	Description
zr_enable	0	Whether to enable ZR features
zr_knockback_scale	5.0	Global knockback scale
zr_ztele_max_distance	150.0	Maximum distance players are allowed to move after starting ztele
zr_ztele_allow_humans	0	Whether to allow humans to use ztele
zr_infect_spawn_type	1	Type of Mother Zombies Spawn [0 = MZ spawn where they stand, 1 = MZ get teleported back to spawn on being picked]
zr_infect_spawn_time_min	15	Minimum time in which Mother Zombies should be picked, after round start
zr_infect_spawn_time_max	15	Maximum time in which Mother Zombies should be picked, after round start
zr_infect_spawn_mz_ratio	7	Ratio of all Players to Mother Zombies to be spawned at round start
zr_infect_spawn_mz_min_count	2	Minimum amount of Mother Zombies to be spawned at round start
zr_respawn_delay	5.0	Time before a zombie is respawned
zr_default_winner_team	1	Which team wins when time ran out [1 = Draw, 2 = Zombies, 3 = Humans]
zr_infinite_ammo	1	Whether to enable infinite reserve ammo on weapons
zr_mz_immunity_reduction	20	How much mz immunity to reduce for each player per round (0-100)

---

Config files

MapConfigs

• Essentially the same as in Zombie:Reloaded, create a cfg file (inside cfg/zr/maps/) with the exact mapname and everything inside the file will be executed on map start

weapons.cfg

• In this file, you can specify the knockback per weapon, which is multiplied by the existing global knockback scale
• We package some default knockback values, such as below, but these can be changed at ease

"hegrenade"
{
	"knockback" = 3.0
}
"inferno" // molotov and incgrenade knockback
{
	"knockback" = 5.0
}

playerclass.cfg

• This file allows you to edit the "classes" as previously seen in Zombie:Reloaded. It is a significantly more flexible approach, allowing inheritence from the default class
• Each team has a base class, Humans and Zombies, several properties can be edited in each "Base" class, alongside other variations of the "Base" class (for different models, health values, etc.)
• Alongside that, we apply a default MotherZombie class to all those who are picked to be the first infected
• Multiple models are allowed per class/subclass, where if multiple are specified, one will be chosen at random per player

"model"
{
	1 = "characters/models/ctm_swat/ctm_swat_variante.vmdl"
	2 = "characters/models/ctm_swat/ctm_swat_variantf.vmdl"
	3 = "characters/models/ctm_swat/ctm_swat_varianth.vmdl"
	...
}

• Some models have different skins, such as the Isaac Clarke model with 5 skins (skin indexes 0-4). Add a max_skin_index entry for each model index that uses skins, with the max skin index value to use. Skins will be chosen at random per player.

"model"
{
	1 = "characters/models/s2ze/isaac_clarke/isaac_clarke.vmdl"
}
"max_skin_index"
{
	1 = 4
}

• We have several properties that can be applied to both Humans and Zombies

"health" = 100
"scale" = 1.0
"color" = {
	r = 255
	g = 255
	b = 255
}

• And some properties that should only be applied to Zombies, but it is not limited to that class

"health_regen_count" = 250
"health_regen_interval" = 5

All of these values can be easily edited, the .cfg files can be found in cfg/zr/

---