GPWildernessCleaner

!(https://cdn.modrinth.com/data/cached_images/62dc7247083244eabc74f5cb2a07542f39002266.jpeg)

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.