Skip to content

2b2names/EntityDensityLimiter

Repository files navigation

EntityDensityLimiter v1.0.0

Intelligent Collision-Reduction Utility for Paper 1.21.11

EntityDensityLimiter (EDL) is designed to mitigate one of the most significant sources of server-side lag: Entity Collision Calculations. On high-population servers, mob-cramming (e.g., 100 cows in a 1x1 area) forces the main thread to calculate hundreds of thousands of physics interactions every tick.

EDL solves this by performing high-frequency radial scans and surgically culling excess entities while preserving "High-Value" mobs.


🛠 Features

  • Radial Scan Logic: Scans a tight 1.5-block radius around entities to identify illegal "clusters" rather than just counting per-chunk.
  • Smart Culling: Prioritizes server performance while protecting player assets.
  • Pet & Name Protection: Automatically ignores named mobs and tamed animals (dogs, cats, etc.) to prevent accidental loss of "sentimental" entities.
  • Low-Overhead Tasks: Executes scans on a configurable heartbeat interval to ensure the diagnostic itself doesn't cause lag.

⚙️ Configuration

# Max entities of the same type allowed in a 3x3x3 area
max-density: 16

# Check interval in ticks (20 ticks = 1 second)
# Higher = better performance, Lower = faster response
check-interval: 100

# Safety Settings
ignore-named: true
ignore-tamed: true

About

Surgical entity culling engine designed to mitigate collision-based CPU lag. Features radial scanning and "High-Value" mob protection for optimized survival environments.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages