Skip to content
Cataclysm: Bright Nights
GitHubDiscord

Monster Spawning System

This content is not available in your language yet.

Monster Groups

Group definition

IdentifierDescription
nameUnique ID. Must be one continuous word, use underscores if necessary.
defaultDefault monster, automatically fills in any remaining spawn chances.
monstersTo choose a monster for spawning, the game creates 1000 entries and picks one. Each monster will have a number of entries equal to it’s “freq” and the default monster will fill in the remaining. See the table below for how to build the single monster definitions.
is_safe(bool) Check to not trigger safe-mode warning.
is_animal(bool) Check if that group has only normal animals.

Monster definition

IdentifierDescription
monsterThe monster’s unique ID, eg. "mon_zombie".
freqChance of occurrence, x/1000.
cost_multiplierHow many monsters each monster in this definition should count as, if spawning a limited number of monsters.
pack_size(optional) The minimum and maximum number of monsters in this group that should spawn together. (default: [1,1])
conditionsConditions limit when monsters spawn. Valid options: SUMMER, WINTER, AUTUMN, SPRING, DAY, NIGHT, DUSK, DAWN. Multiple Time-of-day conditions (DAY, NIGHT, DUSK, DAWN) will be combined together so that any of those conditions makes the spawn valid. Multiple Season conditions (SUMMER, WINTER, AUTUMN, SPRING) will be combined together so that any of those conditions makes the spawn valid.
starts(optional) This entry becomes active after this time. (Measured in hours)
ends(optional) This entry becomes inactive after this time. (Measured in hours)
{
  "name": "GROUP_ANT",
  "default": "mon_ant",
  "monsters": [
    { "monster": "mon_ant_larva", "freq": 40, "multiplier": 0 },
    { "monster": "mon_ant_soldier", "freq": 90, "multiplier": 5 },
    { "monster": "mon_ant_queen", "freq": 0, "multiplier": 0 },
    {
      "monster": "mon_thing",
      "freq": 100,
      "multiplier": 0,
      "pack_size": [3, 5],
      "conditions": ["DUSK", "DAWN", "SUMMER"]
    }
  ]
}