hClansChatAddon [1.21.X-26.X] | Аддон для плагина hClans

Платно Плагин hClansChatAddon [1.21.X-26.X] | Аддон для плагина hClans v1.0

Нет прав для приобретения ("149.99" ₽)
Обзор История Обсуждение
Поддерживаемые версии
  1. 1.21
  2. 26
Ядра и Прокси
  1. Bukkit
  2. Spigot
  3. Paper
Минимальная версия Java
21
hClansChatAddon
Удобный клановый чат для hClans

Clan Chat • /clan chat • Toggle Mode • @Mentions • MiniMessage • PlaceholderAPI • hClans Permissions
​


hClansChatAddon — это аддон для hClans, который добавляет отдельный клановый чат. Игроки могут отправлять сообщения только участникам своего клана, включать режим перенаправления обычного чата в клановый, пинговать соклановцев через ник, отключать получение кланового чата для себя, а управляющие роли могут включать или выключать клановый чат для всего клана.

Аддон делает общение внутри клана удобным, приватным и полностью настраиваемым через конфигурацию.


Основные возможности

  • Клановый чат для hClans — команда регистрируется как сабкоманда hClans.
  • Отправка разового сообщения — игрок может написать сообщение в клановый чат через /clan chat.
  • Режим перенаправления чата — обычные сообщения игрока могут автоматически отправляться в клановый чат.
  • Два режима команды — MESSAGE и TOGGLE.
  • Включение и выключение чата клана — управляющие роли могут включать или отключать клановый чат для всего клана.
  • Личное отключение получения — игрок может выключить получение сообщений кланового чата только для себя.
  • Пинги соклановцев — поддержка упоминаний через ник.
  • Подсветка упоминаний — для упомянутого игрока ник может выделяться отдельным форматом.
  • Звук при упоминании — можно настроить звук, громкость и pitch.
  • Tab-complete для упоминаний — подсказки игроков клана при вводе @.
  • Поддержка офлайн-участников в подсказках — опционально можно предлагать известных офлайн-соклановцев.
  • Гибкий формат сообщений — настройка внешнего вида кланового чата через config.yml.
  • PlaceholderAPI — можно использовать PAPI-плейсхолдеры в формате сообщения.
  • MiniMessage и HEX-цвета — красивые цвета, стили, градиенты и форматирование.
  • Опциональные цвета в сообщениях игроков — можно разрешить игрокам использовать MiniMessage-теги в тексте.
  • Права управления через hClans — доступ к управлению чатом выдаётся через клановые права hClans.
  • Владелец всегда может управлять чатом — это поведение можно оставить включённым в конфиге.
  • Хранение настроек — состояние чата клана и личные настройки игроков сохраняются через базу hClans.
  • Очистка при удалении клана — состояние чата удалённого клана автоматически очищается.
  • Асинхронная запись в базу — сохранение состояний выполняется в отдельном потоке.
  • Настраиваемые алиасы — можно добавить дополнительные алиасы для сабкоманды.


Как работает клановый чат?

Игрок, который состоит в клане, может отправить сообщение командой:

Код: 
/clan chat <сообщение>

Сообщение получат онлайн-участники его клана, у которых не отключено получение кланового чата.

Формат сообщения настраивается в config.yml. Можно вывести название клана, ник игрока, display name, префиксы через PlaceholderAPI и само сообщение.

Пример стандартного формата:

Код: 
ᴄʟᴀɴ (ClanName) | Player » message


Два режима команды

В конфиге можно выбрать режим работы команды:

Код: 
settings.command.mode: MESSAGE

или

Код: 
settings.command.mode: TOGGLE

MESSAGE — стандартный режим.
Игрок пишет:

Код: 
/clan chat Привет, клан!

и сообщение сразу отправляется в клановый чат.

TOGGLE — режим переключателя.
В этом режиме команда:

Код: 
/clan chat

включает или выключает личный режим кланового чата. Когда режим включён, обычные сообщения игрока в чат автоматически отправляются в клановый чат, а не в общий.

Даже в TOGGLE-режиме можно отправить разовое сообщение через:

Код: 
/clan chat <сообщение>


Управление чатом клана

Управляющие участники клана могут включать или выключать клановый чат для всего клана.

По умолчанию используются команды:

Код: 
/clan chat on
Включить клановый чат.

Код: 
/clan chat off
Выключить клановый чат.

Алиасы on и off можно изменить в config.yml.

Если чат клана выключен, писать в него смогут только игроки с правом управления. Также можно настроить, будут ли видеть выключенный клановый чат только управляющие роли.


Личное отключение получения

Игрок может отключить получение сообщений кланового чата для себя:

Код: 
/clan chat toggle

После этого он перестанет получать сообщения кланового чата от других участников. Повторное использование команды снова включает получение.

Это удобно, когда игрок временно не хочет видеть клановый чат, но остаётся в клане.


Пинги соклановцев

hClansChatAddon поддерживает упоминания через символ @.

Пример:

Код: 
/clan chat @Player срочно иди на базу

Если игрок Player находится онлайн и состоит в том же клане, для него упоминание будет подсвечено отдельным форматом. Также ему можно проиграть звук.

