Skip to content

Config Guide

Riqqqque edited this page May 30, 2026 · 8 revisions

Config Guide

The generated config is zombieapocalypseaddon-common.toml.

The config includes comments, safe ranges, and plain descriptions for each setting. Most gameplay settings can also be changed live with commands.

Good Starting Points

For a lighter survival world:

  • Lower daySpawnChance.
  • Increase daySpawnInterval.
  • Set daylightSpawnStartDay to 10 or 15.
  • Keep babyZombieChance low or set it to 0.0.
  • Keep horde and blood moon chances low.

For a harder apocalypse server:

  • Keep day and night custom spawning enabled.
  • Enable hordes and blood moons.
  • Enable difficulty scaling and advanced attributes.
  • Raise event wave sizes slowly.
  • Test with multiple players before raising caps too high.

Light Protection

maxBlockLightForSpawning controls whether torches, lanterns, glowstone, and similar block light can protect areas from custom waves.

  • -1 ignores block light.
  • 0 only allows custom spawns in complete block darkness.
  • 7 is similar to classic hostile mob light behavior.
  • Sunlight is ignored on purpose so daytime apocalypse spawning can still work.

Baby Zombies

babyZombieChance controls new baby zombie-class spawns.

  • 0.0 disables new baby zombie-class spawns.
  • Higher values allow more baby zombies.

Performance Tips

The most expensive spawn settings are low intervals, high wave size, high caps, and high spawn attempts.

If a server lags:

  • Increase daySpawnInterval.
  • Lower zombiesPerSpawn.
  • Lower maxDayZombiesPerPlayer.
  • Lower spawnAttemptsPerZombie.
  • Keep debug logging off unless troubleshooting.

Clone this wiki locally