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:<id>	MythicMobs internal name	MYTHIC:FireDemon

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

In the editor, type the same formats with a lowercase prefix (vanilla:zombie, mythicmobs:FireDemon).

Spawn counts

Level	Setting
Per floor	Floor Editor hub, Mob settings (min-mobs / max-mobs / mob-type)
Per room	Room Settings defaults (default-min-mobs, default-max-mobs, default-mob-type)
Global	mob-spawning.default-min-mobs, default-max-mobs, default-mob-type

Resolution is floor override, then room defaults, then global config. A floor value of -1 (or blank mob type) means inherit.

A random count between the resolved min and max is chosen each floor start.

Spawn locations

Spawn points come from the floor schematic placement. Spawns scan downward for solid ground with two air blocks above, inset by schematic-settings.floor-removal-inset so wall edges are skipped. Feet sit spawn-height-offset blocks above that surface (default 1.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
Cap extras used for scaling	max-extra-players (0 = no cap)
Extra max mobs	mobs.extra-max-per-player
Count multiplier	mobs.count-multiplier-per-player
HP multiplier	health.multiplier-per-player
Apply HP to vanilla	health.apply-to-vanilla
Apply HP to Mythic	health.apply-to-mythic
Mythic levels	health.mythic-level-per-player
Fractional reward-roll extras	rewards.roll-multiplier-per-player

Mob counter

mob-counter-display can be set per room (Room Settings) or globally under mob-spawning. Room value wins when set.

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 Floor Editor hub under Custom commands.

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:husk
  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/.