# ChunkEntityLimiter<\/p>\n
**High-Performance Entity & Item Limiter for Folia, Paper, Bukkit, Purpur, and Spigot.**<\/p>\n
This plugin optimizes server performance by intelligently limiting entity and item counts. It employs a **dual-check system** (Single Chunk Limit + Player Surrounding Chunks Limit) to prevent lag from mob farms or massive item drops, while ensuring important entities are protected.<\/p>\n
## Key Features<\/p>\n
* **Native Folia Support:** Fully optimized for Folia’s regional threading architecture.
\n* **Smart Cleanup Logic:** **Oldest First.** Entities are removed based on their generation time. The longest-living entities are removed first to preserve newly spawned mobs.
\n* **Dual-Layer Limiting:** Limits are applied to individual chunks *and* the aggregate group of chunks around a player.
\n* **Precise Item Counting:** Configurable option to count item stacks by their actual amount (e.g., a stack of 64 Cobblestone counts as 64, not 1).
\n* **Granular Notifications:** Separate controls for **Cleanup Reports** and **Overload Warnings**, with configurable scopes (None, OP only, or All Players nearby).
\n* **Performance Monitoring:** Built-in performance profiler to track cleanup phases.<\/p>\n
——————————————————————————————————<\/p>\n
## Cleanup Logic<\/p>\n
1. **Classification:** Entities are categorized into “Protected” and “Removable”.
\n2. **Protection Check:** Protected entities (Named, Leashed, Tamed, Equipped, Bosses) are skipped unless `clean-protected-if-over-limit` is enabled.
\n3. **Sorting:** Removable entities are sorted by **Spawn Time**.
\n4. **Execution:** The plugin removes entities starting from the **Earliest Generated (Oldest)** until the count drops below the limit.<\/p>\n
——————————————————————————————————<\/p>\n
## Commands & Permissions<\/p>\n
**Main Command:** `\/chunklimit`
\n**Aliases:** `\/cl`, `\/climit`<\/p>\n
| Command | Description | Permission |
\n| :— | :— | :— |
\n| **`\/chunklimit reload`** | Reloads the configuration file. | `chunklimiter.reload` (default: op) |
\n| **`\/chunklimit stats`** | Displays detailed entity statistics for the current chunk and surrounding radius. | `chunklimiter.stats` (default: true) |
\n| **`\/chunklimit notify [type] [scope]`** | Set notification preferences.
\u2022 **Type:** `report` (Cleanup result) or `warning` (Near limit)
\u2022 **Scope:** `none` (Off), `op` (Admins only), `all` (Everyone nearby)
_Example:_ `\/cl notify report op` | `chunklimiter.notify` (default: op) |
\n| **`\/chunklimit performance [reset]`** | View performance metrics (execution time for classification, cleanup, etc.). | `chunklimiter.performance` (default: op) |<\/p>\n
——————————————————————————————————<\/p>\n
#### config.yml<\/p>\n
“`
\n# Entity and item drop limits configuration. It will only clear parts that exceed the limits.
\n# \u533a\u5757\u5b9e\u4f53\u3001\u6389\u843d\u7269\u9650\u5236\u914d\u7f6e\uff0c\u53ea\u4f1a\u6e05\u7406\u8d85\u51fa\u7684\u90e8\u5206
\nentity-limits:
\n # Default maximum number of entities allowed per chunk (all entities except those with special configurations)
\n # \u9ed8\u8ba4\u6bcf\u4e2a\u533a\u5757\u5141\u8bb8\u7684\u6700\u5927\u5b9e\u4f53\u6570\u91cf\uff08\u9664\u7279\u6b8a\u914d\u7f6e\u5916\u7684\u6240\u6709\u5b9e\u4f53\uff09
\n default-limit: 100<\/p>\n
# Maximum number of item entities allowed (item drops)
\n # \u7269\u54c1\u5b9e\u4f53\u7684\u6700\u5927\u6570\u91cf\u9650\u5236\uff08\u6389\u843d\u7269\uff09
\n item-limit: 300<\/p>\n
# Check interval (in game ticks, 20 ticks = 1 second)
\n # Recommended: 600 (30s) or 1200 (60s) for performance
\n # \u68c0\u67e5\u95f4\u9694\uff08\u5355\u4f4d\uff1a\u6e38\u620f\u523b\uff0c20 ticks = 1\u79d2\uff09
\n # \u63a8\u8350\u8bbe\u7f6e\uff1a600 (30\u79d2) \u6216 1200 (60\u79d2) \u4ee5\u8282\u7701\u6027\u80fd
\n check-interval-ticks: 600<\/p>\n
# Whether to check chunks around the player. 0 means disabled.
\n # Example: If chunk-check-radius: 1, the total limit for all chunks (3×3) within radius 1 around the player is calculated.
\n # \u662f\u5426\u5305\u542b\u68c0\u67e5\u73a9\u5bb6\u5468\u56f4\u7684\u533a\u5757\uff0c0\u8868\u793a\u7981\u7528
\n # \u4f8b\u5982: \u8bbe\u7f6e\u4e3a 1 \u8868\u793a\u68c0\u67e5\u73a9\u5bb6\u5468\u56f4 3×3 \u7684\u533a\u5757\u8303\u56f4
\n chunk-check-radius: 2<\/p>\n
# Multiplier for entity limits in chunks around the player.
\n # Example: If set to 1.5, the limit for chunks in the radius will be 1.5x the default limit.
\n # \u73a9\u5bb6\u5468\u56f4\u7684\u533a\u5757\u5b9e\u4f53\u9650\u5236\u500d\u6570 (\u5bbd\u677e\u7cfb\u6570)
\n # \u4f8b\u5982: \u8bbe\u7f6e\u4e3a 1.5\uff0c\u5219\u5468\u56f4\u533a\u5757\u7684\u5b9e\u4f53\u4e0a\u9650\u662f\u9ed8\u8ba4\u503c\u7684 1.5 \u500d
\n chunk_entity_multiplier: 1.5<\/p>\n
# Multiplier for item entity limits in chunks around the player.
\n # \u73a9\u5bb6\u5468\u56f4\u7684\u533a\u5757\u7269\u54c1\u5b9e\u4f53\u9650\u5236\u500d\u6570
\n chunk_item_multiplier: 1.5<\/p>\n
# Whether to count item stack amounts towards the limit
\n # If true, a stack of 64 items counts as 64. If false, it counts as 1 entity.
\n # \u662f\u5426\u8ba1\u7b97\u7269\u54c1\u5806\u53e0\u6570\u91cf
\n # \u82e5\u4e3a true\uff0c\u4e00\u7ec464\u4e2a\u7269\u54c1\u7b97\u4f5c64\u3002\u82e5\u4e3a false\uff0c\u7b97\u4f5c1\u4e2a\u5b9e\u4f53\u3002
\n count-item-stack-amount: false<\/p>\n
# Ignored entity types (these will not be counted or cleared)
\n # \u5ffd\u7565\u7684\u5b9e\u4f53\u7c7b\u578b\uff08\u4e0d\u4f1a\u88ab\u8ba1\u6570\u548c\u6e05\u7406\uff09
\n ignored-types:
\n – IRON_GOLEM # Iron Golem \/ \u94c1\u5080\u5121
\n – VILLAGER # Villager \/ \u6751\u6c11<\/p>\n
# Ignored item types (these will not be counted or cleared)
\n # \u5ffd\u7565\u7684\u7269\u54c1\u7c7b\u578b\uff08\u4e0d\u4f1a\u88ab\u8ba1\u6570\u548c\u6e05\u7406\uff09
\n ignored-items:
\n – DIAMOND # Diamond \/ \u94bb\u77f3
\n – NETHERITE_INGOT # Netherite Ingot \/ \u4e0b\u754c\u5408\u91d1\u952d
\n – ENCHANTED_GOLDEN_APPLE # Enchanted Golden Apple \/ \u9644\u9b54\u91d1\u82f9\u679c<\/p>\n
# Custom entity limits (override the default limits)
\n # \u81ea\u5b9a\u4e49\u5b9e\u4f53\u9650\u5236\uff08\u8986\u76d6\u9ed8\u8ba4\u9650\u5236\uff09
\n custom-limits:
\n ZOMBIE: 200 # Maximum number of Zombies \/ \u50f5\u5c38\u6700\u5927\u6570\u91cf
\n CREEPER: 200 # Maximum number of Creepers \/ \u82e6\u529b\u6015\u6700\u5927\u6570\u91cf
\n ZOMBIFIED_PIGLIN: 200 # Maximum number of Zombified Piglins \/ \u732a\u4eba\u6700\u5927\u6570\u91cf<\/p>\n
# Protection Settings, entities exceeding the limit will not be prioritized for cleaning, and protected entities exceeding the limit will still be cleaned up
\n# \u4fdd\u62a4\u8bbe\u7f6e\uff0c\u5b9e\u4f53\u8d85\u8fc7\u9650\u5236\u65f6\u4e0d\u4f1a\u88ab\u4f18\u5148\u6e05\u7406\uff0c\u53d7\u4fdd\u62a4\u7684\u5b9e\u4f53\u6570\u91cf\u8d85\u8fc7\u9650\u5236\u65f6\u4ecd\u5c06\u88ab\u6e05\u7406
\nprotection:
\n # Protect entities with custom names
\n # \u4fdd\u62a4\u88ab\u547d\u540d\u7684\u5b9e\u4f53
\n protect-named-entities: true<\/p>\n
# Protect leashed mobs (horses\/donkeys excluded by default)
\n # \u4fdd\u62a4\u88ab\u62f4\u4f4f\u7684\u5b9e\u4f53
\n protect-leashed-entities: true<\/p>\n
# Prevent harming tamed pets (dogs\/cats\/parrots)
\n # \u4fdd\u62a4\u9a6f\u670d\u7684\u52a8\u7269
\n protect-tamed-animals: true<\/p>\n
# Protect mobs wearing armor\/items (including dropped gear)
\n # \u4fdd\u62a4\u6709\u88c5\u5907\u7684\u5b9e\u4f53
\n protect-equipped-entities: true<\/p>\n
# Prevent altering boss-type mobs (Ender Dragon, Wither, etc.)
\n # \u4fdd\u62a4Boss\u5b9e\u4f53
\n protect-boss-entities: true<\/p>\n
# Notification settings
\n# \u901a\u77e5\u8bbe\u7f6e
\nsettings:
\n # Whether to clean up protected entities when the limit is exceeded
\n # If true: Normal entities are removed first, then protected ones if still over limit.
\n # If false: Protected entities are never removed (but count towards the total).
\n # \u5f53\u6570\u91cf\u8d85\u9650\u65f6\uff0c\u662f\u5426\u5f3a\u5236\u6e05\u7406\u53d7\u4fdd\u62a4\u7684\u5b9e\u4f53
\n # \u82e5\u4e3a true\uff1a\u5148\u6e05\u7406\u666e\u901a\u5b9e\u4f53\uff0c\u82e5\u4ecd\u8d85\u9650\u5219\u6e05\u7406\u4fdd\u62a4\u5b9e\u4f53\u3002
\n # \u82e5\u4e3a false\uff1a\u53d7\u4fdd\u62a4\u5b9e\u4f53\u6c38\u8fdc\u4e0d\u4f1a\u88ab\u6e05\u7406\uff08\u4f46\u4f1a\u5360\u7528\u6570\u91cf\u540d\u989d\uff09\u3002
\n clean-protected-if-over-limit: true<\/p>\n
# Whether to enable global single chunk cleaning (Phase 1).
\n # If false: Skips global scan, only cleans chunks near players (Phase 2). Recommended false for Folia.
\n # \u662f\u5426\u542f\u7528\u5168\u5c40\u5355\u533a\u5757\u6e05\u7406\uff08\u9636\u6bb51\uff09\u3002
\n # \u82e5\u4e3a false\uff1a\u8df3\u8fc7\u5168\u5c40\u626b\u63cf\uff0c\u4ec5\u6e05\u7406\u73a9\u5bb6\u9644\u8fd1\u7684\u533a\u5757\uff08\u9636\u6bb52\uff09\u3002Folia \u7aef\u5efa\u8bae\u8bbe\u4e3a false \u4ee5\u63d0\u5347\u6027\u80fd\u3002
\n clean-all-loaded-chunks: true<\/p>\n
# Notification scope for cleanup reports (when entities are removed)
\n # Options: NONE (disable), OP (admins only), ALL (all players in radius)
\n # \u6e05\u7406\u62a5\u544a\u901a\u77e5\u8303\u56f4\uff08\u5f53\u5b9e\u4f53\u88ab\u6e05\u7406\u65f6\uff09
\n # \u9009\u9879: NONE (\u7981\u7528), OP (\u4ec5\u7ba1\u7406\u5458), ALL (\u6240\u6709\u73a9\u5bb6)
\n cleanup-report-scope: ALL<\/p>\n
# Notification scope for overload warnings (when nearing limit)
\n # Options: NONE (disable), OP (admins only), ALL (all players in radius)
\n # \u8d85\u9650\u9884\u8b66\u901a\u77e5\u8303\u56f4\uff08\u5f53\u63a5\u8fd1\u4e0a\u9650\u65f6\uff09
\n # \u9009\u9879: NONE (\u7981\u7528), OP (\u4ec5\u7ba1\u7406\u5458), ALL (\u6240\u6709\u73a9\u5bb6)
\n overload-warning-scope: ALL<\/p>\n
# Whether OPs should receive global notifications for cleanup reports
\n # If true: OPs receive reports from all chunks. If false: OPs must be nearby.
\n # \u662f\u5426\u5411OP\u53d1\u9001\u5168\u5c40\u6e05\u7406\u62a5\u544a\u901a\u77e5\uff08\u5168\u670d\u5e7f\u64ad\u7ed9OP\uff09
\n # \u82e5\u4e3a true\uff1aOP \u63a5\u6536\u6240\u6709\u533a\u5757\u7684\u62a5\u544a\u3002\u82e5\u4e3a false\uff1aOP \u5fc5\u987b\u5728\u9644\u8fd1\u3002
\n op-global-cleanup-report: true<\/p>\n
# Whether OPs should receive global notifications for overload warnings
\n # If true: OPs receive warnings from all chunks. If false: OPs must be nearby.
\n # \u662f\u5426\u5411OP\u53d1\u9001\u5168\u5c40\u8d85\u9650\u9884\u8b66\u901a\u77e5\uff08\u5168\u670d\u5e7f\u64ad\u7ed9OP\uff09
\n # \u82e5\u4e3a true\uff1aOP \u63a5\u6536\u6240\u6709\u533a\u5757\u7684\u9884\u8b66\u3002\u82e5\u4e3a false\uff1aOP \u5fc5\u987b\u5728\u9644\u8fd1\u3002
\n op-global-overload-warning: false<\/p>\n
# Whether to send cleanup reports to the server console
\n # \u662f\u5426\u5c06\u6e05\u7406\u62a5\u544a\u53d1\u9001\u5230\u670d\u52a1\u5668\u63a7\u5236\u53f0
\n console-cleanup-report: true<\/p>\n
# Warning notification percentage (0-100).
\n # \u9884\u8b66\u901a\u77e5\u767e\u5206\u6bd4\uff080-100\uff09
\n notify-threshold: 90<\/p>\n
# Warning cooldown time, in seconds
\n # \u9884\u8b66\u51b7\u5374\u65f6\u95f4\uff0c\u5355\u4f4d\u79d2
\n notify-cooldown: 10<\/p>\n
# Player notification scope radius
\n # \u73a9\u5bb6\u901a\u77e5\u8303\u56f4\u534a\u5f84
\n notification-radius: 128.0<\/p>\n
# Set to true to enable performance monitoring
\n # \u8bbe\u4e3a true \u542f\u7528\u6027\u80fd\u76d1\u63a7
\n performance-monitoring: false<\/p>\n
# Set to true to enable debug mode (verbose logging)
\n # \u8bbe\u4e3a true \u542f\u7528\u8c03\u8bd5\u6a21\u5f0f\uff08\u8be6\u7ec6\u65e5\u5fd7\uff09
\n debug-mode: false<\/p>\n
# Language option (en\/zh)
\n # \u8bed\u8a00\u9009\u9879\uff08en\/zh\uff09
\n language: en
\n“`<\/p>\n
———————————————————————————————————-<\/p>\n
### bStats
\n<\/p>\n","protected":false},"excerpt":{"rendered":"
This system boosts performance by automatically capping entities\/items in loaded chunks and player-adjacent areas<\/p>\n","protected":false},"featured_media":40122,"template":"","meta":{"_minecraft_slug":"chunkentitylimiter","_minecraft_project_id":"zeqY8MMa","_minecraft_author":"Kurt5","_minecraft_license":"Apache-2.0","_minecraft_downloads":1347,"_minecraft_follows":10,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"chunkentitylimiter.zip","_minecraft_size_bytes":451902,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-16T07:35:16.190673Z","_minecraft_date_created":"2025-02-12T00:32:47.577801Z","_minecraft_date_modified":"2026-04-18T08:33:22.833769Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/chunkentitylimiter","_minecraft_icon_attachment_id":40122,"_minecraft_imported_at":"2026-06-01T21:25:32+00:00","_minecraft_import_hash":"c042ce913158288253ffedd5505befd3","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,89,126,90,127,128,129,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-40121","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n