[![chatmanager](https://raw.githubusercontent.com/RyderBelserion/Assets/main/crazycrew/webp/ChatManagerWebsite.webp)](https://github.com/Crazy-Crew/ChatManager) [![Contributors][contributors-shield]][contributors-url] [![Forks][forks-shield]][forks-url] [![Stargazers][stars-shield]][stars-url] [![Issues][issues-shield]][issues-url] [![MIT License][license-shield]][license-url] ![Paper](https://cdn.jsdelivr.net/gh/intergrav/devins-badges/assets/compact/supported/paper_vector.svg) ![Purpur](https://cdn.jsdelivr.net/gh/intergrav/devins-badges/assets/compact/supported/purpur_vector.svg)

An advanced chat management plugin.
Explore the docs »

Report Bug · Request Feature · Get Support

[![Join us on Discord](https://discord.com/api/guilds/182615261403283459/widget.png?style=banner2)](https://discord.gg/badbones-s-live-chat-182615261403283459)

## Roadmap A working plugin, We fix any issues that come along. ## Features

Anti-Advertising

* Block players from advertising other servers in chat, commands, and on signs.
* Staff gets notified when someone advertises.
* A command can be executed on the player that advertises.
* Whitelist URLs so those URLs wont be blocked when players use them in chat, commands, or on signs.
* Increase sensitivity option to increase the sensitivity of the anti-advertising checker, can cause false positives.

Anti-Bot Attack

* Block chat and commands until player moves on join.

Anti-Caps

* Prevent players from using caps in chat or in commands.
* Customize minimum message length.
* Cap percentage.
* Sets the players message to lowercase.

Anti-Spam

* Blocks players from repeating the same chat message and the same commands.
* Delay between sending messages meaning you have to wait X seconds before sending another message.
* Delay between sending commands meaning you have to wait X seconds before sending another command.

Anti-Swear

* Block swear words in chat, commands, and on signs.
* Blocks words together (Example: YouAreAPieceOfCrap).
* Blocks spaces between words (Example: C r a p).
* Increase sensitivity option to increase the sensitivity of the anti-swear checker, can cause false positives.
* Add and remove swear words in game!
* Staff gets notified when a player swears.
* A command can be executed on the player that swears.
* Add as many commands as you like.
* Whitelist commands, so players can swear in those commands without the message being blocked.
* Whitelist words that won't be detected by the anti-swear if increase sensitivity is enabled.
* Option to block the message from being sent to chat.

Anti-Unicode

* Prevents players from typing special characters in chat. (Example: Ω≈ç√∫˜µ≤≥)
* Prevents players from typing fancy chat messages from hack clients.
* This prevents players from bypassing the Anti-Advertising checker and Anti-Swear checker.
* Staff gets notified when someone uses special characters in chat.
* A command can be executed to the player that uses special characters in chat.
* A Unicode whitelist so players can send those messages in chat and their message wont be blocked.

Auto-Broadcast

* Edit auto broadcast messages in the AutoBroadcast.yml file.
* The auto-broadcast feature can send messages globally.
* The auto-broadcast feature can send messages per-world.
* The auto-broadcast feature can send messages via action bar.
* The auto-broadcast feature can send messages via title.
* The auto-broadcast feature can send messages via boss bar.
* Each option has it's own section so you can...

Enable or disable each section.
Set a custom prefix for each section.
Set a custom interval for each section.
Enable or disable the header footer for global and per world messages.
Set a custom header and footer for global and per world messages.

* You can add broadcast messages in-game.
* You can view a list of all the broadcast messages in-game.
* You can create a new auto broadcast world in-game.
* Sounds can be played when messages are sent.
* Set boss bar messages to be permanent by adding the bar delay to -1.

Banned Commands

* Deny players from using specific commands.
* Add and remove commands in game.
* Staff gets notified when a player uses a banned command.
* A command can be executed on the player that uses a banned command.

Broadcast Commands

* /Broadcast {message} command

Custom default prefix Custom default chat color A sound is played to everyone on the server when you broadcast a message.

* /Annoucement {message} command

Broadcast an announcement message to the server. Custom Header/ Footer A sound is played to everyone on the server when you announce a message.

* /Warning {message} command

Broadcast a warning message to the server. Custom Header/ Footer A sound is played to everyone on the server when you send out a warning message.

Banned Commands

* Per-group chat format.
* Players will automatically be placed in their chat format group, depending on what permission group they are in.
* Players will be place in the default format section if their permissions group isn't in the config.
* Learn more on how to use the chat format here
* Available Placeholders

Chat Color

* You can send color codes in chat. * Permission to use the color codes and formats.
* Hex color codes supported for almost every message.

Banned Commands

* Chat Radius chat channels.
* Local chat, Global chat, and World chat.
* In local chat players can only talk to other players that are in the customizable range.
* In global chat players can send messages to everyone on the server.
* In world chat players can only send messages to players that are in the same world as them.
* Add the placeholder {radius} or %chatmanager_radius% (PAPI placeholder) to the chat format to show what chat channel the players are in.
* Spy mode can be used to see what everyone is saying in chat no matter what.
* You can set it so spy mode enables when specific players join the server.
* You can set which chat channel players join when they join the server.
* The command to switch chat channels is /chatradius.
* Players can use a customizable symbol to talk to players in local chat.
* Players can use a customizable symbol to talk to players in global chat.
* Players can use a customizable symbol to talk to players in world chat.
* Learn more on how to use the chat radius here

Clear Chat

* Clears all online players chat with a custom broadcast message.
* Bypass permission so players wont have their chat cleared on command.

Command Spy

* You can see what commands everyone is sending on the server.
* Custom command spy format.
* Bypass permission so staff can't see what commands you type.

Custom Messages

* Custom Join, Quit, and First Join messages.
* Custom join and first join action bar messages.
* Custom join and first join titles.
* Per group Join and Quit messages.
* Play sound when players join or leave the server.
* Customizable title delays.
* Custom Message of the Day (MOTD).

Grammar

* Capitalize the first letter in a sentence.
* Adds a period at the end of a sentence.
* Auto corrects "i" to make it capital, as well as other preset words.
* Minimum message length for capitalization and punctuation.

Lists

* Player list to show all the players that are currently online.
* Staff list to show all the staff members that are currently online.

Logs

* Logs everything typed in chat.
* Logs every command executed.
* Logs every message that is written on a sign.
* Logs when a player advertises.
* Logs when a player curses.
* Add commands in the config that wont be logged.

Mentions

* When a player is mentioned in chat, they will receive a sound notification as well as a title message.
* Players can be mentioned by a customizable symbol that can be changed in the config.yml. (Default is @{player})
* You can mention everyone on the server by doing @everyone.

Mute Chat

* Prevent players from talking in chat.
* Prevents specific commands from being executed when chat is disabled.
* Bypass permission so staff can talk in chat.
* MuteChat -s command so staff can only see when chat is muted.

Per-World Chat

* If enabled (Disabled by default) players can only talk to other players that are in the same world as them.
* Group worlds for per world chat. You can group worlds together so players in the grouped worlds can talk to each other.
* Bypass command: /Perworldchat Bypass (/pwc bypass)

When the command is executed, everyone can see what you type in chat, and you can see what everyone else types in chat.

Ping Command

* You can check your current ping anytime on the server.
* You can check other players ping anytime on the server.
* This is the one and only thing that cant be customized.

Placeholders

* Chat Manager has multiple placeholders built into the plugin by default that you can use in almost every message chat manager has to offer, you can view a full list of all the available placeholders here
* Chat Manager also supports the use of PlaceholderAPI placeholders in almost every message chat manager has to offer! Please visit PlaceholderAPI Wiki to help you get started to learn how to get placeholders from the plugin!

Private Message

* /message and /reply commands.
* Custom message format.
* A sound is played to the person that receives a private message.
* Players cant private message staff if they are vanished (Works with Essentials Vanish and Super Vanish).
* When a player is ignored they wont be able to send private messages to the player that's ignoring them (only works with essentials ignore).
* Hover text for private messages and suggest command.

Server Rules

* /Rule Command
* Rule pages. You can add as many pages as you'd like in the config.

Sign Colors

* You can use color codes on signs.
* Permission to allow players to either use color codes or format codes.

Social Spy

* You can spy on players private messages.
* Bypass permission to players cant spy on you.

Staff Chat

* Talk to all online staff members secretly from the rest of the server. * Custom staff chat format.
* Boss bar can be permanently enabled while staff chat is enabled.

More Info

* Almost everything can be enabled or disabled in the config.yml. Everything besides commands.
* Almost every message can be customized in the messages.yml.
* There is a bypass permission for almost everything.
* Thousands of Placeholders are available with PlaceholderAPI installed.

## FAQ

Why isn't chat manager working?

There can be a number of causes for this issue but notably the most common issue if that players don't have vault on their server. Vault as well as a permissions plugin is required to use chat manager, there's a list of dependencies right above the FAQ. If chat manager isn't working still please go in console and restart the server and look at the start up messages, this will tell you if something is wrong. If there are error messages please try and read them yourself to resolve the issue to join the discord server and request for help.

Why isn't the chat format working?

The chat format may not work for multiple reasons. You can learn how to use the chat format properly on my wiki, but if you did that and it still isn't working first, make sure you have both Vault and a Permissions Plugin on your server (I.E. PermissionsEx, LuckPerms, etc). The chat format is case sensitive, so the group name has to be spelt exactly how its spelt with your permissions plugin. If you're using LuckPerms groups are automatically set to lowercase, so in chat managers config make sure all your groups are lowercase if you are using LuckPerms. Also another thing with LuckPerms, if you set a display name for a group, that groups set name wont work with chat managers chat format, you'll have to set the group name in the chat format to the set display name for the chat format to work. If you are still having issues after checking all this please join the discord server and request for help.

Can I disable commands?

The short answer is no, but there are ways around it. This a highly asked question, but you can't disable any of the commands, but there is a way to give commands from other plugins higher priority so they can be used instead of chat managers commands. The commands.yml file. Read that wiki page on how to use it and it should help you out. Also, if you want a command from essentials to override a command from chat manager, go to essentials config.yml, go to overriden-commands, and set the command you want essentials to take over.

Gradle (Kotlin)

``` repositories { maven("https://repo.crazycrew.us/releases") } ``` ``` dependencies { compileOnly("me.h1dd3nxn1nja.chatmanager:chatmanager:4.0.2") } ```

## Information

Commands

[https://docs.crazycrew.us/chatmanager/info/commands/permissions](https://docs.crazycrew.us/chatmanager/info/commands/permissions)

Dependencies

[https://docs.crazycrew.us/chatmanager/info/plugin-support](https://docs.crazycrew.us/chatmanager/info/plugin-support)

Permissions

[https://docs.crazycrew.us/chatmanager/info/commands/permissions](https://docs.crazycrew.us/chatmanager/info/commands/permissions)

ChatManager

External resources

Project members

Technical information