Misc Entity Limiter

This module allows for granular control over miscellaneous entities that might contribute to lag, such as Armor Stands, Boats, and Minecarts.

Configuration

The configuration for this module is located at plugins/ClearLaggEnhanced/modules/misc-entity-limiter/config.yml.

enabled: true

# Maximum number of each entity type allowed per chunk
# Use -1 for no limit
limits-per-chunk:
  ARMOR_STAND: -1
  BOAT: 5
  CHEST_BOAT: 5
  MINECART: 5
  ITEM_FRAME: -1
  GLOW_ITEM_FRAME: -1
  LEASH_HITCH: -1
  PAINTING: 5

# Protection settings for specific entities
protect:
  # Do not remove entities that have a custom name
  named: true
  # Do not remove entities with these metadata tags
  tags:
    - "CLE_PROTECTED"

# Background sweep settings
sweep:
  # How often (in ticks) to check for over-limits
  interval-ticks: 100
  # Performance throttling: max chunks to check per tick
  max-chunks-per-tick: 20

# Notification settings for admins
notify:
  admins-permission: "CLE.admin"
  throttle-seconds: 60

# Apply only in these worlds (empty [] = all worlds)
worlds: []

Features

Per-Chunk Limits

You can specify the maximum number of entities allowed within a single chunk. If the limit is exceeded, the module will automatically remove the oldest entities during the next sweep.

Entity Protection

You can protect specific entities from being removed by:

• Naming them with a name tag.
• Adding metadata tags to the entities (useful for other plugins or advanced setups).

Performance Throttling

The sweep settings ensure that the plugin doesn't consume too many server resources while checking for entities by limiting how many chunks are checked per tick.

Admin GUI

Easily toggle limits and enable/disable the module via /lagg admin.