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
- /gpwclean run
Run cleanup immediately
- /gpwclean reload
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 .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.
