LocalGlobalChat is a Paper (1.16.5+) plugin that adds both local and global chats with Component-based formatting.

Vault is supported, but is not required for the plugin to work. Needed if you want to display prefixes and suffixes.

👀 Screenshots

🌠 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

localChatRadius: 100
format: '<chatSymbol><localChatDistance> <prefix>&#CBD5E1<name><suffix> &8» &f<message>'

localChatSymbol: '&#F1DC4Fʟ'
globalChatSymbol: '&#A4D400ɢ'

localChatDistanceText: ' &#5E6268[<blocks>m away]'
# 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[&#A6D800+&#E2E8F0] &#E2E8F0' quitMessage: '&#CBD5E1[&#CC397B-&#E2E8F0] &#E2E8F0'

Custom format for '/msg', '/w', '/tell'

privateMessageOutgoingFormat: '&8[&#CBD5E1You &8» &#CBD5E1&8] &f' privateMessageIncomingFormat: '&8[&#CBD5E1 &8» &#CBD5E1You&8] &f'

messages: "prefix": "&#C8D1DE[LocalGlobalChat]" "default-chat-set-to-local": " &#ECF4FBNow your default chat is &#F1DC4F&nlocal&#ECF4FB." "default-chat-set-to-global": " &#ECF4FBNow your default chat is &#A4D400&nglobal&#ECF4FB." "only-players": " &#CC1020Only players can use this command!" "nobody-heard-you": "&#C8D1DENobody heard you." "reloaded": " &#7BB661Reloaded successfully!" "error-during-reload": " &#CC1020An error occurred during reload!" "usage-guide": " &#ECF4FBUsage: &n/chat local | global&#ECF4FB." "usage-guide-msg": " &#ECF4FBUsage: &n/msg &#ECF4FB." "player-not-found": " &#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

**[IMPORTANT]** 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 Releases tab.
1. Put the downloaded `.jar` into the `/plugins` directory of your server.
1. Restart your server or enter the `/reload` command.