Vocal Text

Distance-based proximity chat with muffling, whisper, dead chat, and PlaceholderAPI support.

VocalText

vocal-text-banner

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

  1. Drop the JAR into your plugins/ folder
  2. Restart the server
  3. 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.


The Vocal Text Team

profile avatar
  • 2
    Projects
  • 6
    Downloads
Donate

More from Corn_Can