UltraSpawners [LITE]

UltraSpawners is in active development.
The plugin works, but some features are incomplete, unstable, or disabled.
Expect bugs and breaking changes.

Advanced spawner management plugin for Paper 1.21.x Minecraft servers.
Free and open source.

Issues and bug reports:
https://github.com/KoopaCode/UltraSpawners/issues

Community support:
https://discord.gg/UafKUcTKSp

Features

Spawner Items. Break any spawner to receive a drop with full data preserved
Stacking. Merge spawners of the same type on one block with configurable limits
Upgrade Tiers. Config-driven spawning upgrades per tier
Economy Integration. Optional Vault support for upgrades
Multi-Database. SQLite by default or MySQL
Anti-Dupe. Atomic saves and NBT validation
TPS Guard. Automatic scaling during low TPS
GUI Menu. Visual upgrade interface
Admin Commands. Full inspection and control

Installation

Download the compiled JAR from Modrinth
Place UltraSpawners-x.x.x.jar in the plugins/ folder
Restart the server
Configure plugins/UltraSpawners/config.yml
Reload with /ultraspawners reload

Configuration

General

general:
  prefix: "&8[&5UltraSpawners&8] &r"
  debug: false

Drops

drops:
  dropOnBreak: true
  dropOnExplosion: true

Stacking

stacking:
  enable: true
  maxStackPerBlock: 64
  mergeDifferentTypes: false

Upgrades

Fully config-driven tiers.

upgrades:
  enable: true
  maxTier: 4
  paymentMode: ITEMS
  tiers:
    0:
    1:

Economy

economy:
  vaultEnable: false
  vaultDisabledMessage: "&cVault is disabled"

If Vault is disabled or missing, Vault-based upgrades are blocked.
All other features continue to work.

Performance

performance:
  spawnCapPerTrigger: 20
  enableTpsGuard: true
  tpsThreshold: 15.0
  minimumSpawnAtLowTps: 1

Storage

storage:
  type: SQLITE
  sqlite:
    filePath: "plugins/UltraSpawners/database.db"
  mysql:
    host: "localhost"
    port: 3306
    database: "ultraspawners"
    username: "root"
    password: "password"
    useSSL: false
    maxPoolSize: 10

Database Setup

SQLite

No setup required. The database is created automatically.

MySQL

Create a database
Set credentials in config.yml
Tables are created on first startup

Commands

Command	Permission	Description
`/ultraspawners reload`	`ultraspawners.admin`	Reload config
`/ultraspawners give <player> <type> [stack] [tier]`	`ultraspawners.give`	Give spawner
`/ultraspawners inspect`	`ultraspawners.use`	Inspect spawner
`/ultraspawners settype <type>`	`ultraspawners.edit`	Change mob
`/ultraspawners setstack <amount>`	`ultraspawners.edit`	Set stack
`/ultraspawners settier <tier>`	`ultraspawners.edit`	Set tier
`/ultraspawners menu`	`ultraspawners.menu`	Open menu

Permissions

Permission	Default	Description
`ultraspawners.use`	false	Basic use
`ultraspawners.admin`	op	Admin access
`ultraspawners.give`	false	Give spawners
`ultraspawners.edit`	false	Edit spawners
`ultraspawners.menu`	true	Access menu

Anti-Dupe Protections

Atomic database writes
NBT validation on items
Range and sanity checks
Chunk load validation
Persistent storage on restart