Skip to content
This repository has been archived by the owner on Oct 23, 2024. It is now read-only.

Frequently Asked Questions

Matej Pacan edited this page Oct 6, 2020 · 39 revisions

Critical Issues

Plugin won't start or shows up red in /plugins!

Open a ticket and include a FULL STARTUP LOG from your server till it says 'Done!'. Upload that log to pastebin.com and send it to us.

I purchased the plugin but did not get the access to the download!

We are not responsible for the paygate between Spigot and PayPal, but if we receive your payment but you are not added to the buyers list, send an email to support@mineacademy.org with your transaction ID and we will fix that quickly.

Questions

What is Towny_Chat feature in formatting.yml?

You can read about this feature in the default comments, here they are if you don't have them: a

How to use HEX colors (Minecraft 1.16+)?

Simply use the following syntax: {#000000} anywhere as you would with &c color codes.

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:

Create a folder localization in your ChatControl/ folder. Restart the server. A new file with be created there with the default values. You can change the messages in that file.

How to edit "Goal Reached" for Toast notifications?

The Toast message starts with "Goal Reached" (https://i.imgur.com/EHORs3y.png). This is due to the nature of Minecraft. Toast notifications are not intended to be used for custom messages; they are there to show advancements and rewards. All you can customize is found in the Toast section in settings.yml (use CTRL+F).

How do I disable anti-spam / messages "Please wait/do not repeat similar command/message"?

It depends on which anti-spam feature you wish to disable. Most users by this mean

a) Preventing duplicate messages (aka "Please do not repeat same or similar message/command") -> Search for Similar_Percentage_Block in settings.yml and set to 0 to disable. NOTE: There are two keys, one is for messages, one is for commands.

b) Message delay (aka "You have to wait X seconds before your next message/command") -> Search for Message_Delay and Command_Delay in settings.yml respectively. Set to 0 to disable.

How can I turn off automatic channel join/spy for ops?

ChatControl automatically puts players into channels or makes them spy a channel (or all channels) depending on their permissions.

** 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, spy), or * to completely disable auto-joining.

You can use wildcat '*' to disable automatic join for all channels with -chatcontrol.autojoin.* permission, for example.

How to allow my server's domain or IP address in chat?

Read this short article in Rules section.

How to prevent spamming one character or limit it to 1 repeat maximum?

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:

a

Edit {3} to change how many characters to allow.

Problems and Solutions

ChatControl won't override /w or other aliases for private messages!

Add

aliases:
  w:
  - []

to commands.yml in server directory to fix this.

Ad filter doesn't work, all dots are removed! (Example: www.google.com becomes www google com)

This change is not coming from ChatControl. Essentials is known to do that, try adding your players essentials.chat.url and essentials.msg.url permissions

I get "Cannot define an operator when no rule is being created" after editing the files in rules/ folder

This is caused by wrong system encoding. Please see this article on how to fix it.

Players can speak when muted (e.g. using BanManager / LiteBans)

Please see this article on how to fix it.

Rules don't work for me (I have OP or admin permissions!)

If you have an operator status, you automatically have the bypass permission that includes all rules. That said, no rules will apply for you. You can give yourself a negative "-chatcontrol.bypass.rules.{ruleType}" permission to make them apply for you. Replace {ruleType} with the type of rules you want to have (e.g. chat, commands, packets,... see Permissions page for a full list).

Ignore_In_Commands does not work, rules still block WorldEdit or auth commands!

The section has been renamed to Ignore_Commands, update your handlers.yml manually.

Rules, channels or chat don't show or show when not supposed to (Towny/Factions/Plot Squared, ...)

Please see this article on how to fix it.

Rules remove colors from the chat message!

Set Regex_Strip_Colors in settings.yml to false. Beware, rules now won't be checked without colors, which makes it easier to bypass.

Rules don't work for my non-English server - I use Cyrillic / special characters but they are not matched.

Set Translate_Diacritical_Marks to false in settings.yml as well as set Anti_Spam.Similarity_Check.Ignore_Special_Characters to false in the same file.

Player count does not get down (using Multicraft)

Your issue might be that the console filter prevents certain message from appearing - and the plugin/server is reading them to detect the player count. Try disabling the console filter or removing all messages from it.

To disable console filter, set following in your settings.yml:

Console:
  Filter:
    Enabled: false

ChatControl's alias '/chc' is interfering with another plugin! (e.g ChestCommands)!

Remove chc from Command_Aliases in settings.yml so only aliases for ChatControl's menu that you wish will remain:

Command_Aliases: [chatcontrol, cc, anotheralias]

Private Messages like /tell causes lag!

If you have Toast notifications enabled (Private_Messages.Toast.Enabled in your settings.yml), note that this naturally causes some (minor) lag since the advancements must be written on a file and immediately deleted.

If this is your case, please turn off the feature first to see if the lag persists. Otherwise, contact us.

Toast Private Messages notifications spam the chat!

Disable the broadcasting of advancements via the command: /gamerule announceAdvancements false.

My emoticons :) are just showing as ? / Unicodes / Special characters not working

I want » in the formatting but it shows as ?

You must save the file in the right encoding, see https://github.com/kangarko/ChatControl-Pro/wiki/Use-Right-Encoding. You may want to regenerate your file in case the unicode letters have been corrupted by an earlier wrong file encoding.

For unicode, you can also use the escape characters \u2642.

Please also make sure to surround the message that contains these characters with quotes ("").

Tab Prevention does not work correctly!

Make sure you have tab-complete set to -1 in your spigot.yml file in the root server folder.

My configuration lost comments! Where do I find default files?

Configurations are updated automatically and due to how Bukkit handles it, we cannot save comments. You can easily open up your ChatControl.jar with Winrar or unzip it on Mac and view or copy all default files from there.

My Discord integration does not work / stopped working!

Set the "Debug" option in settings.yml file to "[discord]", restart your server completely 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.

Clone this wiki locally