
GPWildernessCleaner 用于减少在使用 GriefPrevention 的生存服务器中因实体堆积导致的延迟问题。该插件按计时器运行,仅移除 GP 领地(野外区域)内选定的实体类型。玩家或管理员的领地内的任何内容都不会受到影响。
与通用的清延迟插件不同,此插件围绕领地边界构建:它利用 GriefPrevention 的领地数据,确保领地内的农场、基地、村民和建筑保持安全,同时清理野外区域的实体。
为什么使用它?
- 庞大的野外农场和生物上限可能导致服务器出现数千只被动生物和掉落物品。
- 在全世界范围内清除实体在 GP 服务器上存在风险——可能会误删玩家依赖的无主区域中的动物,或与领地逻辑发生冲突。
- GPWildernessCleaner 仅针对野外区域,提供可配置的过滤器和每区块上限,使陆地和水生生物不会完全消失(有助于改善自然刷新的体验)。
会在野外移除的内容(启用时):
- 掉落物品
- 敌对生物
- 陆地被动生物(可选每区块上限)
- 水生生物——鱼、鱿鱼、海豚等(可选每区块上限)
- 投射物、经验球、区域效果云、下落方块、已点燃的 TNT
- 通过配置列表添加的其他实体类型
永远不会移除的内容(默认设置):
- 玩家
- 村民和流浪商人
- 驯服的动物
- 命名或记分板标签标记的生物
- 盔甲架、物品展示框、画作
- 任何位于 GriefPrevention 领地内的内容(当启用领地保护时)
默认情况下,车辆处于禁用状态;如需启用可自行开启。
按区块上限(被动生物与水生生物)
与其删除某个区块内的所有被动生物或鱼类,您可以为荒野区块保留少量数量,仅移除超出上限的部分。这能在减少卡顿的同时保留部分动物以供刷怪。将上限设置为 0 则在该类别中执行完全清理(更早期、更激进的行为)。
调度与公告
- 每 N 分钟自动运行一次(默认:10 分钟)
- 每次运行前可选的倒计时广播
- 自动运行后的可选摘要(已移除数量、因领地跳过数量、因上限保留数量)
- 服务器启动时可选运行
命令与说明
/gpwclean 或 /gpwclean status
显示启用状态、间隔时间、下次运行剩余时间、区块上限
立即执行清理
重新加载配置
权限:gpwildernesscleaner.admin(默认:OP)
安全性
如果配置要求 GriefPrevention 但未被加载,则不会执行清理——以避免在领地检测不可用时清空整个世界。
兼容 PlugMan:禁用插件时会取消定时任务,防止重载时堆叠重复定时器。
依赖要求
服务端:Paper(或兼容分支)1.21+(基于 1.21.11 API 构建;Java 21)
软依赖:GriefPrevention —— 强烈建议安装;领地检查功能依赖此插件
安装方法
- 将 <最新版本号>.jar 文件放入服务器的 plugins/ 文件夹中。
- 确保已安装 GriefPrevention。
- 启动或重启服务器。
- 根据需要编辑 plugins/GPWildernessCleaner/config.yml 配置文件。
- 修改配置后,使用 /gpwclean reload 命令重新加载插件。

GPWildernessCleaner reduces lag from entity buildup on survival servers that use GriefPrevention. It runs on a timer and removes selected entity types only outside GP claims (wilderness). Anything inside a player or admin claim is left alone.
Unlike generic clear-lag plugins, this plugin is built around claim boundaries: it uses GriefPrevention’s claim data so farms, bases, villagers, and builds inside claims stay safe while wilderness areas are trimmed.
Why use it?
- Large wilderness farms and mob caps can push servers to thousands of passive mobs and dropped items.
- Full-world entity clears are risky on GP servers — they can wipe animals in unclaimed areas players rely on, or conflict with claim logic.
- GPWildernessCleaner targets wilderness only, with configurable filters and per-chunk caps so land and aquatic mobs don’t disappear entirely (helping natural respawn feel better).
Removed in wilderness (when enabled):
- Dropped items
- Hostile mobs
- Land passive mobs (with optional per-chunk cap)
- Aquatic mobs — fish, squid, dolphins, etc. (with optional per-chunk cap)
- Projectiles, XP orbs, area effect clouds, falling blocks, primed TNT
- Extra entity types via config list
Never removed (defaults):
- Players
- Villagers and wandering traders
- Tamed animals
- Named or scoreboard-tagged mobs
- Armor stands, item frames, paintings
- Anything inside a GriefPrevention claim (when claim respect is enabled)
Vehicles are off by default; you can enable them if you want.
Per-chunk caps (passive & aquatic)
Instead of deleting every passive or fish in a chunk, you can keep a small number per wilderness chunk and only remove the excess. That cuts lag while leaving some animals for spawning. Set caps to 0 for full wipe in that category (older, harsher behavior).
Scheduling & announcements
- Automatic runs every N minutes (default: 10)
- Optional countdown broadcasts before each run
- Optional summary after auto-runs (removed count, claim-skipped count, kept-by-cap count)
- Optional run on server startup
Commands and Description
- /gpwclean or /gpwclean status
Show enabled state, interval, time until next run, chunk caps
Run cleanup immediately
Reload config
Permission: gpwildernesscleaner.admin (default: OP)
Safety
If GriefPrevention is required by config but not loaded, cleanup does not run — avoids clearing the whole world when claim detection isn’t available.
PlugMan-friendly: scheduled tasks are cancelled on disable so reloads don’t stack duplicate timers.
Requirements
Server: Paper (or compatible fork) 1.21+ (built against 1.21.11 API; Java 21)
Soft dependency: GriefPrevention — strongly recommended; claim checks depend on it
Installation
- Drop <latest version>.jar in your server’s plugins/ folder.
- Ensure GriefPrevention is installed.
- Start or restart the server.
- Edit plugins/GPWildernessCleaner/config.yml as needed.
- Use /gpwclean reload after config changes.
评论 0
登录后参与评分
还没有评论,来抢沙发吧