This repository has been archived by the owner on Oct 23, 2024. It is now read-only.
Permissions
Here you can view all the permission this plugin supports. We recommend using LuckPerms as a permission plugin, as it has proven stability over the many years of its course.
TIP: If you are an operator and would like to enable rules for yourself as well, give yourself bypass permission like so: "chatcontrol.bypass.rules" with value "false". Permissions set as "false" in the LuckPerms editor (in case you're using it) work for every other bypass as well.
TIP 2: We definitely not recommend being operator in a production server as it's most likely to run into different issues such as the previous one, not only with our plugins, but with many others that gives you any bypassing permission automatically if operator.
One of the best parts of ChatControl, is that you can view the required permission directly within the error message when you attempt to execute a command you don't have access to.
Permissions for the main plugin's command.
# The mute command with its sub-permissions
Perm: chatcontrol.command.mute
Info: Mute game chat with "/chc mute" command.
Perm: chatcontrol.command.mute.silent
Info: Mute without broadcasting any message with "/chc mute -silent" command.
Perm: chatcontrol.command.mute.anonymous
Info: Mute without broadcasting player who muted the chat with "/chc mute -anonymous" command.
# The clear command with its sub-permissions
Perm: chatcontrol.command.clear
Info: Clearing game chat with "/chc clear" command
Perm: chatcontrol.command.clear.silent
Info: Chat clear without broadcasting any message with "/chc clear -silent" command.
Perm: chatcontrol.command.clear.anonymous
Info: Chat clear without broadcasting player who cleared the chat with "/chc clear -anonymous" command.
Perm: chatcontrol.command.clear.console
Info: Clearing the console with "/chc clear -console" command.
# Regular permissions
Perm: chatcontrol.command.reload
Info: Reloading the configuration with "/chc reload" command.
Perm: chatcontrol.command.help
Info: Displaying help for the plugin with "/chc ?" command.
Perm: chatcontrol.command.fake
Info: Broadcasting fake join/kick/leave messages with "/chc fake" command.
Perm: chatcontrol.command.calc
Info: Use inbuilt calculator with "/chc calc" command.
Perm: chatcontrol.command.inspect
Info: Analyse methods or fields in a class with "/chc inspect" command.
Perm: chatcontrol.command.addrule
Info: Ability to create new rules with command.
Perm: chatcontrol.command.announce
Info: Announce messages with "/chc announce" command
Perm: chatcontrol.command.import
Info: Importing rules from a file using "/chc import" command.
Perm: chatcontrol.command.points
Info: View player's warning points with "/chc points" command.
Perm: chatcontrol.command.adminchat
Info: Writing to admin chat using "/chc ach" command.
Perm: chatcontrol.command.adminchat.read
Info: Reading from admin chat using "/chc ach" command.
Perm: chatcontrol.command.bungeechat
Info: Sending messages over bungee with "/chc global" command.
When you give someone this permission, and you use "/chc global switch",
each message they send to your chat will be forwarded to the bungee chat automatically,
meaning all players see it (regardless of ranged chat, party chat or other plugins' chat)
as well it will be forwarded to BungeeCord and to other servers as well.
Tip: To force bungee chat for everyone, set Bungee_Chat.Enabled_By_Default
to true in settings.yml and give players negative chatcontrol.command.bungeechat
permission. That way, they are automatically joined the bungee chat upon joining
and cannot leave.
Note: Players still need chatcontrol.notify.bungeechat permission
to see the messages (which is given by default).
Permissions for the channel commands.
Perm: chatcontrol.command.channels
Info: Basic permission required for "/channel" command.
Perm: chatcontrol.command.channels.list
Info: List all channels with "/channel list" command.
Perm: chatcontrol.command.channels.list.players
Info: List players in a channel with "/channel list" command.
Perm: chatcontrol.command.channels.list.players.spying
Info: List all players in a channel, including spying ones, with the "/channel list" command.
Perm: chatcontrol.command.channels.leave
Info: Leave a channel with "/channel leave" command.
Perm: chatcontrol.command.channels.join
Perm: chatcontrol.command.channels.join.others
Info: Join a channel with "/channel join" command (and also /channel join [player] to add other players).
Perm: chatcontrol.command.channels.spy
Info: See all messages in a channel with "/channel spy" command.
Perm: chatcontrol.command.channels.mute
Info: Mute a channel with "/channel mute" command.
Perm: chatcontrol.command.channels.send
Info: Send messages to a channel with "/channel send" command.
Perm: chatcontrol.command.channels.switch
Info: Quickly change channels with "/channel switch" command.
Perm: chatcontrol.command.channels.set
Info: Enforce a new channel to a player one with "/channel set" command.
Perm: chatcontrol.command.channels.help
Info: List all commands regarding channels with "/channel help" command.
Permissions for various ChatControl commands.
Perm: chatcontrol.command.tell
Info: Issue a private message with "/tell" command.
Perm: chatcontrol.command.reply
Info: Reply to last received private message with "/reply" command.
Perm: chatcontrol.command.spy
Info: View commands executed by other players with "/spy" command.
Perm: chatcontrol.command.tell.console
Info: Issue a private message with "/tell" or "/reply" command even if the player is console.
Perm: chatcontrol.command.tell.vanished
Info: Issue a private message with "/tell" or "/reply" command even if the player is vanished (hidden).
Perm: chatcontrol.command.ignore
Info: Do not see messages from other players in chat or in private messages with "/ignore" command.
Perm: chatcontrol.command.togglepm
Info: Allow or prevent others from sending you a private message with "/togglepm" command.
Perm: chatcontrol.command.togglepm.others
Info: Set for others whether or not they can receive a private message with "/togglepm <player>" command.
Perm: chatcontrol.command.togglebroadcast
Info: Allow or prevent automated broadcast messages being sent to you with "/togglebc" command.
Perm: chatcontrol.command.togglebroadcast.others
Info: Allow or prevent automated broadcast messages being sent to a player with "/togglebc" command.
Perm: chatcontrol.command.motd
Info: Read the message of the motd command.Permissions to bypass certain checks.
Perm: chatcontrol.bypass.ad
Info: Allow you to advertise IPs or domains in the game (this filter can be changed in rules.txt).
Important: This permission can be changed or removed to anything using handlers.yml
Perm: chatcontrol.bypass.swear
Info: Allow you to break the swear filters found in rules.txt.
Important: This permission can be changed or removed to anything using handlers.yml
Perm: chatcontrol.bypass.mute
Info: Allow player to chat while the chat is muted.
Perm: chatcontrol.bypass.time.commands
Info: Bypass command message delay.
Perm: chatcontrol.bypass.time.chat
Info: Bypass chat message delay.
Perm: chatcontrol.bypass.dupe.commands
Info: Allow a player to send duplicate/similar commands.
Perm: chatcontrol.bypass.dupe.chat
Info: Allow a player to send duplicate/similar messages.
Perm: chatcontrol.bypass.limit.chat
Info: Allow to bypass adaptive anti-spam (limiting amount of messages in a time-frame).
Perm: chatcontrol.bypass.limit.commands
Info: Allow to bypass adaptive anti-spam (limiting amount of commands in a time-frame).
Perm: chatcontrol.bypass.limit.parrot
Info: Bypass chat message parrot limit.
Perm: chatcontrol.bypass.move
Info: Allow player to chat even when they did not moved since joining the server.
Perm: chatcontrol.bypass.caps
Info: Bypass check for CAPS.
Perm: chatcontrol.bypass.rejoin
Info: Bypass rejoin check.
Perm: chatcontrol.bypass.tabcomplete
Info: Allow player to tab complete.
Notice: If you are using Spigot it is highly recommended to disable this feature and use the inbuilt one in spigot.yml
Perm: chatcontrol.bypass.clear
Info: Player's chat don't clears, they receive just one message instead.
Perm: chatcontrol.bypass.replace
Info: Player's messages will not be replaced from replace lists in chat.yml.
Perm: chatcontrol.bypass.capitalize
Info: Player's messages will not be capitalized.
Perm: chatcontrol.bypass.punctuate
Info: No dot will not be inserted after player's messages.
Notice: Permission changed in v5.0.0 from insertdot to punctuate.
Perm: chatcontrol.bypass.lowercasesecond"
Info: Player's messages will not be filtered for accidental misspellings in the second letter position.
Perm: chatcontrol.bypass.signduplication
Info: Allow player to make multiple signs with same text.
Perm: chatcontrol.bypass.rules.global
Info: Allow player to bypass all rules.
Perm: chatcontrol.bypass.rules.books
Info: Allow player to bypass rules from rules/books.txt file.
Perm: chatcontrol.bypass.rules.commands
Info: Allow player to bypass rules from rules/commands.txt file.
Perm: chatcontrol.bypass.rules.chat
Info: Allow player to bypass rules from rules/chat.txt file.
Perm: chatcontrol.bypass.rules.items
Info: Allow player to bypass anvil rules from rules/items.txt file.
Perm: chatcontrol.bypass.rules.packets
Info: Allow player to bypass rules from rules/packets.txt file.
Perm: chatcontrol.bypass.rules.signs
Info: Allow player to bypass rules from rules/sign.txt file.
NOTICE the name is "signs" while the file is "sign".
Perm: chatcontrol.bypass.spamkick
Info: Allow player to bypass vanilla's "disconnect.spam" kick when sending messages too quickly.
Perm: chatcontrol.bypass.nicknames
Info: Player will not be checked against disallowed nicknames defined in the antibot section in settings.yml.
Perm: chatcontrol.bypass.warnpoints
Info: Players will be ignored from receiving warning points and punishments from them.
Perm: chatcontrol.bypass.spy
Info: Players with this permission will not have their commands logged and exposed in the /spy command.
Perm: chatcontrol.bypass.channellimit
Info: Allow the player to be in unlimited amount of channels.
Perm: chatcontrol.bypass.togglepm
Info: Enforce sending a private message to the player that has PM's disabled.
Perm: chatcontrol.bypass.ignore
Info: Enforce sending a message to the player that is ignoring the sender.
Perm: chatcontrol.bypass.spy.books
Info: The player will not trigger spy alert when signing a book.
Perm: chatcontrol.bypass.spy.signs
Info: The player will not trigger spy alert when placing signs.
Perm: chatcontrol.bypass.newcomer
Info: Bypass the newcomer status even if you played on the server below the limit.
Permissions to get notified when something happens.
Perm: chatcontrol.notify.ad
Info: Receive a warning when a player advertises.
Important: This permission can be changed or removed to anything using handlers.yml
Perm: chatcontrol.notify.swear
Info: Receive a warning when a player swears.
Important: This permission can be changed or removed to anything using handlers.yml
Perm: chatcontrol.notify.signduplication
Info: Receive a warning when a player makes multiple signs with the same text.
Perm: chatcontrol.notify.update
Info: Receive a warning when a new version of plugin is available.
Perm: chatcontrol.notify.whenmentioned
Info: Receive a sound warning when somebody mentions you in the chat.
Perm: chatcontrol.notify.announcements
Info: Receive announcements issued by "/chc announce".
Notice: True for everyone by default.
Perm: chatcontrol.notify.bungeechat
Info: Receive messages sent by "/chc global"
Perm: chatcontrol.notify.outofrange
Info: Get notified when nobody sees your message in ranged chat because it's too far away.
Perm: chatcontrol.notify.me
Info: Receive /me messages. (true by default.)Permissions related to the chat, for example using colors.
Perm: chatcontrol.chat.write
Info: Send chat messages (true by default).
Perm: chatcontrol.chat.read
Info: Read chat messages (true by default).
Perm: chatcontrol.color.{color}
Info: After ChatControl 8.7.10+ we are simplifying how color permissions work and you now have to use this permission to use any type of text format ingame.
Simply replace {color} with values from here https://hub.spigotmc.org/javadocs/spigot/org/bukkit/ChatColor.html
All colors and all formats just like the ones that got removed are supported here instead.
Perm: chatcontrol.gui.color.{color}
Info: Permission node to use the /chc color menu and force the selected color to appear before the player's message.
Use the same structure and link from the previous description.
Perm: chatcontrol.chat.globalrange
Info: Permission to speak in global chat when chat range is enabled and message starts with '!'.
Perm: chatcontrol.chat.spyranged and chatcontrol.chat.spy
Info: Permission to receive everyone's messages when ranged mode is enabled.
Perm: chatcontrol.chat.overrideranged
Info: Permission speak for all players in the entire world when ranged mode is enabled.Permissions related to chat channels.
Note: In permissions, replace {channel} is the name of the channel.
You need to give players basic permission chatcontrol.command.channels to be able to use channel command.
Perm: chatcontrol.channel.{channel}
Info: Basic permission to be able to access the channel at all.
Perm: chatcontrol.channel.{channel}.join.{mode}
Info: Permission to join a channel with "/ch join" in a specific mode (write, read or spy, or * for all).
Perm: chatcontrol.channel.{channel}.leave
Info: Leave a channel with "/ch leave".
Perm: chatcontrol.channel.{channel}.send
Info: Send a message to a channel with "/ch send".
Perm: chatcontrol.channel.{channel}.mute
Info: Mute a specific channel with "/ch mute".
Perm: chatcontrol.channel.{channel}.spy
Info: See messages in a channel with "/ch spy".
Perm: chatcontrol.channel.{channel}.bypass.world
Info: Speak to all players in all worlds, bypass per-world chat.
Perm: chatcontrol.channel.{channel}.bypass.range
Info: Speak to all players in the world, bypass ranged chat.
Permission that allow players to be automatically put in a channel after they log in to the server.
Perm: chatcontrol.channel.autojoin.{channel}.{mode}
Info: Put the player into the specific channel, in a specific mode (write, read or spy).
Other permissions.
Perm 1: chatcontrol.messages.join
Perm 2: chatcontrol.messages.quit
Perm 3: chatcontrol.messages.kick
Perm 4: chatcontrol.messages.death
Info: Those four permissions control if the player can
view those type of messages. Given to everyone by default.
Give negative permissions (e.g. "-chatcontrol.messages.join")
to hide a type of message for a player.
Perm: chatcontrol.broadcaster.view
Info: Permission to view timed message from broadcaster.
Note: It is true by default, needs to be explicitly denied.
Perm: chatcontrol.spy.autoenable
Info: Automatically enable command spy on login.
Perm: chatcontrol.ignoreset.{setName}
Info: Ability to toggle ignoring the set with "/chc ignore <setName>" command.
Note: The {setName} in permission is replaced by the set name
specified in the command. Give 'chatcontrol.ignoreset.*' permission
to make all sets available to toggle for players.