Skip to content

Compatibility

Matej edited this page Dec 6, 2024 · 52 revisions

Incompatibilities

  • Due to how Bukkit handles chat event, our channel formatting might be incompatible with plugins like InteractiveChat, DeluxeChat or other chat plugins. Use our system or theirs, not both. You can keep using ChatControl without channel formatter just fine.
  • CMI: Open chat.yml, set both ModifyChatFormat and ClickHoverMessages to false to prevent duplicated messages when using channels.
  • Fixing most issues can be done by adjusting your Listener Priorities.

Java

Java 8 or greater.

Database (Optional)

MySQL or MariaDB with "utf8mb4" charset (use utf8mb4_unicode_520_ci) otherwise it can not work with non-English letters such as emoji.

Supported Plugins

Proxy (BungeeCord/Waterfall, Velocity, Redis etc.)

Server Mod

Server Distribution Compatibility
Paper Officially tested and supported.
Folia Officially supported with limitations due to missing APIs. ProtocolLib required.
Spigot, Purpur, PandaSpigot, JesusSpigot, and other bro-Spigot forks Supported on a best-effort basis. We recommend you stick with Paper.
Craftbukkit Supported for Minecraft <1.16. For newer versions, use Paper.
Thermos/Cauldron 1.7.10 Support with limitations due to missing APIs.

Minecraft Version

You can run ChatControl on the following Minecraft versions below. Please note that the x stands for any sub-version, for example, 1.21 or 1.21.1.

Many issues are often caused by incompatible other plugins such as ProtocolLib and not by your Minecraft version. Make sure all dependencies are up-to-date. We reserve the right to close tickets with startup log with errors from other plugins since they might interfere.

Minecraft Version Compatibility
1.21.x Native.
1.20.x Native.
1.19.x Native.
1.18.x Native.
1.17.x Native.
1.16.x Native.
1.15.x Native.
1.14.x Native.
1.13.x Native.
1.12.x Native.
1.11.x Native.
1.10.x Native.
1.9.x Native. Rules for books don't work here and below due to missing API.
1.8.x Native.
1.7.10 and older Unsupported as of ChatControl 11.
Clone this wiki locally