? zNxPiglinRush

一个多方块下界刷怪笼框架——在任何方块类型上提升生物生成率,支持波次模式、实时统计、生成热力图、自定义战利品以及完整的 Folia 兼容。
原版游戏中,僵尸猪灵会在下界的岩浆块上方生成,但速率令人痛苦地缓慢。zNxPiglinRush 挂钩了所有自然生成事件,在周围区域触发多次额外生成,并提供了一套完整的工具来监控、调整并最大化你的农场效率。
✨ 功能
- 多方块刷怪笼框架 —— 配置 任意 方块类型作为刷怪笼,拥有独立的生物、生成率和战利品。岩浆块用于金类生物,灵魂沙用于凋灵骷髅,下界岩用于岩浆怪——全部同时生效
- 两种生成策略 —— 标准模式:每次触发时立即进行额外生成。波次模式:积累点数并发射按比例缩放的爆发波次,具有渐进式缩放效果
- 自定义战利品注入 —— 每个刷怪笼的掉落规则,可配置概率和数量,直接注入到原版死亡掉落中
- 生成统计 —— 通过
/pr stats 查看会话统计、总计(SQLite 持久化存储,重启后保留)、每小时环形缓冲区数据以及按生物分类的细分统计
- 生成热力图 ——
/pr heatmap [半径] 切换追踪方块上方的实时粒子覆盖层,根据生成密度显示为蓝色 → 黄色 → 红色
- TPS 诊断 —— 异步 TPS 监控器,具备可配置的警报阈值、游戏内管理员警告以及
/pr diagnostics 性能报告
- 配置更新器 —— 启动时自动将旧配置文件迁移到当前架构,保留所有值并创建带时间戳的备份
- PlaceholderAPI —— 提供 8 个占位符用于记分板和标签页列表
- Folia 原生支持 —— 运行时选择两种调度程序实现之一(
FoliaSchedulerService / BukkitSchedulerService),在基于区域线程的服务器上无任何问题
- 异步更新检查器 —— Modrinth API v2,加入服务器时对管理员显示可点击的游戏内通知
- 零 NMS —— 纯 Bukkit/Spigot/Paper API,热点路径中无反射操作
- 热重载 ——
/pr reload 应用所有配置和注册表更改,无需重启
? 快速开始
- 将
.jar 文件放入你的 plugins/ 文件夹
- 重启服务器
- 编辑
plugins/zNxPiglinRush/config.yml
- 运行
/pr reload —— 完成
⚙️ 配置
enabled: true
active-worlds: [] # 留空 = 所有世界
debug: false
spawners:
# 每个方块都有自己独立的部分——你可以添加任意多个
magma_block:
mob: ZOMBIFIED_PIGLIN
spawn-count: 3 # 每次触发生成的总生物数(原版 = 1)
spawn-cooldown: 20 # 同一方块两次生成之间的刻数
max-nearby-entities: 12 # 扫描半径内的实体上限
scan-radius: 10
extra-attempts: 1 # 每次触发的随机额外尝试次数
wave-mode: false # true = 爆发波次而非即时生成
wave-size: 5
wave-cooldown: 100 # 波次发射之间的刻数
custom-drops:
- material: GOLD_NUGGET
min: 1
max: 3
chance: 0.3
- material: GOLDEN_SWORD
min: 1
max: 1
chance: 0.05
# soul_sand:
# mob: WITHER_SKELETON
# spawn-count: 2
# ...
diagnostics:
tps-alert-threshold: 18.0
alert-cooldown-seconds: 300
update-checker: true
调整指南
| 服务器类型 |
spawn-count |
spawn-cooldown |
max-nearby-entities |
| 低 TPS / 小型 |
2 |
40 |
8 |
| 标准 |
3 |
20 |
12 |
| 专用农场服务器 |
5 |
10 |
20 |
? 如果 TPS 下降,请先降低 spawn-count 或提高 spawn-cooldown。
? 命令与权限
| 命令 |
别名 |
描述 |
/piglinrush reload |
/pr reload |
重载配置和刷怪笼注册表 |
/piglinrush info |
/pr info |
运行时信息、已注册的方块、更新状态 |
/piglinrush stats |
/pr stats |
会话 / 总计 / 每小时生成统计 |
/piglinrush heatmap [r] |
/pr heatmap |
切换粒子热力图(仅限玩家) |
/piglinrush diagnostics |
/pr diag |
TPS 报告及性能建议 |
/piglinrush toggle |
/pr toggle |
切换提示 |
权限节点: piglinrush.admin(默认:op)
? PlaceholderAPI
| 占位符 |
返回值 |
%piglinrush_total% |
自服务器启动以来的总生成数 |
%piglinrush_session% |
自上次 /pr reload 以来的生成数 |
%piglinrush_last_hour% |
过去一小时的生成数 |
%piglinrush_last_24h% |
过去 24 小时的生成数 |
%piglinrush_status% |
ENABLED / DISABLED |
%piglinrush_tps% |
当前平均 TPS |
%piglinrush_spawners% |
已注册的刷怪笼方块数量 |
%piglinrush_version% |
插件版本 |
❓ 常见问题
这会影响主世界的岩浆块吗?
不会。该插件仅在原版已经触发生成时才会激活——即在下界的岩浆块上。主世界的岩浆块不会触发自然的猪灵生成,因此该插件在那里没有效果。
它会破坏原版生成规则吗?
初始的原版生成检查(光照等级、生物上限)仍正常运行。额外生成遵循每个方块配置的 max-nearby-entities 上限。paper.yml / spigot.yml / bukkit.yml 中的全局服务器生物上限仍然适用。
什么是波次模式?
当在某个方块上启用时,每次原版触发都会为该方块的计数器增加一点。每经过 wave-cooldown 刻,引擎会发射一次爆发:credits × spawn-count 个生物(上限为 wave-size),连续波次会有渐进式加成。适合戏剧性的爆发而非持续的流式生成。
与其他生成插件兼容吗?
通常可以——zNxPiglinRush 仅响应已经通过原版自身检查的事件,不涉及 NMS 或刷怪笼修改。
从旧版本更新时会发生什么?
内置的 Config Updater 会检测你的旧配置文件,创建一个带时间戳的备份,将你的配置值迁移到新架构,并为任何新增的配置键填充合理的默认值。你无需进行任何手动操作。
? 依赖要求
- Spigot、Paper 或 Folia 26.1.x
- Java 21+
- PlaceholderAPI (可选)
? 许可证
本项目基于 Apache License 2.0 许可证开源 —— 详情请参阅 LICENSE 文件。
? zNxPiglinRush

