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.

Плагин для 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.