How do I install Better Local Chat?

Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. Download the .jar. Put it in the .minecraft/mods folder and launch that loader profile. Opens on Spigot — not every file is mirrored on our own servers.

What Minecraft version does Better Local Chat work with?

The listing gives Minecraft 1.20, 1.20.6. This is the version stated by the author or source site, not something we verified ourselves.

Home›Java›Mods›Better Local Chat

ModsJava

Better Local Chat

⬇ Download on Spigot

Open in MC Java Mods Get it on Google Play →

This plugin was made for my minecraft server so feel free to report any bugs you find and I will try to fix them.

I have solved all the obvious bugs I found so far.

Feel free to rate it but if there is any complain please talk with me first on discussion.

Features:

For players:

Switch between global, local, and premium chat channels.
Disable global chat visibility.
Experience immersive Proximity Fading Local chat (text gets darker the further away players are from each other).
Use Quick Channel Prefixes (!, @, #, $) to talk in different channels without having to switch modes.
Hover over names for interactive tooltips and click them to automatically suggest a /msg.
Hear custom ping sounds when mentioned, and pick your own personal notification sound.

For Staff:

To check all the active local chats and private channels using Admin Chat Spy.
To have a private staff and developer chat.
Connect your in-game channels directly to Discord via Webhooks.
Customize prefixes fully with PlaceholderAPI and HEX color codes.
Restrict specific chat channels from being used in certain worlds.
Asynchronously log all chats into organized, channel-specific files to prevent server lag.

The plugin supports:

PlaceholderAPI.
Hex Prefixes.

Commands

For Players:

/channels or /chlist - View all available chat channels.
/global or /g - Switch to global chat.
/local or /l - Switch to local chat.
/toggleglobalchat - Enable or disable visibility of global chat.
/blc mentionsound <sound> - Change your personal mention ping sound (e.g., ENTITY_EXPERIENCE_ORB_PICKUP).
/betterlocalchat help - View plugin help.

For Staff:

/staffchat or /sc - Switch to Staff Chat.
/devchat or /dc - Switch to Developer Chat.
/globalplus or /gp - Switch to the premium GlobalPlus channel.
/chatspy or /spy - Toggle social spy to see all local/private messages.
/togglelocalview - See all local chats across the server regardless of distance.
/toggleglobalprefix - Toggle whether the plugin forces its global chat formatting.
/betterlocalchat reload - Reload the config files.

Permissions

Spoiler: View Permissions

chat.local: Allows players to talk in and join local chat (Default: true)
chat.global: Allows players to talk in and join global chat (Default: true)
chat.paid: Allows access to the GlobalPlus premium chat channel (Default: false)
chat.staff: Allows players to use and view staff chat (Default: op)
chat.developer: Allows players to use and view developer chat (Default: op)
chat.custommention: Allows players to customize their mention sound (Default: true)
chat.cooldown.bypass: Bypasses the global chat cooldown timer (Default: op)
chat.togglevisibility: Allows players to toggle global chat visibility (Default: true)
chat.spy: Allows players to use social spy (Default: op)
chat.seealllocal: Allows players to see all local chats regardless of distance (Default: op)
chat.reload: Allows players to reload the chat configuration (Default: op)
chat.toggleglobalprefix: Allows players to toggle global chat prefix handling (Default: op)

Configs

Code (Text):

# General Chat Settings
local-chat-radius: 100
global-chat-cooldown: 3

# Mentions & Interaction
mention-sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
mention-volume: 1.0
mention-pitch: 1.0
hover-text: "&6Click to message %player%!"
click-command: "/msg %player% "

# Chat Prefixes
local-chat-prefix: "&7[Local]&r "
global-chat-prefix: "&7[Global]&r "
staff-chat-prefix: "&c[Staff]&r "
developer-chat-prefix: "&b[Dev]&r "
globalplus-chat-prefix: "&d[GlobalPlus]&r "

# Quick Channel Prefixes
quick-prefixes:
global: "!"
staff: "@"
developer: "#"
globalplus: "$"

# Discord Webhooks (Leave blank to disable)
discord-webhooks:
global: ""
staff: ""
developer: ""
globalplus: ""

# Chat Behavior
handle-global-chat-prefix: false
return-to-global-on-leave-staffchat: true

# World Restrictions
disabled-local-chat-worlds:
- "world_nether"
- "world_the_end"
disabled-global-chat-worlds:
- "custom_world"

Commands

/global — Switch to global chat
/global
/local — Switch to local chat
/local
/betterlocalchat — Manage local chat settings
/betterlocalchat reload
/toggleglobalchat — Toggle global chat visibility
/toggleglobalchat
/toggleglobalprefix — Toggle whether plugin handles the global chat prefix
/toggleglobalprefix
/staffchat — Switch to staff chat
/staffchat
/togglelocalview — Toggle view of all local chats
/togglelocalview

Plugin details

Built for Minecraft 1.16+
Plugin version 1.0

Read from the plugin's own plugin.yml.

Quick facts

Edition: Minecraft Java
File type: .jar
Minecraft versions listed: 1.20, 1.20.6
How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
Where to get it: Opens on Spigot — not every file is mirrored on our own servers.

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

Better Local Chat is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6. Downloaded 278 times (via Spigot). Download it and open it directly in the game.

Explore more

All Mods for Java All Minecraft Java mods Java mods for 1.20