Common Issues

If you're experiencing problems with ClearLaggEnhanced, here are some of the most common issues and how to fix them.

Issue: Plugin fails to load

Problem: You see error messages in the console during server startup, and the plugin doesn't appear in /plugins.

Solution:

  1. Check the server console for specific error logs.
  2. Ensure you're running on a supported Minecraft version (1.17 - 1.20+).
  3. Ensure you have Java 17 or higher installed on your server.
  4. Verify that you have a database (SQLite or MySQL) correctly configured in config.yml.

Issue: Entities are being cleared too often

Problem: The entity clearing process runs more frequently than desired.

Solution:

  1. Open plugins/ClearLaggEnhanced/modules/entity-clearing/config.yml.
  2. Locate the interval-seconds setting and increase the value.
  3. Run /clearlagg reload.

Issue: Lag persists after installation

Problem: The server continues to experience low TPS even after configuring the plugin.

Solution:

  1. Use /cl findchunks to see if specific chunks are the source of the lag.
  2. Check if any other plugins are causing high MSPT using the Performance command.
  3. Adjust your mob-limiter and spawner-limiter settings to be more aggressive.

Issue: Command not found

Problem: When typing /clearlagg, you get a "Command not found" or similar message.

Solution:

  1. Verify the plugin is correctly installed and loaded (/plugins).
  2. Ensure you have the correct permission: clearlagg.admin.
  3. Check for any conflicting plugins that might be overriding the /clearlagg command.