Mob System

SoapsFloor spawns mobs per floor from wand-configured spawn points and mob settings.

Mob types

Format	Source	Example
VANILLA:<ENTITY>	Bukkit EntityType	VANILLA:ZOMBIE
MYTHIC:<id>	MythicMobs internal name	MYTHIC:FireDemon

MythicMobs is optional. Invalid vanilla types are skipped with a console warning.

Editor chat input accepts lowercase: vanilla:zombie, mythicmobs:FireDemon.

Spawn counts

Level	Setting
Global default	mob-spawning.default-min-mobs, default-max-mobs
Per room	Wand editor defaults for the room
Per floor	Mob Settings item on a selected floor

A random count between min and max is chosen each floor start. Value -1 on a floor field falls back to global default.

Spawn locations

Spawn points come from the floor schematic placement. Mobs spawn at spawn-height-offset blocks above the floor surface (default 2.0).

default-spread-radius sets minimum spacing between spawn picks.

Spawn delay

mob-spawning.spawn-delay-ticks delays each mob spawn. 0 spawns all at once. Debug instant-mob-spawn skips delay.

Party scaling

When enabled, extra players add mobs and HP. See Configuration party-scaling section.

Effect	Config key
Extra max mobs	mobs.extra-max-per-player
Count multiplier	mobs.count-multiplier-per-player
Vanilla HP	health.multiplier-per-player
Mythic levels	health.mythic-level-per-player

Mob counter

mob-counter-display controls remaining mob feedback:

Value	Display
actionbar	Action bar (default)
chat	Chat message
bossbar	Boss bar

Clears show "Floor Cleared" in the same channel.

Floor custom commands

Per-floor console commands can run at floor start. Set them in the wand editor Custom Commands item.

Placeholders: {player}, {floor}, {room}.

Mob cleanup

When a session ends, all session mobs are removed. Death tracking uses an entity-to-room map for fast lookup.

Config reference

mob-spawning:
  default-min-mobs: 3
  default-max-mobs: 8
  default-mob-type: VANILLA:ZOMBIE
  default-spread-radius: 3
  spawn-delay-ticks: 0
  mob-counter-display: actionbar

Per-room overrides are saved in the room YAML under plugins/SoapsFloor/rooms/.