Types and tiers

A spawner is a type (what it makes) at a tier (how fast, how much, how big its storage). Both files are read once and kept in memory; /spawnersadmin reload reads them again, and the in-game editors write them for you. A line the plugin cannot read is reported in the console and skipped, and the reload message says how many problems it found.

How production works

Every second (production.interval-ticks) the plugin looks at the spawners in loaded chunks. A spawner only counts down while a player who is not a spectator stands within production.activation-range blocks (16); when nobody is near, its timer resets. When its delay is up it makes one cycle:

• Mobs per cycle = spawners in the stack × the tier's amount value × boosters. Fractions round at random with the right average (2.3 makes 2 seven times out of ten, 3 the rest).
• Delay = the tier's speed value in seconds, divided by speed boosters.
• Loot: each loot line rolls for every mob produced; a stack of 500 is drawn statistically, not 500 times.
• Experience = mobs × the type's xp × experience boosters. Item types make none.

What a cycle makes lands in the storage up to its caps; what does not fit is lost, like loot nobody picked up.

VIRTUAL and CLASSIC

The mode is the type's mode, else the tier's mode, else default-mode in config.yml. Every mob a CLASSIC spawner makes carries the persistent data key exyliaspawners:spawner with the spawner's id, so mob stackers and other plugins can tell where it came from.

Types

types.yml is generated on the first start with every living mob your server version can spawn, with loot close to its vanilla drops and its vanilla experience. Bosses and mobs vanilla never spawns from a spawner (wither, ender_dragon, warden, elder_guardian, giant, illusioner) are written but disabled. Two item spawners come with it: iron and diamond. After that the file is yours.

types:
  zombie:
    enabled: true
    kind: ENTITY
    entity: ZOMBIE
    mob: ''
    mode: ''
    xp: 5.0
    stack-limit: 0
    loot:
    - ROTTEN_FLESH 1 2 66
    - IRON_INGOT 1 1 2.5
    - CARROT 1 1 1
    - POTATO 1 1 1
  iron:
    enabled: true
    kind: ITEM
    entity: ''
    mob: ''
    mode: ''
    xp: 0.0
    stack-limit: 0
    loot:
    - IRON_INGOT 1 2 100

The key is the type id that items, commands and permissions use (lower case).

Loot lines use ExyliaLib's loot grammar. A plain material name is stored under that name, so storage stays the same across server versions. Nothing is forced: when every line misses, that mob drops nothing.

Item types

An ITEM type makes no mob: each cycle rolls its loot lines once per "mob" the cycle makes, so the tier's amount still multiplies it. Item types produce no experience. The in-game wizard can build one from the items in a chest. See Administration.

Mob types

A MOB type spawns an ExyliaMobs template in CLASSIC mode. In VIRTUAL mode it produces its own loot and xp like any other type. Thirty seconds after the start, and on every reload, the console names any MOB type that cannot spawn: ExyliaMobs missing, a template it does not have, or one whose entity cannot be spawned.

Tiers

tiers.yml holds the tiers by number. Every tier has four tracks with one value per level; a spawner starts at level 1 of each and buys the next levels with upgrades.

tiers:
  '1':
    mode: ''
    stack-limit: 64
    speed: [20.0, 18.0, 16.0, 14.0, 12.0]
    amount: [2.0, 2.5, 3.0, 3.5, 4.0]
    storage: [1024.0, 2048.0, 4096.0, 8192.0, 16384.0]
    xp: [2000.0, 4000.0, 8000.0, 16000.0, 32000.0]
    upgrades:
      speed:
        cost: 2500 * (%level% - 1) ^ 2
        currency: ''
        permission: ''
        requirements: {}
        levels: {}
      # amount, storage and xp the same

The defaults ship three tiers:

A tier is fixed by the item: tier 2 spawners come from /spawnersadmin give <player> <type> <amount> 2 or a shop or crate that runs it. Spawners only stack with the same type and tier. A spawner whose tier was deleted works as the lowest tier.

Display names

lang/<language>/type-names.yml maps each type id to what screens, items, holograms and messages call it. A type missing there shows its id in title case (zombified_piglin reads Zombified Piglin).