Local Global Chat

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<name>'
quitMessage: '&#CBD5E1[&#CC397B-&#E2E8F0] &#E2E8F0<name>'

# Custom format for '/msg', '/w', '/tell'
privateMessageOutgoingFormat: '&8[&#CBD5E1You &8» &#CBD5E1<name>&8] &f<message>'
privateMessageIncomingFormat: '&8[&#CBD5E1<name> &8» &#CBD5E1You&8] &f<message>'

messages:
  "prefix": "&#C8D1DE[LocalGlobalChat]"
  "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

[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.
2. Put the downloaded .jar into the /plugins directory of your server.
3. Restart your server or enter the /reload command.