VCChat

插件

· 作者 likhoded

该插件添加了本地聊天(以玩家为中心的范围内)和全局聊天,使用 Vault 和 PlaceholderAPI 进行格式化、玩家提及、自定义加入/退出消息,并支持与 GigaChatPlugin 和 DiscordSRV 的额外集成

0 本站下载 0 关注 更新于 6 个月前

最新 0.1.1 · 1.21.11 · BungeeCord / Paper

一键开服(送7天)
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 时前缀为空)。


安装步骤

  1. 请使用 Paper/Purpur —— 不要使用缺少本插件所需 API(AsyncChatEvent)的纯净 Spigot。
  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。

本地与全局聊天

配置项 描述
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 使用

  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 等)。


常见问题 (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 префиксы пустые).


Установка

  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.

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

Ключ Описание
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

  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.

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源