VocalText

VocalText brings realistic proximity-based communication to your Minecraft server.
Players can only hear each other when they're close enough â and the further away someone is,
the more their words blur and garble. No more global chat. Every conversation feels grounded in the world.
How it works
When a player types in chat, only players within the configured radius receive the message.
As distance increases, characters are gradually replaced with _ and ?, simulating a voice
fading in the distance. Past the radius, nothing is heard at all.
Features
đŦ Local Chat
Distance-based chat with real-time text muffling. The further away, the harder it is to read.
đ¤Ģ Whisper (/vt w)
/vt w <message> â whispers to anyone nearby (tighter radius, still muffled by distance)
/vt w <player> <message> â sends a directed private message to a specific nearby player;
bystanders only see "âĻ whispers something to someone nearby" â not the content
đĸ Shout (/vt shout)
Server-wide broadcast for important moments. Cuts through the distance limit entirely.
đģ Dead Chat
Dead players are automatically placed in a ghost channel. Only other dead players can hear
them. On respawn, they return to the normal channel. Admins with spy mode can still observe.
đ Spy Mode (/vt spy)
Admins can toggle a mode that lets them see all local chat, whispers, and ghost channel messages
regardless of their position on the map.
đ Multi-language
Built-in support for English, įšéĢ䏿, and įŽäŊ䏿.
Players can switch languages on the fly with /vt lang, and the choice is saved across sessions.
đ PlaceholderAPI
All format strings support PlaceholderAPI placeholders (e.g. %vault_rank%) when PAPI is installed. Fully optional â no errors if PAPI is absent.
Commands
| Command |
Description |
Permission |
/vt w <message> |
Area whisper to nearby players |
â |
/vt w <player> <message> |
Direct whisper to a specific player |
â |
/vt shout <message> |
Global broadcast |
â |
/vt spy [player] |
Toggle spy mode |
vocaltext.admin |
/vt lang [code|reset] |
Switch display language |
â |
/vt reload |
Reload config & translations |
vocaltext.admin |
Alias: /vocaltext â /vt
Installation
- Drop the JAR into your
plugins/ folder
- Restart the server
- Edit
plugins/VocalText/config.yml to tune radii and message formats
Requires: Paper or Spigot 1.21+
Optional: PlaceholderAPI
Config overview
chatRadius: 50.0 # local chat range in blocks
enableDistanceMuffleText: true # enable the character garbling effect
constrictionRatio: 0.25 # whisper range = chatRadius à this value
enableDeadChat: true # ghost channel for dead players
...
Full config reference is in the GitHub README.