Mob System

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

Staff how-to

1. Floor Editor → Mob settings: set min/max, mob type, or inherit defaults.
2. Confirm MythicMobs is installed if using mythicmobs:<id> / MYTHIC:<id>.
3. Tune global defaults under mob-spawning in config.yml.
4. Party scaling extras come from party-scaling (see table below).

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.

Global defaults (mob-spawning)

Key	Default	Effect
default-min-mobs	3	Min spawn count when not overridden
default-max-mobs	8	Max spawn count when not overridden
default-mob-type	vanilla:husk	Default mob type
default-spread-radius	3	Min blocks between spawn picks
spawn-delay-ticks	0	Ticks between each mob spawn
mob-counter-display	actionbar	actionbar / chat / bossbar

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

---

Defaults: Default config.yml (mob-spawning, party-scaling) · Mythic: MythicMobs Setup