---

Description
MobChunkLimit is a powerful and user-friendly Minecraft plugin designed to help server administrators optimize performance by controlling the number of mobs within individual chunks. Whether you're tackling lag caused by large mob farms, overloaded spawners, or unregulated animal breeding, this plugin provides an elegant, configurable solution.

---

Features

• Chunk-Specific Mob Limits
  Set maximum limits for different mob types (e.g., animals, monsters, villagers) per chunk.
  Customize the action taken when limits are reached — remove excess mobs, block spawns, or send warnings.
  
• Intuitive GUI Management
  Manage mob limits effortlessly with a clean, paginated GUI.
  Click any mob icon → enter new limit → instantly applied.
  No configuration editing required — fully automated and admin-friendly.
  
• Whitelist & Blacklist System
  Exclude key mobs (e.g., bosses) from limits using a whitelist.
  Block annoying mobs (e.g., bats) entirely using a blacklist.
  
• Real-Time Mob Monitoring
  Check the exact number of mobs in ANY chunk instantly with built-in commands.
  Identify problematic areas on your server with ease.
  
• Dynamic Action Customization
  Define the server's response when limits are exceeded:
  - Remove extra mobs automatically.
  - Prevent mob spawners from triggering.
  - Warn players inside the chunk with fully customizable messages.
  
• Optimized for Performance
  Tracks mobs dynamically with zero lag.
  Designed to run on large servers with minimal impact.
  
• Command Accessibility
  Admins can reload config, scan chunks, update limits, and view mob counts with simple commands.
  
• Permission-Based Control
  Limit access to features and commands so only authorized users can modify mob behavior.
  
  NEW: Advanced Chunk Load Analyzer (Admin Tool)
  
• Top Mob-Heavy Chunks GUI
  Instantly view a ranked list of the heaviest mob-loaded chunks on your server.
  Perfect for finding lag sources caused by uncontrolled mob farms or grinders.
  
• Detailed Chunk Breakdown
  Click any chunk in the GUI to see EXACTLY which mob types cause the load.
  Shows per-mob counts (Zombies, Villagers, Slimes, Iron Golems, etc.).
  
• Admin Teleportation Tool
  One-click teleport directly to problematic chunks.
  Allows staff to instantly inspect mob farms, mob grinders, or lag machines.
  
• Async Scanning Engine
  Chunk scanning is done asynchronously, ensuring the analyzer NEVER impacts TPS.
  Ideal for performance-focused servers and large playerbases.
  
• Extremely Helpful for Administrators
  This tool gives admins a complete overview of:
  - Where mobs are accumulating
  - Which worlds contain the most overloaded chunks
  - What mob types generate the most lag
  - Where to teleport to fix issues immediately
  A must-have feature for survival, SMP, factions, skyblock, and modded servers.

---

Commands
---

Permissions

• mobchunklimit.gui - Allows access to the GUI for managing mob limits.
• mobchunklimit.reload - Allows reloading the plugin configuration.
• mobchunklimit.check - Allows viewing the mob count in the current chunk.
• mobchunklimit.setlimit - Allows setting mob limits via command.

---

How It Works

• Effortless GUI Management:
  Use `/mobchunklimit gui` to open the intuitive interface.
  Click on any mob type to set its limit with ease.
  Navigate between pages to find every mob in the game.
  Changes made in the GUI are applied instantly and saved.
  
• Configurable Limits:
  Set mob limits globally for each mob type via commands, GUI, or configuration.
  
• Real-Time Monitoring:
  Use `/mobchunklimit check` to see all mob counts in your current chunk.
  
• Action Customization:
  Choose what happens when limits are reached: remove mobs, block spawning, or notify players.

---

Benefits

• Supercharged GUI: Adjust mob limits with a simple click – no need to edit files or restart the server!
• Optimized Performance: Reduces lag caused by excessive mobs and mob farms.
• Customizable: Full control over limits, actions, and messages.
• Easy to Use: Friendly commands and an intuitive GUI make server management a breeze.

---

Installation

1. Download the latest release from SpigotMC.
2. Place the `.jar` file in your server’s `plugins` folder.
3. Restart the server to generate the default configuration.
4. Use `/mobchunklimit reload` to apply changes without restarting the server.

---

Compatibility
Minecraft Versions: Compatible with 1.16 - 1.20+
Server Types: Spigot, Paper, and other Spigot-compatible servers.

---

Support