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

VCChat does not require these; without them some features are disabled or simplified (e.g. empty prefixes without Vault).

Installation

1. Use Paper/Purpur — not bare Spigot without the APIs this plugin needs (AsyncChatEvent).
2. Copy VCChat-*.jar into plugins.
3. For GigaChat and/or Discord, install GigaChatPlugin and/or DiscordSRV (install before or alongside VCChat; load order is usually not critical).
4. Fully restart the server.
5. Edit plugins/VCChat/config.yml for your server (see below).
6. Run /vcchat reload or restart again to apply config.

Configuring config.yml

Created on first run: plugins/VCChat/config.yml.

Local and global chat

Permissions

Mentions and join/quit

Sections mention, join, quit — colours, sounds, text; join/quit support PAPI placeholders.

GigaChat integration (gigachat)

Enable with gigachat.enabled: true.

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).

Working with GigaChatPlugin

1. Install GigaChatPlugin, configure gigachat.yml (API keys, model, TLS if needed).
2. In GigaChatPlugin: chat-listener-enabled: false.
3. In VCChat: configure gigachat and optionally gigachat.discord.
4. 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+).

Опциональные плагины

VCChat не обязан иметь эти плагины; без них часть функций отключается или упрощается (например, без Vault префиксы пустые).

Установка

1. Убедитесь, что сервер — Paper/Purpur, не чистый Spigot без нужных API (используется AsyncChatEvent).
2. Скопируйте VCChat-*.jar в папку plugins.
3. Если нужны GigaChat и/или Discord — установите GigaChatPlugin и/или DiscordSRV (рекомендуется ставить до или вместе с VCChat; порядок загрузки обычно некритичен).
4. Полностью перезапустите сервер.
5. Отредактируйте plugins/VCChat/config.yml под свой сервер (см. ниже).
6. Выполните /vcchat reload или снова рестарт, чтобы применить конфиг.

Настройка config.yml

Файл создаётся при первом запуске: plugins/VCChat/config.yml.

Локальный и глобальный чат

Права

Упоминания и join/quit

Секции mention, join, quit — цвет, звук, тексты; в join/quit работают плейсхолдеры PAPI.

Интеграция с GigaChat (gigachat)

Включение: gigachat.enabled: true.

Важно: на стороне GigaChatPlugin в config.yml должно быть chat-listener-enabled: false, иначе возможны два ответа на одно обращение.

Пересылка ответов в Discord (gigachat.discord)

Требуется установленный DiscordSRV, каналы настроены в его config.yml (секция Channels).

Совместная работа с GigaChatPlugin

1. Установите GigaChatPlugin, пропишите gigachat.yml (ключи API, модель, при необходимости TLS).
2. В GigaChatPlugin: chat-listener-enabled: false.
3. В VCChat: настройте секцию gigachat и при необходимости gigachat.discord.
4. Перезапуск сервера после первичной настройки; дальше правки VCChat — через /vcchat reload.

Права на запросы к GigaChat задаются в GigaChatPlugin (gigachat.ask и т.д.).

Частые вопросы

Почему локальные сообщения не уходят в Discord, а ответ GigaChat уходил?
Локальный чат специально отменяется на раннем этапе обработки события, чтобы DiscordSRV не считал это обычным чатом. Ответ бота в Discord при включённой секции gigachat.discord отправляется отдельно через API DiscordSRV.

Ошибка «внутренняя ошибка моста GigaChat»
Обычно GigaChatPlugin не загрузился или не зарегистрировал сервис. Проверьте логи при старте и наличие JAR.