Compatibility

Danger

Please read the General Compatibility Guide first.

Troubleshooting

Most compatibility issues can be resolved by adjusting your Listener Priorities.

Proxy

ChatControl works with BungeeControl and Velocity, see Proxy page.

Redis

Redis Integration

Proxy addons include Redis support for chat and data synchronization (e.g., /list command). Support for additional features is limited, but contributions are welcome as the project is now open source.

Folia

Experimental Support

ChatControl has experimental Folia support. Known limitations:

• PacketEvents features depend on PacketEvents' own Folia support
• Some timed broadcasts may not fire as expected
• MySQL is recommended over SQLite on Folia

Report Folia-specific issues on GitHub with [Folia] in the title.

🌐 BungeeCord/Velocity Plugins

🎮 Parties Party Chat

Support ChatControl nicks in proxy party chat, and party chat channels on Bukkit. See Channels.

👥 Parties and friends Party Chat

Support ChatControl nicks in proxy party chat, and party chat channels on Bukkit. See Channels.

🧩 Bukkit Plugins

⚙️ Core Integrations

PacketEvents Required for some features

Replaces ProtocolLib in v12+. Drop the jar into plugins/ to enable the [X] remove button, tab features and other packet integrations. If you only used ProtocolLib for ChatControl, you can uninstall it.

Vault Required for more compatibility

Essential plugin to get players' data such as ranks, groups, prefixes, suffixes and permissions.

💬 Chat

InteractiveChat Changes Required

To prevent conflicts with ChatControl, open their config.yml and remove "#([0-9a-fA-F])([0-9a-fA-F])([0-9a-fA-F])([0-9a-fA-F])([0-9a-fA-F])([0-9a-fA-F])" from the Settings.FormattingTags.AdditionalRGBFormats list (or set the key to [] to empty the list).

🔐 Authentication

AuthMe Compatible

We support AuthMe by hiding the quit message if player is not logged in.

🚫 Moderation

AdvancedBan, BanManager, CMI, EssentialsX, LiteBans Compatible

Mutes are honored natively when the mute plugin runs on the same backend server: muted players cannot chat, use the commands listed in Mute.Prevent_Commands, place signs, write books or rename items on anvils, and their join/quit/death messages are hidden. The chatcontrol.bypass.mute permission does not exempt players from third-party mutes. Proxy-only installs are not detected, install the mute plugin on each backend server sharing one database instead, or adjust your Listener Priority.

�️ Voice Chat

ChatControl bridges its mute state into both supported voice chat plugins so a single /mute silences a player on chat and voice. Mutes from AdvancedBan, BanManager, CMI, EssentialsX and LiteBans running on the same server silence voice too. Bypass works the same as for chat (chatcontrol.bypass.mute) and does not apply to third-party mutes.

Enable it in settings.yml:

Voice_Chat:
  Enabled: true
  # Also mute voice when the channel a player writes to is muted.
  Mute_On_Channel_Mute: true

When Enabled: true, ChatControl auto-detects whichever of the two plugins is installed - install both, one, or neither.

Simple Voice Chat Auto

While a player is muted by ChatControl or a third-party mute plugin, their microphone packets are dropped server-side. Mute expires automatically with the timer - no extra config required.

Plasmo Voice Auto

ChatControl drives Plasmo's MuteManager so Plasmo's UI shows the muted microphone icon and the remaining duration - for its own server, channel and per-player mutes as well as third-party mutes, which appear and lift within a second. Speech is additionally dropped server-side, so the audio block applies instantly. Mutes placed with Plasmo's own /vmute are never touched.

�🏠 Land Management

BentoBox Party Chat

Supports Party chat, see "Party" option in Channels.

Factions, FactionsX or FactionsUUID Party Chat

Support for party chat, see Channels.

Lands Party Chat

Support for party chat, see Channels.

PlotSquared Party Chat

Support for party chat, see Channels.

Towny and TownyChat Party & Spy

Spying on towny chat and support for party chat, see Channels.

🎉 Party Plugins

Parties (AlessioDP) Party Chat

Support for party chat, see Channels.

Party and Friends (PAF) Party Chat

Support for party chat, see Channels. Requires both FriendsAPIForPartyAndFriends and Spigot-Party-API-PAF installed.

🎮 Gameplay

Boss and MythicMobs Death Messages

You can print customized death messages, see Messages at the bottom, if player was killed by a Boss.

mcMMO Compatible

Spying for party chat and support for party chat, see Channels.

Party Chat Support

ChatControl's channels system can create a channel for mcMMO party members. If mcMMO party chat is used, messages are shown to spying ChatControl players.

📊 Server Management

CMI Changes Required

Support for afk, vanish status, and a few other features. Custom AFK reasons set with "/afk reason" are shown when messaging an AFK player, also across proxy networks.

To prevent conflicts with ChatControl, open their chat.yml, set both ModifyChatFormat and ClickHoverMessages to false to prevent duplicated messages when using channels.

Essentials Compatible

Support for afk, vanish status, and a few other features. Custom AFK reasons set with "/afk reason" are shown when messaging an AFK player, also across proxy networks.

Multiverse-Core World Names

We use world name aliases from Multiverse-Core in the {world} variable.

🔄 Integrations

DiscordSRV Full Integration

Connect your channels with Discord and send any message to any Discord channel.

ItemsAdder Font Images

Use the :name: font images in chat, formats and format hovers.

Nexo Font Images

Auto-detected. Use Nexo :name: font images in chat, formats and format hovers, just like ItemsAdder.

PlaceholderAPI Full Integration

Full support for all placeholders, see Variables.

🔄 Additional Support

Vault Integration

That's not it! We support a lot more plugins than that, thanks to Vault, you can see what Vault supports here: Vault on Bukkit Dev