Common Issues
Read this to save hours waiting for our reply and fix common issues yourself quickly.
- No support for PlugMan or /reload. Always restart if having issues.
- If using proxy: Use the SAME ChatControl version on all servers. Use the SAME Server_Name as in velocity.toml (case sensitive) or bungee's config.yml.
- If using remote database: Your db MUST support the "utf8mb4" charset (use utf8mb4_unicode_520_ci). See this StackOverflow issue for solutions.
- Use a compatible text editor when editing yml files.
- BungeeCord: Using
<lang>,<font>and<selector>will disconnect modern clients. This was reported when the backend server was 1.8.8 running ViaVersion. - Minecraft 1.8.8: Confirmed to work with MariaDB but breaks with MySQL 8.0. Minecraft 1.17 and higher works with MySQL 8.0.
Set enforce-secure-profile to false in server.properties while the server is stopped.
We send all messages as "system chat" so they cannot be reported to protect you privacy, sanity and freedom.
The "This message is not secure" is Microsoft's way of misinformation to get as many people as possible to enable their anti-feature and you can ignore it safely. There's no way a message can be edited (unless by our rules) if it is sent out through ChatControl.
Use MiniMessage syntax: <#123456>. Legacy colors like &c are still supported. Click here for a color generator.
NB: In chat, since ChatControl 11, you must use the MiniMessage <#132456> syntax regardless of options in Performance.
Write {player_chat_color} and {player_chat_decoration} to format used in the channel you are writing to in formats/ folder before the {message} to apply chat colours to the message. Example:
message:
Message: "&7:&r{player_chat_color}{player_chat_decoration}{message}"
Disable the broadcasting of advancements via the command: /gamerule announceAdvancements false.
Restart the server, some messages cannot be changed unless you do a clean start.
To disable automatically joining a channel, give yourself or your group negative chatcontrol.autojoin.{channel}.{mode} permission. Replace {channel} with your channel name. Replace {mode} with the mode you wish to disable (write, read), or use chatcontrol.autojoin.* to completely disable auto-joining.
See this on how to fix it.
- Use a compatible text editor when editing yml files.
- Put brackets "" around the message containing emojis if it's in a yml file.
If your system's language is using a different char set such as Chinese, Russian, Greek, Turkish, etc., then it may not work, you can try googling on how to enable unicode on your operating system. We unfortunately can't help since we have no idea.
The <center> prefix doesn't exactly centers chat when colors/Russian/Greek etc. special characters are used!
Unfortunately this is the case of the free library extension we are using, anyone is encouraged to make a pull request to fix that: https://github.com/kangarko/Foundation/blob/master/src/main/java/org/mineacademy/fo/ChatUtil.java
If you don't have any server resourcepack, make sure Delay_Until_Resource_Pack_Loaded is set to false, otherwise the plugin will try to listen for the PlayerResourcePackStatusEvent event to fire before sending these messages.
Spoiler Alert: it will never fire without a server resourcepack or without a plugin that handles resourcepacks, such as ItemsAdder or Force Resourcepacks.
You need to adjust your Javascript in variables/item.yml slightly, here is an example:
Value: |-
displayName();
function displayName() {
var item = player.getItemInHand();
var itemMaterial = item.getType().toString();
if (item == null || itemMaterial.equals("AIR") || itemMaterial.contains("_AIR"))
throw "event handled: You must be holding an item to use [item]!";
var metadata = item.getItemMeta();
if (metadata != null && metadata.hasDisplayName())
return "\&8[&d" + metadata.getDisplayName() + "\&8]";
var wordUtils = Java.type("org.apache.commons.lang.WordUtils");
var name = item.getType().name().toLowerCase().replace('_', ' ').replace('_', ' ');
return "\&8[&d" + wordUtils.capitalize(name) + "\&8]";
}Set the "Debug" option in settings.yml file to "[discord]", restart your server completely (do not reload and do not use PlugMan) and notice the console message when that happens. It will give you instructions on how to fix that, or you can open a ticket and paste the messages there.
When you send a message, by default we have to unsend it and send it again through our own system. This makes filtering functional but poses some limitations. You can turn this off in Discord section of settings.yml.
How to edit messages 'You have to wait X seconds before another message' or 'Please do not post the same or similar messages' or announcement format:
Edit these messages in localization/messages_en.yml. See Localization for more information.
Open rules/global.rs, find "ignore string minecraft:|youtube.com|imgur.com" line and simply put "|yourdomain.com" at the end of it. You can separate multiple domains to ignore with "|".
My URL / domains are broken / not clickable / Ad filter doesn't work, all dots are removed! (Example: www.google.com becomes www google com)
- If you have Essentials, try adding your players
essentials.chat.urlandessentials.msg.urlpermissions - Make sure you don't use "Suggest_Command" in your format part as this is known to break links.
- Since ChatControl 11, you need to use MiniMessage syntax to make links clickable in rules or formats such as
<click:open_url:'https://google.com'>https://google.com</click>. Use https://webui.advntr.dev/ for help. - For chat, turn Make_Chat_Links_Clickable option in settings.yml to true to make links clickable automatically.
Please see this article on how to fix it.
Rules don't work for my non-English server - I use Cyrillic / special characters but they are not matched.
Set Rules.Strip_Accents to false in settings.yml.
There is a default rule for that hidden in rules/chat.txt, remove # from the two lines after the first line and you be good to go. Edit {3} to change how many characters to allow.
Make sure you have tab-complete set to -1 in your spigot.yml file in the root server folder.
Give yourself "chatcontrol.bypass.spamkick" permission.
Set Channels.Prevent_Spying to false, unfortunately some setups and plugins cause issues here. If you have ViaVersion or other protocol-hack plugins, set ProtocolLib.Enabled to false. Also try disabling console filter by setting Console_Filter.Enabled to false.
See our guide on how to fix conflicting commands.
Remove chc from Command_Aliases in settings.yml. You can write your own command to invoke /chc there instead.
Command_Aliases: [chatcontrol, chc, anotheralias]If you only want subtitle, send "/chc announce title |my subtitle message" (see the | before the message).
If you have Toast notifications enabled (Private_Messages.Toasts in your settings.yml), note that this naturally causes some lag since the advancements must be written on a file and immediately deleted. You can also disable the Spy and the Log features being applied to private messages by removing "private_message" from Apply_On sections in settings.yml for these features.
Give yourself chatcontrol.bypass.reach permission to bypass these limits.
- Remove the "t" alias from Private_Messages.Tell_Aliases in settings.yml
- Place the following command alias in commands.yml in your root server folder:
Add
aliases:
w:
- []
to commands.yml in server directory to fix this.
Join/switch/quit messages from proxy (bungeecord/waterfall/velocity) don't always show if in vanish?
If you are using a plugin such as PremiumVanish, you can force vanished users to have their messages shown if they have the permission chatcontrol.bypass.reach
If you have SpectatorOnLogin in your CMI plugin, set this to false, since CMI will tell us the player is vanished and we won't show the message otherwise.
IMPORTANT NOTE
The permission chatcontrol.bypass.reach also gives people the ability to talk to people who ignored them etc if this permission node is also assigned to the Spigot server. Permission checks to bypass players' ignored list, are done on the spigot server, and the permission check to make sure these messages (join/switch/quit) is sent, are done on the proxy server, so to ensure you do not give regular players the permission to bypass such features, you need to make sure to only assign it to the proxy.
To assign a permission node just on proxy (bungeecord/waterfall/velocity) when using a permissions plugin like LuckPerms, this is the command you need to use (assuming you have LuckPerms on all of your servers linked to a database like MySQL or a similar setup).
/luckpermsbungee group <group_name> permission set chatcontrol.bypass.range true server:<server_name>
<group_name> = group/rank name
<server_name> = Server name as stated in your LuckPerms config on proxy.
If you want to check the permissions, you can run these commands if using LuckPerms. Remembering, you want the permission to be "true" on proxy, but "false" OR "undefined" on your spigot servers, unless you are happy for that specific group to be able to talk to people who have them ignored, etc.
For proxy /luckpermsbungee group <group_name> permission check chatcontrol.bypass.range
For Bukkit /luckperms group <group_name> permission check chatcontrol.bypass.range
If you use PlaceholderAPI with the server expansion, it will override ChatControl's placeholder since it uses the same placeholder. Change the server name in the PlaceholderAPI's config file instead.