Local Global Chat

**LocalGlobalChat** is a **Paper (1.16.5+)** plugin that adds both local and global chats with Component-based formatting. **(https://dev.bukkit.org/projects/vault)** is supported, but is **not required** for the plugin to work. Needed if you want to display prefixes and suffixes.<br> ### 👀 Screenshots <img width="480" src="https://github.com/user-attachments/assets/4ecfe432-d4d0-468f-9059-e5e33407f453" /><br> <img width="480" src="https://github.com/user-attachments/assets/c1271e76-1ac2-4338-ad90-8d00041bb06c" /><br> <img width="480" src="https://github.com/user-attachments/assets/de8b8454-c4a3-438c-8273-60a0181243e5" /><br> <img width="480" src="https://github.com/user-attachments/assets/7b4db928-38e4-4c8d-a9ce-c1be7fc377fc" /><br> <img width="480" src="https://github.com/user-attachments/assets/e1647489-533b-477d-b743-b026361b535a" /><br> <img width="480" src="https://github.com/user-attachments/assets/983316b4-d039-4864-82c2-78d951dc4e4a" /> ### 🌠 Key features - Set the max distance that other players will be able to see your messages from. - Select between seeing distance as a hover effect or as an embedded text. - Fully customizable chat format with RGB (hex) color support. - Two chat modes: local and global. - Quick switching between chat modes using commands or prefix. - Vault integration for displaying player prefixes and suffixes. - Action bar notifications when nobody hears your local message. - Per-player default chat mode settings. - Private messages (`/msg`, `/tell`, `/w`). - Custom join/quit messages. ### 📄 Default config ```yml localChatRadius: 100 format: '<chatSymbol><localChatDistance> <prefix>&#CBD5E1<name><suffix> &8» &f<message>' localChatSymbol: '&#F1DC4Fʟ' globalChatSymbol: '&#A4D400ɢ' localChatDistanceText: ' &#5E6268' # Whether the distance should be displayed as a hover effect for local chat symbol localChatDistanceAsHover: false localChatDistanceHoverText: "&7<blocks>m away" # If a message starts with this symbol, the message will be sent to the global chat globalChatPrefix: '!' # If 'true', the global chat prefix (e.g., "!") will always be removed from the final message shown in chat, # even if the user set its default chat to global (e.g., "!hello" becomes "hello") hideGlobalPrefixInOutputAnyway: false # Whether the "Nobody heard you" label will be shown in the action bar when player's message wasn't seen by anyone showNobodyHeardYou: true # Custom join/quit messages joinMessage: '&#CBD5E1 &#E2E8F0<name>' quitMessage: '&#CBD5E1 &#E2E8F0<name>' # Custom format for '/msg', '/w', '/tell' privateMessageOutgoingFormat: '&8 &f<message>' privateMessageIncomingFormat: '&8 &f<message>' messages: "prefix": "&#C8D1DE" "default-chat-set-to-local": "<prefix> &#ECF4FBNow your default chat is &#F1DC4F&nlocal&#ECF4FB." "default-chat-set-to-global": "<prefix> &#ECF4FBNow your default chat is &#A4D400&nglobal&#ECF4FB." "only-players": "<prefix> &#CC1020Only players can use this command!" "nobody-heard-you": "&#C8D1DENobody heard you." "reloaded": "<prefix> &#7BB661Reloaded successfully!" "error-during-reload": "<prefix> &#CC1020An error occurred during reload!" "usage-guide": "<prefix> &#ECF4FBUsage: &n/chat local | global&#ECF4FB." "usage-guide-msg": "<prefix> &#ECF4FBUsage: &n/msg <player> <message>&#ECF4FB." "player-not-found": "<prefix> &#CC1020Player not found!" ``` ### 💻 Commands - `/chat reload` — reload the plugin. - `/chat local` — set the local chat by default. - `/chat local <message>` — set the local chat by default and send a message. - `/chat global` — set the global chat by default. - `/chat global <message>` — set the global chat by default and send a message. - `/msg <player> <message>` — send a private message. Aliases: `/lgc`, `/localglobalchat`, `/local`, `/global`, `/w`, `/tell`. ### 🔞 Permissions - `localglobalchat.use` _(**true** by default)_ — Allows to use the plugin. - `localglobalchat.admin` _(for **operators** by default)_ — Allows to use `/chat reload`. ### 🚀 Installation guide **** Before getting started, make sure that the plugin's version is **compatible** with your server version. 1. Download the latest version of the plugin from the <a href="https://github.com/MrQuackDuck/LocalGlobalChat/releases">Releases</a> tab. 1. Put the downloaded `.jar` into the `/plugins` directory of your server. 1. Restart your server or enter the `/reload` command.