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

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