ConsumableSpawners

Turn Minecraft mob spawners into a consumable mechanic. Supports Paper & Folia 1.21+ .

Overview

Each spawn cycle consumes one wave. When waves run out, the spawner self-destructs (non-renewable) or enters dormancy (renewable). Dormant spawners can be reactivated with a configured item.

Features

Wave consumption: one wave per spawn cycle; configurable default count
Renewable mode: goes dormant instead of breaking; reactivate with an item
Per-type overrides: each entity type can have its own waves, renewable flag, and activation item
Cycle detection: consecutive spawns within a short window count as one cycle (configurable threshold)
Database persistence: SQLite (default) or MySQL; only dormant state is saved
Folia support: Region/Async Scheduler throughout
Auto-registration: naturally generated and spawn-egg-modified spawners detected automatically

Commands

Command	Alias	Permission	Description
`/consumablespawners reload`	`/cs reload`	`consumablespawners.admin`	Reload config
`/consumablespawners info`	`/cs info`	`consumablespawners.admin`	Plugin info
`/consumablespawners list`	`/cs list`	`consumablespawners.admin`	List special type configs
`/consumablespawners check`	`/cs check`	`consumablespawners.admin`	Inspect targeted spawner

Configuration

default-waves: 5
default-renewable: false
default-activation-item: DIAMOND
cycle-threshold-ms: 1000

special-types:
  BLAZE:
    renewable: true

database:
  type: sqlite
  sqlite:
    file: spawners.db
  mysql:
    host: 127.0.0.1
    port: 3306
    database: consumable_spawners
    username: root
    password: ""

Database

Only dormant spawner records (location + dormant flag) are persisted. All configuration is read live from config.yml.

SQLite: plugins/ConsumableSpawners/spawners.db
MySQL: set database.type to mysql and configure connection details