Skip to main content

Troubleshooting

Plugin Fails to Load​

Symptom: No SigmaClearLag output in console.

Checklist:

  • Java 21+ installed
  • Paper or Spigot 1.21+ server
  • JAR not corrupted

Items Disappearing That Should Be Protected​

Symptom: Valuable items are being cleared even though they're in the whitelist.

Steps:

  1. Confirm the material name is correct and in UPPERCASE: NETHERITE_INGOT not netherite_ingot
  2. Run /lag reload after editing the whitelist
  3. Check that sweep.items: true — if this is false, items should never be cleared

Named/Tamed Mobs Being Removed​

Symptom: Named or tamed entities are removed during a sweep.

Fix: Verify protection settings in config.yml:

protection:
  named-entities: true
  tamed-mobs: true

Run /lag reload. If the issue persists, confirm the entity is actually named (right-click with a Name Tag) or tamed (ownership data exists).

Warning Messages Not Appearing​

Symptom: Players see no warnings before a clear.

Fix:

  1. Ensure warning-times has entries: [60, 30, 10, 5]
  2. Check messages.warning is not empty
  3. Confirm schedule-interval is longer than the highest warning time (e.g. interval 300 with warning at 60 works, but interval 30 with warning at 60 would never fire the warning)

Manual Clear Not Working​

Symptom: /lag clear runs but entities aren't removed.

Fix:

  1. Confirm sweep.* options are enabled for the entity types you want removed
  2. Check that no protection rules are catching all entities (e.g. all mobs are tamed)
  3. Verify the player has sigmaclearlag.clear permission

High TPS Impact During Clears​

Symptom: Server lags at each scheduled clear.

Fix:

  1. Lower chunks-per-tick (e.g. from 20 to 10)
  2. Increase schedule-interval to clear less frequently
  3. Tighten per-chunk limits to prevent large entity concentrations in the first place

PlaceholderAPI Countdown Showing 0​

Symptom: %sigmaclearlag_countdown% always returns 0.

Fix:

  1. Ensure PlaceholderAPI loads before SigmaClearLag
  2. Run /lag reload
  3. Confirm the placeholder string is exactly %sigmaclearlag_countdown%

Folia: Chunks Not Being Scanned​

Symptom: On Folia, some chunks seem untouched by the clear.

Note: On Folia, each chunk region is processed independently. Very large worlds with many active regions may see minor timing differences. This is expected behaviour — all loaded chunks will be processed, but not necessarily in the same tick.