SoapsUniverse
SoapsAdmin
SoapsAdmin

Getting Started

Home

[Home](README.md)

IntroductionGetting StartedModulesConfigurationComparison: EssentialsX · CMI · SoapsAdminCommands IndexCommands: PlayerCommands: ModerationCommands: StaffCommands: EconomyCommands: AdminGUIs and MenusModerationEconomy and ShopSpawnersRecipes and CrucibleItem EditorFake Players / MannequinsMail and Player InfoChat and MessagingCustom CommandsPlayer VaultsTeleportationPermissionsPlaceholdersIntegrationsDefault Config FilesExamplesFAQChangelog

Spawners

Last updated Jul 27, 2026

Spawners

SoapsAdmin includes a spawner editor with vanilla and MythicMobs type selection, spawn delay and radius, FX, and economy kill budgets.

Requires the spawner module (modules.yml → spawner: true). When the module is disabled, SoapsAdmin does not touch spawners — they stay fully vanilla.

Kill-budget counters need the economy module (budget UI still opens without drops enabled).

Opening the Editor

Method Requirement
Sneak + right-click a spawner soapsadmin.spawner + module on
/sa spawner while looking at a spawner Same
/sa spawner gui Same
/sa spawner info Chat summary of the targeted spawner

Clicking the overview icon in the GUI toggles the spawner enabled / disabled (disabled spawners do not spawn).

Controls

Control Left / Right Shift-click / notes
Mob type Open picker Right-click type button: clear Mythic override
Spawn tick ±20 ticks Type custom delay (min/max applied safely)
Spawn radius ±1 block Type value
Spawn spread ±1 mob count Type value
Trigger radius ±1 (0 = always on) Type value
Particles Cycle presets Clear
Sound Cycle presets Clear
Kill budget ±10 Type value (−1 = global, 0 = unlimited)
Reset counter Click Requires soapsadmin.spawner.reset-budget

Type Picker: Vanilla / MythicMobs

The type picker has two tabs:

Tab Contents
Vanilla Spawnable living EntityTypes (spawn eggs)
MythicMobs Internal Mythic mob names (requires MythicMobs)
Feature Behavior
Search Filters the list by name (shift-click Search to clear)
Selection marker Current type is highlighted
Default tab Opens on Mythic if that spawner already has a Mythic override

How Mythic spawners work

  1. Selecting a Mythic mob stores mythic-mob: <InternalName> in data/server/spawners.yml.
  2. The block keeps a vanilla placeholder type (often pig) so the spawner remains valid.
  3. On spawn, SoapsAdmin cancels the vanilla entity and spawns the Mythic mob via soft API (next-tick fallback if needed).
  4. Spawned entities are tagged for economy spawn-reason / kill-budget tracking when enabled.
  5. Each managed spawner is keyed by block location so multiple nearby spawners stay independent.

If MythicMobs is missing or spawn fails, a warning is logged and no Mythic entity appears.

Kill Budget

Currency drops from spawner-origin mobs can be capped:

Scope Where
Global economy.yml → mob-drops.spawn-reasons.spawner-kill-limit
Per spawner Editor → Kill Budget → data/server/spawners.yml

Per-spawner budgets apply even when the global limit is unset. /sa spawner info shows kills used vs effective max.

Data File

plugins/SoapsAdmin/data/server/spawners.yml (legacy data/spawners.yml migrates on load):

spawners:
  <worldUUID>_<x>_<y>_<z>:
    enabled: true            # false = no spawns
    particle: FLAME          # optional
    sound: BLOCK_NOTE_BLOCK_PLING
    kill-budget: 50          # -1 = use global
    mythic-mob: SkeletonKing # omit for vanilla-only

Breaking a spawner removes its entry.

Permissions

Node Description
soapsadmin.spawner Open editor / commands
soapsadmin.spawner.reset-budget Reset kill counter
Discord