VocalText

VocalText 为你的 Minecraft 服务器带来基于真实距离的通信体验。
玩家只有在足够接近时才能听到彼此的声音——距离越远,
对方的话语就越模糊不清。告别全局聊天。让每一次对话都融入游戏世界之中。
工作原理
当玩家发送聊天信息时,只有在配置半径内的玩家能收到该消息。
随着距离增加,字符会逐渐被 _ 和 ? 替换,模拟声音在远处衰减的效果。
超出半径范围后,则完全听不到任何内容。
功能特性
? 本地聊天
基于距离的聊天系统,实时文本模糊效果。距离越远,阅读难度越大。
? 耳语(/vt w)
/vt w <message> — 向附近的所有人耳语(半径更小,但仍受距离影响而模糊)
/vt w <player> <message> — 向特定的附近玩家发送定向私信;
旁观者仅能看到 "... whispers something to someone nearby" —— 无法看到具体内容
? 呼喊(/vt shout)
用于重要时刻的全服广播。完全突破距离限制。
? 死亡频道
死亡玩家会自动进入幽灵频道。只有其他死亡玩家能听到他们的发言。
重生后,他们将回到正常频道。拥有间谍模式的管理员仍可观察。
? 间谍模式(/vt spy)
管理员可切换一种模式,无论其在地图上的位置如何,都能看到所有本地聊天、耳语及幽灵频道的消息。
? 多语言支持
内置支持 English、繁體中文 和 简体中文。
玩家可通过 /vt lang 随时切换显示语言,且选择会在会话间保存。
? PlaceholderAPI
当安装 PAPI 时,所有格式字符串均支持 PlaceholderAPI 占位符(例如 %vault_rank%)。此为可选功能——若无 PAPI 也不会报错。
命令
| 命令 |
描述 |
权限 |
/vt w <message> |
向附近玩家区域耳语 |
— |
/vt w <player> <message> |
向特定玩家直接耳语 |
— |
/vt shout <message> |
全服广播 |
— |
/vt spy [player] |
切换间谍模式 |
vocaltext.admin |
/vt lang [code|reset] |
切换显示语言 |
— |
/vt reload |
重载配置与翻译 |
vocaltext.admin |
别名: /vocaltext → /vt
安装方法
- 将 JAR 文件放入
plugins/ 文件夹
- 重启服务器
- 编辑
plugins/VocalText/config.yml 以调整半径和消息格式
需要: Paper 或 Spigot 1.21+
可选: PlaceholderAPI
配置概览
chatRadius: 50.0 # 本地聊天范围(方块数)
enableDistanceMuffleText: true # 启用字符模糊效果
constrictionRatio: 0.25 # 耳语范围 = chatRadius × 此值
enableDeadChat: true # 死亡玩家的幽灵频道
...
完整配置参考请查看 GitHub README。
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