ConsumableSpawners

让 Minecraft 刷怪笼变成可消耗的机制。支持 Paper 26.1.2（Minecraft 1.21.x）和 Folia。

---

概述

刷怪笼拥有"波次"概念——每生成一个周期（一波怪物）就消耗一次，耗尽后自毁（不可再生）或进入休眠（可再生），可用指定物品激活。

特性

• 波次消耗：每生成周期消耗 1 波，可配置默认波数
• 可再生模式：耗尽后进入休眠，用物品激活后继续工作
• 特殊类型覆盖：不同生物类型可单独配置波数、可再生、激活物品
• 周期检测：短时间连续出怪视为同一周期，只扣 1 波（阈值可调）
• 数据库持久化：SQLite（默认）/ MySQL，仅持久化休眠状态
• Folia 兼容：全程 Region/Async Scheduler
• 自动注册：自然生成或用刷怪蛋修改的刷怪笼自动识别

命令

命令	别名	权限	说明
/consumablespawners reload	/cs reload	consumablespawners.admin	重载配置
/consumablespawners info	/cs info	consumablespawners.admin	插件信息
/consumablespawners list	/cs list	consumablespawners.admin	特殊类型配置列表
/consumablespawners check	/cs check	consumablespawners.admin	查看指向的刷怪笼

配置

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: ""

数据库

仅持久化休眠刷怪笼的位置 + 休眠标记，配置实时从 config.yml 读取。

• SQLite：plugins/ConsumableSpawners/spawners.db
• MySQL：修改 database.type 为 mysql 并配置参数

构建

git clone https://github.com/UASC-DEV/ConsumableSpawners.git
cd ConsumableSpawners
export JAVA_HOME="path/to/jdk-25"
./gradlew build

输出：build/libs/ConsumableSpawners-1.0.0.jar

依赖

• Paper API 26.1.2（服务端提供）
• HikariCP（已 shade）
• SQLite JDBC（已 shade）
• MySQL Connector（服务端提供）

许可证

GNU General Public License v3.0 — 详见 LICENSE。