Smart Chunk Janitor

🧹 Smart Chunk Janitor: Anti-Lag & Entity Limiter

Keep your Minecraft 1.20.1 server running at a locked 20 TPS — without deleting your players' death drops, breaking item sorters, or culling farm breeders!

🎯 Why Smart Chunk Janitor?

Traditional entity-clear mods frustrate players by blindly wiping out freshly dropped Death Piles, pulling items through walls out of redstone sorters, or culling adult breeding animals and minecart contraptions.

Smart Chunk Janitor is an engineered, zero-dependency Server-Side anti-lag utility built for Minecraft Forge 1.20.1 (Forge 47.1.0+). It combines death-drop-safe timed ground sweeps, line-of-sight item & XP clumping, chunk-indexed entity limiting, and a dual Entity + BlockEntity (TileEntity) lag radar into one lightweight package.

• 100% Server-Side Compatible (IGNORE_SERVER_VERSION): Install it on your dedicated server and vanilla or modded clients can join immediately without installing the mod locally.
• Server-Side Chat Localization (works without client installation): Choose "en_us" or "ar_sa" directly in smartchunkjanitor-common.toml (serverLanguage) and customize broadcast messages server-side—no client language files required.

✨ Key Features

🕒 1. Timed Ground Item Sweep (Death-Drop & Loot Safe!)

• Automatically clears dropped ItemEntities on a configurable timer (Default: every 10 minutes / 600s).
• Broadcasts customizable chat countdown warnings at 30 seconds and 10 seconds before each sweep using crash-safe {seconds} placeholders.
• Fresh Death-Drop Protection (minItemAgeSeconds = 45 seconds): Any item dropped within the last 45 seconds (900 ticks) is automatically spared, ensuring players never lose fresh death drops or items they just tossed to a teammate.
• Modpack-Friendly Smart Loot Protection:
  • Custom-named items (Name Tags or anvil-renamed gear) are always spared.
  • Diamond & Netherite weapons, tools, armor, and materials are spared by default.
  • Any item inside the #smartchunkjanitor:protected_items datapack tag (Totem of Undying, Elytra, Nether Star, Beacon, Dragon Egg, Enchanted Golden Apple, dropped Shulker Boxes, etc.) or the protectedItems config list is spared.
  • protectRareItems = false by default so modded items with non-common rarity don't bypass sweeping in heavy modpacks (can be enabled in config if desired).

🧲 2. Wall-Safe Smart Item & XP Orb Clumping

• Periodically merges nearby identical ItemEntities and ExperienceOrbs within a 1.5-block radius (clumpRadius = 1.5), with separate toggles for items (enableItemClumping) and XP orbs (enableXpClumping).
• Line-of-Sight Raycast Check (requireLineOfSight = true): Uses block collider raycasting so items and XP orbs never phase through walls, glass panes, or adjacent hopper sorting chambers.

🛡️ 3. High-Performance Per-Chunk Entity Limiter

• Uses deduplicated per-chunk AABB spatial queries (level.getEntities) around active simulation chunks and batches spawn checks every 20 ticks—never calling level.getAllEntities().
• If monsters or farm animals in a single chunk exceed the configurable cap (Default: 35 per chunk), automatically trims excess entities.
• Breeder-Safe Culling Order (cullNewestFirst = true): Removes the newest excess entities first by default so adult breeding pairs in player farms aren't replaced by babies.
• Strict Contraption & Pet Exemptions: Never removes Named Entities, Persistent Mobs (PersistenceRequired), Leashed Mobs (Mob#isLeashed), Riding/Vehicle Entities (isPassenger / isVehicle), Tamed Pets & Mounts, Villagers & Traders, Golems & Allays, Bosses (#forge:bosses, Ender Dragon, Wither, Warden, Elder Guardian), or #smartchunkjanitor:exempt_entities.

📊 4. Dual Lag Radar: Entities + BlockEntities (/janitor stats)

• Instantly diagnose both mob grinders and laggy machine/hopper bases with two dedicated top-5 leaderboards in /janitor stats:
  1. Top 5 Chunks by Entities (with dimension, chunk/block coordinates, Total Entities, Monsters, Animals, and Dropped Items breakdown)
  2. Top 5 Chunks by BlockEntities (TileEntities) (pinpointing hopper-, furnace-, chest-, and modded-machine-heavy chunks)

💻 Admin Commands (/janitor)

📦 Modpack Permission

✅ FREE TO USE IN ANY MODPACK! You have full permission to include Smart Chunk Janitor in any public or private CurseForge, Modrinth, or third-party modpack or server pack.