Настраивается:

  • включены ли пинги;
  • префикс упоминания, например @;
  • формат подсветки;
  • звук;
  • громкость;
  • pitch;
  • подсказки в tab-complete;
  • использовать ли офлайн-участников в подсказках.

По умолчанию tab-complete предлагает только онлайн-соклановцев. При необходимости можно включить подсказки известных офлайн-участников.


Гибкий формат сообщений

Формат кланового чата настраивается в config.yml:

Код: 
settings.chat.format

Доступные внутренние плейсхолдеры:

Код: 
{prefix}
{clan}
{player}
{display}
{message}

{prefix} — префикс из конфига.
{clan} — название клана.
{player} — ник игрока.
{display} — display name игрока.
{message} — текст сообщения.

Также в формате можно использовать PlaceholderAPI-плейсхолдеры:

Код: 
%vault_prefix%
%player_name%
%luckperms_prefix%

Например, стандартный конфиг уже использует:

Код: 
%vault_prefix%

Если вы хотите использовать такие плейсхолдеры, установите PlaceholderAPI и нужные expansions.


MiniMessage и цвета

Сообщения и формат чата используют MiniMessage.

Можно использовать:

  • HEX-цвета;
  • градиенты;
  • жирный текст;
  • подчёркивание;
  • разные стили;
  • цветные префиксы;
  • красивую подсветку пингов.

Пример формата:

Код: 
<#FDBE00>ᴄʟᴀɴ <gray>(<#FDBE00>{clan}<gray>) <dark_gray>| <white>{player} <dark_gray>» <gray>{message}

По умолчанию игроки не могут использовать MiniMessage-теги в своих сообщениях. Это можно включить настройкой:

Код: 
settings.chat.allowColorsInMessages: true


Права управления

hClansChatAddon использует систему прав hClans.

По умолчанию регистрируется клановое право:

Код: 
hclanschat.manage

Это право отвечает за управление состоянием кланового чата.

Игроки с этим правом могут:

  • включать клановый чат командой /clan chat on;
  • выключать клановый чат командой /clan chat off;
  • писать в клановый чат, когда он выключен.

Также в конфиге есть настройка:

Код: 
settings.permissions.manage.ownerAlwaysAllowed: true

Если она включена, владелец клана всегда может управлять клановым чатом.


Хранение данных

Аддон использует database API из hClans и не требует отдельной настройки базы данных.

Сохраняются:

  • включён или выключен клановый чат у конкретного клана;
  • включено или выключено получение кланового чата у конкретного игрока.

Используются таблицы:

Код: 
chat_clan_states
chat_player_states

Запись выполняется асинхронно, чтобы не блокировать основной поток сервера.

При удалении клана состояние его кланового чата очищается автоматически.


Команды

Код: 
/clan chat

В режиме MESSAGE показывает подсказку по использованию.
В режиме TOGGLE включает или выключает перенаправление обычного чата в клановый.

Код: 
/clan chat <сообщение>

Отправить разовое сообщение в клановый чат.

Код: 
/clan chat on

Включить клановый чат для клана.

Код: 
/clan chat off

Выключить клановый чат для клана.

Код: 
/clan chat toggle

Включить или выключить личное получение кланового чата.

Дополнительные алиасы для сабкоманды можно задать в конфиге:

Код: 
settings.command.aliases


Что можно настроить?

  • префикс сообщений;
  • видимость команды в tab-complete;
  • режим команды MESSAGE или TOGGLE;
  • алиасы сабкоманды;
  • алиасы включения чата;
  • алиасы выключения чата;
  • алиасы личного toggle;
  • включён ли клановый чат по умолчанию;
  • могут ли видеть выключенный чат только управляющие роли;
  • разрешены ли MiniMessage-теги в сообщениях игроков;
  • формат кланового сообщения;
  • получает ли игрок клановый чат по умолчанию;
  • включены ли пинги;
  • показывать ли офлайн-участников в подсказках;
  • префикс упоминания;
  • формат подсветки упоминания;
  • звук при пинге;
  • громкость и pitch звука;
  • право управления клановым чатом;
  • всегда ли владелец может управлять чатом;
  • все сообщения об ошибках и действиях;
  • сообщения при включении и выключении кланового чата;
  • сообщения при включении и выключении личного получения;
  • сообщения при включении и выключении route-режима.


Зависимости

Обязательные:

  • Java 21
  • Paper/Purpur 1.21.x
  • hClans совместимая версия

Опционально:

  • PlaceholderAPI — если хотите использовать PAPI-плейсхолдеры в формате кланового чата.
  • Vault / LuckPerms expansions для PlaceholderAPI — если используете плейсхолдеры вроде %vault_prefix% или %luckperms_prefix%.

Важно: аддон использует Paper AsyncChatEvent, поэтому обычный Spigot лучше не указывать как поддерживаемую платформу.
Команды и права
Выше все написано
Автор
He3HaukaX
Просмотры
32
Первый выпуск
Обновление
Оценка
0.00 звёзд 0 оценок
Обсудить ресурс Дополнительная информация Получить поддержку

Другие ресурсы пользователя He3HaukaX

Поделиться ресурсом

Назад
Сверху Снизу