En
VCChat
一款适用于 Paper / Purpur 的插件(Minecraft,API 1.21),支持添加本地聊天(以玩家为中心的半径范围)和全局聊天(消息前缀),通过 Vault 和 PlaceholderAPI 进行格式化,支持玩家提及、自定义加入/离开消息、可选的 GigaChatPlugin 集成,以及通过 DiscordSRV 将 GigaChat 机器人的回复转发至 Discord。
功能特性
- 本地聊天 — 只有同一世界中处于可配置半径内的其他玩家能听到你的发言。
- 全局聊天 — 消息以可配置的前缀开头(默认为
!);所有在线玩家均可看到。
- 格式设置:本地和全局聊天均支持
{prefix}、{suffix}、{displayname}、{message} 以及 PlaceholderAPI (%...%)。
- Vault — 当安装 Vault 时,使用权限插件(如 LuckPerms 等)提供的名字前缀/后缀。
@player 提及 — 对被提及的玩家进行高亮并播放提示音。
- 可配置的加入 / 离开消息(可禁用)。
- GigaChat — 通过别名呼叫机器人(例如
@gigachat question);回复会发送至与提问相同的频道(本地或全局)。
- 可选地抑制在与 GigaChat 对话且本地范围内无其他玩家时显示的“没人听到你说话”提示。
- DiscordSRV — 可选地将 GigaChat 回复文本转发至 Discord 频道(针对全局和/或本地问题设有独立开关)。
依赖要求
- Paper 或 Purpur,且需具备当前 1.21 API 分支版本(参见
build.gradle)。
- Java 版本需兼容你的服务端构建版本(通常为 21+)。
可选插件
| 插件 |
用途 |
| PlaceholderAPI |
在聊天及加入/离开格式中使用额外的占位符 |
| Vault + 权限插件 |
在消息中显示名字前缀/后缀 |
| GigaChatPlugin |
通过 Bukkit 服务发起 GigaChat 请求 |
| DiscordSRV |
将机器人回复转发至 Discord |
VCChat 不需要上述插件即可运行;若未安装,部分功能将被禁用或简化(例如没有 Vault 时前缀为空)。
安装步骤
- 请使用 Paper/Purpur —— 不要使用缺少本插件所需 API(
AsyncChatEvent)的纯净 Spigot。
- 将
VCChat-*.jar 复制到 plugins 文件夹。
- 如需使用 GigaChat 和/或 Discord,请安装 GigaChatPlugin 和/或 DiscordSRV(请在 VCChat 之前或同时安装;加载顺序通常不关键)。
- 完全重启服务器。
- 编辑
plugins/VCChat/config.yml 以适应你的服务器需求(详见下文)。
- 运行
/vcchat reload 或再次重启以应用配置更改。
配置 config.yml
首次运行时自动生成:plugins/VCChat/config.yml。
本地与全局聊天
| 配置项 |
描述 |
local-chat.radius |
半径距离(方块数);接收者需位于该球体范围内且在同一世界 |
global-prefix |
全局消息起始的前缀(该前缀本身会从聊天文本中去除) |
formats.local, formats.global |
消息模板(请参阅内置配置文件中的注释) |
no-one-heard |
当本地范围内没有其他玩家时,发送给发送者的提示信息 |
权限设置
| 权限节点 |
用途 |
默认值 |
vcchat.local |
使用本地聊天 |
true |
vcchat.global |
使用全局聊天(带前缀) |
true |
vcchat.admin.reload |
执行 /vcchat reload |
op |
提及与加入/离开消息
mention、join、quit 部分包含颜色、音效和文本设置;加入/离开消息支持 PAPI 占位符。
GigaChat 集成 (gigachat)
启用方式:gigachat.enabled: true。
| 选项 |
含义 |
alias |
文本中的触发词,例如 @gigachat |
bot-name, bot-prefix |
“像玩家一样回复”模式下机器人的显示名称 |
reply-like-player |
将回复格式化为类似玩家消息的形式 |
reply-like-player-local-format / reply-like-player-global-format |
不含公会占位符的独立格式 |
thinking-enabled / thinking-message |
私有的“请求已发送…”提示消息 |
format, error-format, scope-tag-* |
回复和错误信息的样式 |
suppress-no-one-heard |
呼叫 GigaChat 时隐藏“没人听到你说话”的提示 |
alias-color |
玩家消息中别名的显示颜色 |
重要提示: 在 GigaChatPlugin 的 config.yml 中,请将 chat-listener-enabled: false,否则可能会导致收到两条重复回复。
转发回复至 Discord (gigachat.discord)
需要在 DiscordSRV 的 config.yml (Channels 部分) 中配置好频道。
| 选项 |
描述 |
enabled |
转发功能的总开关 |
channel |
DiscordSRV 中的游戏频道名称(通常是 global) |
send-global |
转发针对全局聊天中提问的机器人回复 |
send-local |
转发针对本地聊天中提问的机器人回复 |
format |
Discord 消息字符串;支持 {player} 和 {answer} |
Spoiler
配合 GigaChatPlugin 使用
- 安装 GigaChatPlugin,配置
gigachat.yml(API 密钥、模型、TLS 等)。
- 在 GigaChatPlugin 中设置:
chat-listener-enabled: false。
- 在 VCChat 中配置
gigachat 以及可选的 gigachat.discord。
- 初次设置后完全重启服务器;后续对 VCChat 的配置修改可通过
/vcchat reload 生效。
GigaChat 请求的权限由 GigaChatPlugin 定义(如 gigachat.ask 等)。
常见问题 (FAQ)
为什么本地聊天消息没有发送到 Discord,但 GigaChat 的回复却发送了?
本地聊天在事件处理管道的早期阶段就被取消,因此 DiscordSRV 不会将其视为普通聊天处理。当启用 gigachat.discord 时,机器人回复会通过 DiscordSRV 的 API 单独发送。
“Internal GigaChat bridge error”(内部 GigaChat 桥接错误)
通常是因为 GigaChatPlugin 未能正确加载或未注册服务。请检查启动日志,并确保 JAR 文件存在。
Ru
Плагин для Paper / Purpur (Minecraft, API 1.21) добавляет локальный чат (по радиусу от игрока) и глобальный чат, форматирование через Vault и PlaceholderAPI, упоминания игроков, кастомные сообщения входа/выхода, опциональную интеграцию с GigaChatPlugin и пересылку ответов бота в Discord через DiscordSRV.
Возможности
- Локальный чат — видят только игроки в заданном радиусе в том же мире.
- Глобальный чат — сообщение начинается с настраиваемого префикса (по умолчанию
!); видят все онлайн.
- Форматы для локального и глобального канала:
{prefix}, {suffix}, {displayname}, {message}, плейсхолдеры PlaceholderAPI (%...%).
- Vault — префикс и суффикс из плагина прав (LuckPerms и др.), если Vault установлен.
- Упоминания
@ник — подсветка и звук у адресата.
- Настраиваемые сообщения join / quit (можно отключить).
- GigaChat — обращение по алиасу (например
@gigachat вопрос); ответ приходит в тот же канал (локальный или глобальный), что и вопрос.
- Подавление сообщения «никто не услышал» при обращении к GigaChat в пустом локале (настраивается).
- DiscordSRV — опциональная отправка текста ответа GigaChat в выбранный Discord-канал (глобальные и/или локальные вопросы — отдельными флагами).
Требования
- Paper или Purpur с актуальным API ветки 1.21 (см. версию в
build.gradle).
- Java, совместимая с вашей сборкой сервера (обычно 21+).
Опциональные плагины
| Плагин |
Зачем |
| PlaceholderAPI |
Расширенные плейсхолдеры в форматах чата и join/quit |
| Vault + плагин прав |
Префикс/суффикс в формате сообщения |
| GigaChatPlugin |
Запросы к GigaChat через Bukkit-сервис |
| DiscordSRV |
Пересылка ответов бота в Discord |
VCChat не обязан иметь эти плагины; без них часть функций отключается или упрощается (например, без Vault префиксы пустые).
Установка
- Убедитесь, что сервер — Paper/Purpur, не чистый Spigot без нужных API (используется
AsyncChatEvent).
- Скопируйте
VCChat-*.jar в папку plugins.
- Если нужны GigaChat и/или Discord — установите GigaChatPlugin и/или DiscordSRV (рекомендуется ставить до или вместе с VCChat; порядок загрузки обычно некритичен).
- Полностью перезапустите сервер.
- Отредактируйте
plugins/VCChat/config.yml под свой сервер (см. ниже).
- Выполните
/vcchat reload или снова рестарт, чтобы применить конфиг.
Настройка config.yml
Файл создаётся при первом запуске: plugins/VCChat/config.yml.
Локальный и глобальный чат
| Ключ |
Описание |
local-chat.radius |
Радиус в блоках; в локальный чат попадают игроки в том же мире внутри сферы |
global-prefix |
Символ(ы) в начале сообщения для глобала (сам префикс в текст чата не попадает) |
formats.local, formats.global |
Шаблоны сообщений (см. комментарии в конфиге) |
no-one-heard |
Сообщение игроку в локале, если рядом никого нет |
Права
| Право |
Назначение |
По умолчанию |
vcchat.local |
Писать в локальный чат |
true |
vcchat.global |
Писать в глобальный |
true |
vcchat.admin.reload |
Команда /vcchat reload |
op |
Упоминания и join/quit
Секции mention, join, quit — цвет, звук, тексты; в join/quit работают плейсхолдеры PAPI.
Интеграция с GigaChat (gigachat)
Включение: gigachat.enabled: true.
| Параметр |
Смысл |
alias |
Триггер в тексте, например @gigachat |
bot-name, bot-prefix |
Отображение «бота» при режиме ответа как у игрока |
reply-like-player |
Ответ оформляется как сообщение игрока |
reply-like-player-local-format / reply-like-player-global-format |
Отдельные форматы без лишних клановых плейсхолдеров |
thinking-enabled / thinking-message |
Личное сообщение «запрос отправлен…» |
format, error-format, scope-tag-* |
Внешний вид ответа и ошибок |
suppress-no-one-heard |
Не показывать «никто не услышал», если игрок обратился к GigaChat |
alias-color |
Подсветка алиаса в сообщении игрока |
Важно: на стороне GigaChatPlugin в config.yml должно быть chat-listener-enabled: false, иначе возможны два ответа на одно обращение.
Пересылка ответов в Discord (gigachat.discord)
Требуется установленный DiscordSRV, каналы настроены в его config.yml (секция Channels).
| Параметр |
Описание |
enabled |
Мастер-включатель пересылки |
channel |
Имя игрового канала из DiscordSRV (часто global) |
send-global |
Пересылать ответы на вопросы из глобального чата |
send-local |
Пересылать ответы на вопросы из локального чата |
format |
Строка в Discord; {player}, {answer} |
Совместная работа с GigaChatPlugin
- Установите GigaChatPlugin, пропишите
gigachat.yml (ключи API, модель, при необходимости TLS).
- В GigaChatPlugin:
chat-listener-enabled: false.
- В VCChat: настройте секцию
gigachat и при необходимости gigachat.discord.
- Перезапуск сервера после первичной настройки; дальше правки VCChat — через
/vcchat reload.
Права на запросы к GigaChat задаются в GigaChatPlugin (gigachat.ask и т.д.).
Частые вопросы
Почему локальные сообщения не уходят в Discord, а ответ GigaChat уходил?
Локальный чат специально отменяется на раннем этапе обработки события, чтобы DiscordSRV не считал это обычным чатом. Ответ бота в Discord при включённой секции gigachat.discord отправляется отдельно через API DiscordSRV.
Ошибка «внутренняя ошибка моста GigaChat»
Обычно GigaChatPlugin не загрузился или не зарегистрировал сервис. Проверьте логи при старте и наличие JAR.
En
VCChat
A Paper / Purpur plugin (Minecraft, API 1.21) that adds local chat (radius around the player) and global chat (message prefix), formatting via Vault and PlaceholderAPI, player mentions, custom join/quit messages, optional GigaChatPlugin integration, and forwarding GigaChat bot replies to Discord via DiscordSRV.
Features
- Local chat — only players within a configurable radius in the same world hear you.
- Global chat — message starts with a configurable prefix (default
!); everyone online sees it.
- Formats for local and global:
{prefix}, {suffix}, {displayname}, {message}, PlaceholderAPI (%...%).
- Vault — prefix/suffix from your permissions plugin (LuckPerms, etc.) when Vault is installed.
@player mentions — highlight and sound for the mentioned player.
- Configurable join / quit messages (can be disabled).
- GigaChat — address the bot by alias (e.g.
@gigachat question); the reply goes to the same channel (local or global) as the question.
- Optional suppression of the “nobody heard you” message when talking to GigaChat in an empty local radius.
- DiscordSRV — optional forwarding of GigaChat reply text to a Discord channel (global and/or local questions — separate flags).
Requirements
- Paper or Purpur with a current 1.21 API branch (see
build.gradle).
- Java compatible with your server build (usually 21+).
Optional plugins
| Plugin |
Purpose |
| PlaceholderAPI |
Extra placeholders in chat and join/quit formats |
| Vault + permissions plugin |
Prefix/suffix in messages |
| GigaChatPlugin |
GigaChat requests via Bukkit service |
| DiscordSRV |
Forward bot replies to Discord |
VCChat does not require these; without them some features are disabled or simplified (e.g. empty prefixes without Vault).
Installation
- Use Paper/Purpur — not bare Spigot without the APIs this plugin needs (
AsyncChatEvent).
- Copy
VCChat-*.jar into plugins.
- For GigaChat and/or Discord, install GigaChatPlugin and/or DiscordSRV (install before or alongside VCChat; load order is usually not critical).
- Fully restart the server.
- Edit
plugins/VCChat/config.yml for your server (see below).
- Run
/vcchat reload or restart again to apply config.
Configuring config.yml
Created on first run: plugins/VCChat/config.yml.
Local and global chat
| Key |
Description |
local-chat.radius |
Radius in blocks; recipients are in the same world within that sphere |
global-prefix |
Prefix at the start of a message for global (the prefix itself is stripped from chat text) |
formats.local, formats.global |
Message templates (see comments in the bundled config) |
no-one-heard |
Message to the player in local chat when nobody else is in range |
Permissions
| Permission |
Purpose |
Default |
vcchat.local |
Use local chat |
true |
vcchat.global |
Use global chat (with prefix) |
true |
vcchat.admin.reload |
/vcchat reload |
op |
Mentions and join/quit
Sections mention, join, quit — colours, sounds, text; join/quit support PAPI placeholders.
GigaChat integration (gigachat)
Enable with gigachat.enabled: true.
| Option |
Meaning |
alias |
Trigger in text, e.g. @gigachat |
bot-name, bot-prefix |
Bot display when using “reply like player” mode |
reply-like-player |
Format the reply like a player message |
reply-like-player-local-format / reply-like-player-global-format |
Separate formats without clan placeholders |
thinking-enabled / thinking-message |
Private “request sent…” message |
format, error-format, scope-tag-* |
Reply and error appearance |
suppress-no-one-heard |
Hide “nobody heard you” when addressing GigaChat |
alias-color |
Highlight colour for the alias in the player’s message |
Important: in GigaChatPlugin config.yml, set chat-listener-enabled: false, otherwise you may get two replies.
Forwarding replies to Discord (gigachat.discord)
Requires DiscordSRV with channels configured in its config.yml (Channels section).
| Option |
Description |
enabled |
Master switch for forwarding |
channel |
Game channel name from DiscordSRV (often global) |
send-global |
Forward replies to questions asked in global chat |
send-local |
Forward replies to questions asked in local chat |
format |
Discord message string; {player}, {answer} |
Spoiler
Working with GigaChatPlugin
- Install GigaChatPlugin, configure
gigachat.yml (API keys, model, TLS if needed).
- In GigaChatPlugin:
chat-listener-enabled: false.
- In VCChat: configure
gigachat and optionally gigachat.discord.
- Full restart after initial setup; later VCChat edits via
/vcchat reload.
GigaChat request permissions are defined in GigaChatPlugin (gigachat.ask, etc.).
FAQ
Why don’t local messages go to Discord, but GigaChat replies did?
Local chat is cancelled early in the event pipeline so DiscordSRV does not treat it as normal chat. Bot replies to Discord are sent separately through DiscordSRV’s API when gigachat.discord is enabled.
“Internal GigaChat bridge error”
Usually GigaChatPlugin failed to load or did not register the service. Check startup logs and that the JAR is present.
Ru
Плагин для Paper / Purpur (Minecraft, API 1.21) добавляет локальный чат (по радиусу от игрока) и глобальный чат, форматирование через Vault и PlaceholderAPI, упоминания игроков, кастомные сообщения входа/выхода, опциональную интеграцию с GigaChatPlugin и пересылку ответов бота в Discord через DiscordSRV.
Возможности
- Локальный чат — видят только игроки в заданном радиусе в том же мире.
- Глобальный чат — сообщение начинается с настраиваемого префикса (по умолчанию
!); видят все онлайн.
- Форматы для локального и глобального канала:
{prefix}, {suffix}, {displayname}, {message}, плейсхолдеры PlaceholderAPI (%...%).
- Vault — префикс и суффикс из плагина прав (LuckPerms и др.), если Vault установлен.
- Упоминания
@ник — подсветка и звук у адресата.
- Настраиваемые сообщения join / quit (можно отключить).
- GigaChat — обращение по алиасу (например
@gigachat вопрос); ответ приходит в тот же канал (локальный или глобальный), что и вопрос.
- Подавление сообщения «никто не услышал» при обращении к GigaChat в пустом локале (настраивается).
- DiscordSRV — опциональная отправка текста ответа GigaChat в выбранный Discord-канал (глобальные и/или локальные вопросы — отдельными флагами).
Требования
- Paper или Purpur с актуальным API ветки 1.21 (см. версию в
build.gradle).
- Java, совместимая с вашей сборкой сервера (обычно 21+).
Опциональные плагины
| Плагин |
Зачем |
| PlaceholderAPI |
Расширенные плейсхолдеры в форматах чата и join/quit |
| Vault + плагин прав |
Префикс/суффикс в формате сообщения |
| GigaChatPlugin |
Запросы к GigaChat через Bukkit-сервис |
| DiscordSRV |
Пересылка ответов бота в Discord |
VCChat не обязан иметь эти плагины; без них часть функций отключается или упрощается (например, без Vault префиксы пустые).
Установка
- Убедитесь, что сервер — Paper/Purpur, не чистый Spigot без нужных API (используется
AsyncChatEvent).
- Скопируйте
VCChat-*.jar в папку plugins.
- Если нужны GigaChat и/или Discord — установите GigaChatPlugin и/или DiscordSRV (рекомендуется ставить до или вместе с VCChat; порядок загрузки обычно некритичен).
- Полностью перезапустите сервер.
- Отредактируйте
plugins/VCChat/config.yml под свой сервер (см. ниже).
- Выполните
/vcchat reload или снова рестарт, чтобы применить конфиг.
Настройка config.yml
Файл создаётся при первом запуске: plugins/VCChat/config.yml.
Локальный и глобальный чат
| Ключ |
Описание |
local-chat.radius |
Радиус в блоках; в локальный чат попадают игроки в том же мире внутри сферы |
global-prefix |
Символ(ы) в начале сообщения для глобала (сам префикс в текст чата не попадает) |
formats.local, formats.global |
Шаблоны сообщений (см. комментарии в конфиге) |
no-one-heard |
Сообщение игроку в локале, если рядом никого нет |
Права
| Право |
Назначение |
По умолчанию |
vcchat.local |
Писать в локальный чат |
true |
vcchat.global |
Писать в глобальный |
true |
vcchat.admin.reload |
Команда /vcchat reload |
op |
Упоминания и join/quit
Секции mention, join, quit — цвет, звук, тексты; в join/quit работают плейсхолдеры PAPI.
Интеграция с GigaChat (gigachat)
Включение: gigachat.enabled: true.
| Параметр |
Смысл |
alias |
Триггер в тексте, например @gigachat |
bot-name, bot-prefix |
Отображение «бота» при режиме ответа как у игрока |
reply-like-player |
Ответ оформляется как сообщение игрока |
reply-like-player-local-format / reply-like-player-global-format |
Отдельные форматы без лишних клановых плейсхолдеров |
thinking-enabled / thinking-message |
Личное сообщение «запрос отправлен…» |
format, error-format, scope-tag-* |
Внешний вид ответа и ошибок |
suppress-no-one-heard |
Не показывать «никто не услышал», если игрок обратился к GigaChat |
alias-color |
Подсветка алиаса в сообщении игрока |
Важно: на стороне GigaChatPlugin в config.yml должно быть chat-listener-enabled: false, иначе возможны два ответа на одно обращение.
Пересылка ответов в Discord (gigachat.discord)
Требуется установленный DiscordSRV, каналы настроены в его config.yml (секция Channels).
| Параметр |
Описание |
enabled |
Мастер-включатель пересылки |
channel |
Имя игрового канала из DiscordSRV (часто global) |
send-global |
Пересылать ответы на вопросы из глобального чата |
send-local |
Пересылать ответы на вопросы из локального чата |
format |
Строка в Discord; {player}, {answer} |
Совместная работа с GigaChatPlugin
- Установите GigaChatPlugin, пропишите
gigachat.yml (ключи API, модель, при необходимости TLS).
- В GigaChatPlugin:
chat-listener-enabled: false.
- В VCChat: настройте секцию
gigachat и при необходимости gigachat.discord.
- Перезапуск сервера после первичной настройки; дальше правки VCChat — через
/vcchat reload.
Права на запросы к GigaChat задаются в GigaChatPlugin (gigachat.ask и т.д.).
Частые вопросы
Почему локальные сообщения не уходят в Discord, а ответ GigaChat уходил?
Локальный чат специально отменяется на раннем этапе обработки события, чтобы DiscordSRV не считал это обычным чатом. Ответ бота в Discord при включённой секции gigachat.discord отправляется отдельно через API DiscordSRV.
Ошибка «внутренняя ошибка моста GigaChat»
Обычно GigaChatPlugin не загрузился или не зарегистрировал сервис. Проверьте логи при старте и наличие JAR.
评论 0
登录后参与评分
还没有评论,来抢沙发吧