VoxChat
适用于 Minecraft 服务器的可配置聊天插件
支持本地与全局聊天、私信、自定义加入与离开提示等。
主要功能
- 本地聊天 — 消息会发送给同一世界中处于可配置半径内的玩家。
- 全局聊天 — 在消息开头添加
! 即可发送给所有在线玩家。
- 私信 — 向在线玩家发送私信,支持可配置的模板和可选的提示音。
- 生命周期消息 — 自定义玩家加入、离开和死亡时的显示消息。
- 简易管理 — 通过
/voxchat reload 命令重新加载插件配置。
- bStats 指标 — 收集标准的插件使用统计数据。
功能说明
不带前缀的消息默认使用本地聊天。默认情况下,同一世界中 50 格范围内的玩家会收到该消息。发送者本人也会看到这条消息。如果没有人在附近,发送者会收到一条可配置的提示。
在消息开头添加 ! 即可使用全局聊天。发送前会移除感叹号。配置中的符号会根据维度着色:主世界为绿色,下界为红色,末地为紫色。
加入、离开和死亡消息可以独立启用或禁用。死亡消息可以选择包含服务器原始的死亡文本。
配置
默认配置文件生成于 plugins/vox-chat/config.yml。
| 设置项 |
默认值 |
描述 |
local-chat.enable |
true |
启用本地聊天。 |
local-chat.radius |
50 |
本地聊天的半径(以格为单位)。 |
local-chat.message |
§7{player} >> {message} |
本地聊天格式。 |
global-chat.enable |
true |
启用带 ! 前缀的全局聊天。 |
global-chat.sign |
● |
全局聊天前缀使用的符号。 |
global-chat.message |
{world_prefix} §f{player} >> {message} |
全局聊天格式。 |
join.enable |
true |
显示自定义加入消息。 |
join.message |
§a[+] §f{player} |
加入消息格式。 |
quit.enable |
true |
显示自定义离开消息。 |
quit.message |
§c[-] §f{player} |
离开消息格式。 |
death.enable |
true |
显示自定义死亡消息。 |
death.sign |
[☠] |
死亡消息中使用的符号。 |
death.message |
{sign} {player} {default_message} |
死亡消息格式。 |
private-message.enable |
true |
启用私信功能。 |
private-message.sign |
[✉] |
私信用于显示的符号。 |
private-message.template-receiver |
§b{sign} {sender} >> {message} |
接收者看到的消息内容。 |
private-message.template-sender |
§b{sign} {sender} -> {receiver} >> {message} |
发送者看到的确认信息。 |
private-message.sound |
true |
接收者收到私信时播放声音。 |
message.noReceivers |
— |
当没有人处于本地聊天范围内时显示的提示。 |
message.pluginReloaded |
— |
配置重新加载后的确认信息。 |
message.permissionError |
— |
缺少重载权限时显示的提示。 |
message.emptyMessage |
— |
发送空私信时显示的提示。 |
message.receiverIsOffline |
— |
收件人离线时显示的提示。 |
消息模板支持以下占位符(如适用):
| 占位符 |
含义 |
{player} |
玩家显示名称。 |
{message} |
聊天或私信内容。 |
{world_prefix} |
发送者所在维度的彩色全局聊天符号。 |
{sign} |
死亡或私信用于显示的已配置符号。 |
{default_message} |
Minecraft 原始的死亡消息。 |
{sender} |
私信发送者的显示名称。 |
{receiver} |
私信接收者的显示名称。 |
可以在消息字符串中使用 Minecraft 颜色代码,例如 §a。编辑文件后,运行 /voxchat reload 以应用更改。
命令
| 命令 |
别名 |
描述 |
/message <player> <message> |
/msg, /tell, /w, /tellraw |
发送私信。 |
/voxchat reload |
/vox reload, /vc reload |
重新加载插件配置。 |
重载配置需要 voxchat.reload 权限。该权限默认授予管理员(operators)。
VoxChat
A configurable chat plugin for Minecraft servers
Local and global chat, private messages, custom join and quit notices, and more.
Key Features
- Local chat — messages reach players in the same world within a configurable radius.
- Global chat — begin a message with
! to send it to every online player.
- Private messages — message online players with configurable templates and an optional sound.
- Lifecycle messages — customize player join, quit, and death messages.
- Simple administration — reload the plugin configuration with
/voxchat reload.
- bStats metrics — collect standard plugin usage statistics.
Functionality
Messages without a prefix use local chat. By default, players within 50 blocks in the same world receive the message. The sender sees it too. If nobody is nearby, the sender receives a configurable notice.
Start a message with ! to use global chat. The exclamation mark is removed before sending. The configured sign is colored by dimension: green in the Overworld, red in the Nether, and purple in the End.
Join, quit, and death messages can each be enabled or disabled independently. The death message can include the server's original death text.
Configuration
The default configuration is created at plugins/vox-chat/config.yml.
| Setting |
Default |
Description |
local-chat.enable |
true |
Enable local chat. |
local-chat.radius |
50 |
Local chat radius in blocks. |
local-chat.message |
§7{player} >> {message} |
Local chat format. |
global-chat.enable |
true |
Enable global chat with the ! prefix. |
global-chat.sign |
● |
Sign used in the global chat prefix. |
global-chat.message |
{world_prefix} §f{player} >> {message} |
Global chat format. |
join.enable |
true |
Show a custom join message. |
join.message |
§a[+] §f{player} |
Join message format. |
quit.enable |
true |
Show a custom quit message. |
quit.message |
§c[-] §f{player} |
Quit message format. |
death.enable |
true |
Show a custom death message. |
death.sign |
[☠] |
Sign used in the death message. |
death.message |
{sign} {player} {default_message} |
Death message format. |
private-message.enable |
true |
Enable private messages. |
private-message.sign |
[✉] |
Sign used in private messages. |
private-message.template-receiver |
§b{sign} {sender} >> {message} |
Message shown to the receiver. |
private-message.template-sender |
§b{sign} {sender} -> {receiver} >> {message} |
Confirmation shown to the sender. |
private-message.sound |
true |
Play a sound for the receiver. |
message.noReceivers |
— |
Notice shown when nobody is in local chat range. |
message.pluginReloaded |
— |
Confirmation after a configuration reload. |
message.permissionError |
— |
Notice shown when reload permission is missing. |
message.emptyMessage |
— |
Notice shown when a private message is empty. |
message.receiverIsOffline |
— |
Notice shown when the recipient is offline. |
Message templates support these placeholders where applicable:
| Placeholder |
Meaning |
{player} |
Player display name. |
{message} |
Chat or private message text. |
{world_prefix} |
Colored global chat sign for the sender's world. |
{sign} |
Configured sign for deaths or private messages. |
{default_message} |
Minecraft's original death message. |
{sender} |
Private message sender's display name. |
{receiver} |
Private message receiver's display name. |
Use Minecraft color codes such as §a in message strings. After editing the file, run /voxchat reload to apply the changes.
Commands
| Command |
Aliases |
Description |
/message <player> <message> |
/msg, /tell, /w, /tellraw |
Send a private message. |
/voxchat reload |
/vox reload, /vc reload |
Reload the plugin configuration. |
The voxchat.reload permission is required to reload the configuration. It is granted to operators by default.
评论 0
登录后参与评分
还没有评论,来抢沙发吧