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

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.

---