Config Guide

Config Guide

The config file is:

config/zombieapocalypseaddon-common.toml

Start the server once to generate the file. Stop the server before editing it.

Simple Presets

These are not separate files. They are suggested values to copy into the config or apply with commands.

Easy Apocalypse

Good for casual servers.

daySpawnInterval = 180
daySpawnChance = 0.25
zombiesPerSpawn = 1
maxDayZombiesPerPlayer = 30
daylightSpawnStartDay = 10
babyZombieChance = 0.0
maxBlockLightForSpawning = 7

Normal Apocalypse

Good first default for most survival servers.

daySpawnInterval = 120
daySpawnChance = 0.5
zombiesPerSpawn = 2
maxDayZombiesPerPlayer = 50
daylightSpawnStartDay = 0
babyZombieChance = 0.05
maxBlockLightForSpawning = -1

Hardcore Apocalypse

Use only after testing.

daySpawnInterval = 80
daySpawnChance = 0.75
zombiesPerSpawn = 3
maxDayZombiesPerPlayer = 80
daylightSpawnStartDay = 0
babyZombieChance = 0.08
maxBlockLightForSpawning = -1

Settings New Players Usually Want

Make Daytime Safer At The Start

Use:

daylightSpawnStartDay = 10

This means custom daytime spawning starts on day 10. Night spawning can still happen before then.

Make Torches Protect Bases

Use:

maxBlockLightForSpawning = 7

This makes custom spawns respect block light from torches, lanterns, glowstone, campfires, and similar blocks.

Important: sunlight is ignored on purpose. Daytime apocalypse spawning still works.

Disable Baby Zombies

Use:

babyZombieChance = 0.0

This disables new baby zombie-class spawns from this mod.

Reduce Lag

Change these first:

daySpawnInterval = 180
zombiesPerSpawn = 1
maxDayZombiesPerPlayer = 30
spawnAttemptsPerZombie = 5
enableDebugLogging = false

What The Big Systems Mean

Custom Spawning

The mod checks nearby survival players every interval. If the chance roll passes, it tries to place zombie-class mobs nearby.

Hordes

Hordes are timed events with stronger spawn pressure and bigger waves.

Blood Moons

Blood moons happen at night and raise spawn pressure heavily.

Difficulty Scaling

Scaling makes zombies stronger as the world day increases.

Advanced Attributes

The attribute system lets you tune health, attack, speed, armor, follow range, and knockback resistance. New users should leave this alone until the basic spawn settings feel good.

Other Useful Settings

Zombie Sun Burning

preventSunBurn controls whether zombie-class mobs are protected from burning in daylight.

• true means zombies do not burn in sunlight.
• false means zombies burn like vanilla.

Extra Drops

enableExtraDrops turns bonus zombie drops on or off.

Useful drop chances include:

• boneChance
• stringChance
• gunpowderChance
• enderPearlChance
• phantomMembraneChance

Set a chance to 0.0 to disable that drop.

Event Notifications

enableEventNotifications controls horde and blood moon screen alerts.

enableDayCounterAnnouncements controls the morning day counter title.

Statistics

enableStatistics controls zombie kill tracking and milestone progress.

Milestone advancements are awarded at:

• 250 zombie kills
• 1000 zombie kills
• 3000 zombie kills

Performance Tips

The most expensive settings are:

• low daySpawnInterval
• high zombiesPerSpawn
• high maxDayZombiesPerPlayer
• high spawnAttemptsPerZombie
• debug logging left on

For weak servers, keep spawn checks slower and caps lower.