Skip to main content

Configuration

All settings live in plugins/SigmaClearLag/config.yml. Apply changes with /lag reload.

Full Config Reference​

Schedule​

schedule-interval: 300      # seconds between automatic clears (default: 5 minutes)
warning-times: [60, 30, 10, 5]   # seconds before clear to broadcast warnings
chunks-per-tick: 20         # chunk scan throughput per scheduler tick (Paper only)
KeyDefaultDescription
schedule-interval300Seconds between auto-clears
warning-times[60, 30, 10, 5]Warning broadcast thresholds
chunks-per-tick20Chunk scan rate — ignored on Folia

Sweep Actions​

sweep:
  items: true           # Remove dropped item entities
  xp-orbs: true         # Remove experience orbs
  projectiles: true     # Remove most projectiles (Tridents excluded by default)
  mobs: true            # Enforce per-chunk and global mob limits
  vehicles: true        # Remove excess minecarts

Item Whitelist​

Items listed here are never cleared, even when sweep.items: true.

item-whitelist:
  - DIAMOND
  - NETHERITE_INGOT
  - ELYTRA
  - TOTEM_OF_UNDYING
  - NETHERITE_SCRAP
  - DIAMOND_SWORD

Add any material name in uppercase MATERIAL_NAME format.

Entity Protection​

protection:
  named-entities: true       # Entities with a custom name tag are protected
  tamed-mobs: true           # Tamed wolves, cats, horses, etc.
  villagers: true            # All villager variants (including wandering traders)
  armor-stands: true         # Armor stands
  leashed-entities: true     # Any entity currently on a leash
  ridden-entities: true      # Any entity a player is currently riding

Per-Chunk Mob Limits​

Applied during sweeps — excess mobs are removed until within limits.

per-chunk-limits:
  default-mob-max: 30
  specific:
    ZOMBIE: 10
    SPIDER: 8
    CREEPER: 5
    PHANTOM: 4

Global Mob Caps​

Server-wide caps regardless of chunk distribution.

global-limits:
  ZOMBIE: 300
  SKELETON: 200
  SPIDER: 150
  CREEPER: 100
  PHANTOM: 50
  SLIME: 100
  ENDERMAN: 100

Vehicle Limits (Per-Chunk)​

vehicle-limits:
  MINECART: 10
  CHEST_MINECART: 5
  HOPPER_MINECART: 5

Messages​

messages:
  warning: "&c[ClearLag] &eClearing entities in &a{time} &eseconds!"
  cleared: "&c[ClearLag] &eCleared &a{count} &eentities!"
  info: "&6Next clear in: &a{time} seconds"

Placeholders: {time} — seconds remaining / until next clear, {count} — entities removed.

PlaceholderAPI​

PlaceholderReturns
%sigmaclearlag_countdown%Seconds until next auto-clear