Quickstart

Get SigmaClearLag running in 3 steps.

Prerequisites

• Paper or Spigot 1.21+ server
• Java 21+
• (Optional) PlaceholderAPI for countdown placeholder

Step 1 — Install

1. Drop SigmaClearLag.jar into your plugins/ folder
2. Restart your server

Console output:

[SigmaClearLag] Plugin enabled successfully!

The default config is generated at plugins/SigmaClearLag/config.yml.

Step 2 — Review Default Settings

The defaults are sensible for most servers. Review these key values:

schedule-interval: 300        # 5-minute cleanup cycle
warning-times: [60, 30, 10, 5]  # warnings in seconds before clear

sweep:
  items: true
  xp-orbs: true
  mobs: true
  vehicles: true

If you have item drops you want to protect, add them to the item whitelist:

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

Step 3 — Test

Run a manual clear to confirm everything works:

/lag clear

Check chat — players should see the cleanup message and a report of what was removed.

Quick Config Reference

Setting	Default	Purpose
schedule-interval	300	Seconds between auto-clears
warning-times	60, 30, 10, 5	Warning countdown points
item-whitelist	Several	Items never cleared
chunks-per-tick	20	Scan throughput (Paper only)

Next Steps

• Configuration Reference — Full options including per-chunk and global caps
• Commands — Manual clear, info, reload
• Features — Entity protection rules explained