Omega Chat Clear

OmegaClearChat is a lightweight, high-performance chat-clearing plugin designed to eliminate the lag spike that plagues other chat clearers. Instead of dumping hundreds of blank lines in a single tick, OmegaClearChat sends them in small, configurable batches — keeping your server and your players' clients smooth.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ GIF
━━━━━━━━━━━━━━━━━━━━━━━━━━━━


━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ FEATURES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✔ Lag-Free Batched Sending — Blank lines are spread across ticks in configurable batches, eliminating the client-side freeze caused by single-tick packet bursts.
✔ Universal Compatibility — One jar runs on Bukkit, Spigot, Paper, Purpur, and Folia, from Minecraft 1.7.x all the way through 1.21+.
✔ Fully Configurable — Control the number of lines, batch size, batch interval, cleared message, "cleared by" message, blank line content, and silent-deny behavior.
✔ Console Support — Console can clear chat too; the announcement shows "Console" instead of a player name.
✔ Permission-Based — Only players with the permission (ops by default) can clear chat.
✔ Command Aliases — /clearchat, /cc, /clearc all work out of the box.
✔ No Dependencies — Pure Bukkit API. No Vault, no PlaceholderAPI, no Adventure, no third-party libraries.
✔ Clean Shutdown — All pending batch tasks are tracked and cleanly shut down on server stop/reload to prevent memory leaks.
✔ Java 8 Bytecode — Compiled to Java 8 class files so it runs on old server runtimes (1.7–1.12) and modern ones alike.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
COMMANDS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

/clearchat Clears the chat for all online players.
Aliases: /cc, /clearc

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PERMISSIONS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

omega.clearchat.use Allows the player to clear the chat. (Default: op)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙️ CONFIGURATION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

All settings live in config.yml and are editable without a restart (/reload or restart applies changes):

lines: 1000 # Blank lines to send (max 5000)
batch-size: 100 # Lines per batch (higher = faster, may spike)
batch-interval: 50 # Milliseconds between batches (50ms ≈ 1 tick)
cleared-message: "&a&lChat Cleared!"
cleared-by-message: "&7Cleared by &b&l%player%"
blank-line: "" # Empty for truly blank lines
silent-deny: false # Hide no-permission message when true

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
️ SERVER SOFTWARE SUPPORT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✔ Bukkit ✔ Spigot ✔ Paper ✔ Purpur ✔ Folia

(We have only tested this on Paper Server)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
VERSION SUPPORT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✔ 1.7.x ✔ 1.8.x ✔ 1.9.x ✔ 1.10.x ✔ 1.11.x ✔ 1.12.x
✔ 1.13.x ✔ 1.14.x ✔ 1.15.x ✔ 1.16.x ✔ 1.17.x ✔ 1.18.x
✔ 1.19.x ✔ 1.20.x ✔ 1.20.6 ✔ 1.21.x

(We have only tested this on 1.21.11)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
TECHNICAL DETAILS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Compiled against spigot-api 1.13.2 with Java 8 bytecode
• Uses only stable Bukkit API ( @SINCE 1.7) — no version-specific reflection for gameplay code
• Reflection-based getOnlinePlayers() handles the Player[] → Collection return type change between 1.8 and 1.9
• Thread-safe ScheduledExecutorService for batching — no Bukkit/Folia scheduler dependency, works identically on all 5 platforms
• Plugin size: under 20 KB — zero dependencies

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❓ FAQ
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Q: Why does it take ~0.5 seconds to clear instead of instantly?
A: That's intentional! Instant clearing dumps 1000+ chat packets in one tick, causing a lag spike. The small delay is the batched-sending system keeping things smooth. You can tune it via batch-size and batch-interval in the config.

Q: Can I increase the speed?
A: Yes — raise batch-size (e.g. 250) or lower batch-interval (e.g. 25). You can also reduce lines (e.g. 500) if you don't need to push as much old chat out of view.

Q: Does this work on Folia?
A: Yes. Player.sendMessage() just queues a network packet and is thread-safe, so the batched executor works identically on Folia without any platform-specific scheduler code.

Q: Do I need any other plugins?
A: No. OmegaClearChat has zero dependencies. Just drop the jar in your plugins folder and you're done.

Q: Can console clear the chat?
A: Yes — run /clearchat from the console. The announcement will say "Cleared by Console" automatically.