A multi-block Nether spawner framework — boost mob spawns on any block type, with wave mode, live statistics, spawn heatmap, custom loot and full Folia support.
Vanilla already spawns Zombified Piglins above magma blocks in the Nether, but the rate is painfully slow. zNxPiglinRush hooks into every natural spawn, fires multiple extra spawns in the surrounding area, and gives you a complete toolset to monitor, tune and maximise your farms.
✨ Features
- Multi-block spawner framework — configure any block type as a spawner with its own mob, rates and loot. Magma block for gold, soul sand for Wither Skeletons, netherrack for Magma Cubes — all at once
- Two spawn strategies — Standard: immediate extra spawns per trigger. Wave mode: accumulate credits and fire scaled burst waves with progressive scaling
- Custom loot injection — per-spawner drop rules with configurable chance and amounts, injected directly into vanilla death drops
- Spawn statistics — session, total (SQLite-persisted across restarts), hourly ring buffer and per-mob breakdown via
/pr stats
- Spawn heatmap —
/pr heatmap [radius] toggles a live particle overlay above tracked blocks, coloured blue → yellow → red by spawn density
- TPS diagnostics — async TPS monitor with configurable alert threshold, in-game op warnings and a
/pr diagnostics performance report
- Config updater — automatically migrates old config files to the current schema on startup, preserving all your values and creating a timestamped backup
- PlaceholderAPI — 8 placeholders for scoreboards and tab lists
- Folia-native — two scheduler implementations (
FoliaSchedulerService / BukkitSchedulerService) selected at runtime, zero issues on region-threaded servers
- Async update checker — Modrinth API v2, clickable in-game notification for ops on join
- Zero NMS — pure Bukkit/Spigot/Paper API, no reflection in hot paths
- Live reload —
/pr reload applies all config and registry changes with no restart
? Quick Start
- Drop the
.jar into your plugins/ folder
- Restart the server
- Edit
plugins/zNxPiglinRush/config.yml
- Run
/pr reload — done
⚙️ Configuration
enabled: true
active-worlds: [] # leave empty = all worlds
debug: false
spawners:
# Each block gets its own section — add as many as you like
magma_block:
mob: ZOMBIFIED_PIGLIN
spawn-count: 3 # total mobs per trigger (vanilla = 1)
spawn-cooldown: 20 # ticks between spawns on the same block
max-nearby-entities: 12 # entity cap within scan-radius
scan-radius: 10
extra-attempts: 1 # random bonus attempts per trigger
wave-mode: false # true = burst waves instead of immediate spawns
wave-size: 5
wave-cooldown: 100 # ticks between wave fires
custom-drops:
- material: GOLD_NUGGET
min: 1
max: 3
chance: 0.3
- material: GOLDEN_SWORD
min: 1
max: 1
chance: 0.05
# soul_sand:
# mob: WITHER_SKELETON
# spawn-count: 2
# ...
diagnostics:
tps-alert-threshold: 18.0
alert-cooldown-seconds: 300
update-checker: true
Tuning guide
| Server type |
spawn-count |
spawn-cooldown |
max-nearby-entities |
| Low-TPS / small |
2 |
40 |
8 |
| Standard |
3 |
20 |
12 |
| Dedicated farm server |
5 |
10 |
20 |
? If TPS drops, lower spawn-count or raise spawn-cooldown first.
? Commands & Permissions
| Command |
Alias |
Description |
/piglinrush reload |
/pr reload |
Reload config & spawner registry |
/piglinrush info |
/pr info |
Runtime, registered blocks, update status |
/piglinrush stats |
/pr stats |
Session / total / hourly spawn stats |
/piglinrush heatmap [r] |
/pr heatmap |
Toggle particle heatmap (player only) |
/piglinrush diagnostics |
/pr diag |
TPS report and performance suggestions |
/piglinrush toggle |
/pr toggle |
Toggle hint |
Permission node: piglinrush.admin (default: op)
? PlaceholderAPI
| Placeholder |
Returns |
%piglinrush_total% |
Total spawns since server start |
%piglinrush_session% |
Spawns since last /pr reload |
%piglinrush_last_hour% |
Spawns in the last hour |
%piglinrush_last_24h% |
Spawns in the last 24 hours |
%piglinrush_status% |
ENABLED / DISABLED |
%piglinrush_tps% |
Current average TPS |
%piglinrush_spawners% |
Number of registered spawner blocks |
%piglinrush_version% |
Plugin version |
❓ FAQ
Does this affect overworld magma blocks?
No. The plugin fires only when vanilla already triggers a spawn — in the Nether on magma blocks. Overworld magma blocks don't trigger natural piglin spawns, so the plugin has no effect there.
Does it break vanilla spawn rules?
The initial vanilla spawn check (light level, mob caps) still runs normally. Extra spawns respect the max-nearby-entities cap configured per block. Global server mob caps in paper.yml / spigot.yml / bukkit.yml still apply.
What is wave mode?
When enabled on a block, each vanilla trigger adds a credit to that block's counter. Every wave-cooldown ticks the engine fires a burst: credits × spawn-count mobs (capped at wave-size), with a progressive bonus for consecutive waves. Good for dramatic bursts rather than a constant stream.
Compatible with other spawn plugins?
Generally yes — zNxPiglinRush only reacts to events that already passed vanilla's own checks, with no NMS or spawner modifications.
What happens when I update from an old version?
The built-in Config Updater detects your old config, creates a timestamped backup, migrates your values to the new schema and fills any new keys with sensible defaults. You don't need to touch anything manually.
? Requirements
- Spigot, Paper or Folia 26.1.x
- Java 21+
- PlaceholderAPI (optional)
? License
This project is licensed under the Apache License 2.0 — see the LICENSE file for details.
评论 0
登录后参与评分
还没有评论,来抢沙发吧