Chat Interactions Plugin

Various commands and interactions with the chat

199.0 загрузок

Обновлён 9 дней назад

Улучшение Качества Жизни Разное Утилиты

Скачать последнюю версию (57.4 КБ)

Описание

Чат взаимодействия Плагин

Плагин Chat для Hytale Глобальный / локальный чат, Частные сообщения, Административные инструментыА. Настраиваемый локальный радиус чатаАн Факультативный режим блокировки чата (дополнительный список) и Настраиваемое периодическое предупреждение в режиме чата.

Требования (зависимости)

Чат-взаимодействия иметь Не требуются зависимости Бежать.
TinyMessage / TinyMsg (необязательно) При установке он позволяет Лучшие цвета и форматирование в чате. Просто брось. крошечное сообщение*.jar в модс/.

Особенности

Глобальные и локальные каналы чата
Местный чат фильтруется расстояние (один и тот же мир)
Частные сообщения с /msg (Послание полностью розовый). Частные сообщения могут быть отключены через /chatdisable msg.
Административный приказ Очистить чат (глобальный + локальный)
Административный приказ Проверка / отладка переменных чата (режим, замки, админ/оп, предупреждение, пинг)
Установка локального радиуса только администратором (сохраняется после перезапуска)
Пер-канал отключить чат: /chatdisable global |local |msg (alias: /cdb)
Список разрешений Chat AdminТолько ChatAdmins могут говорить, когда чат отключен; они также могут использовать чат-инвалид и Предупреждение (даже без админ/оп)
Периодическое предупреждение в чат-режиме (для игрока):
- Отправляет личное напоминание игроку, находятся ли они в Локальный или Глобал
- Полностью окрашенный при установке TinyMessage/TinyMsg
- Чистый обратный текст, когда TinyMessage отсутствует
- Конфигурируемый интервал (или отключенный) Предупреждение / /кв
Поддержка TinyMessage/TinyMsg для улучшения цвета/форматирования

установка

Создайте плагин и получите сгенерированный .джар.
Переместить плагин .джар к:
- модс/
(необязательно, рекомендуется) Установите TinyMessage/TinyMsg:
- Двигаться крошечное сообщение*.jar то модс/
Перезагрузите сервер.

С установкой TinyMessage/TinyMsg цвета чата и форматирование выглядят лучше.

Как это работает

Когда игрок присоединяется, его канал чата по умолчанию местный.

Местный чат Доставляется только игрокам:
- в Тот же мир
- внутри сконфигурированного радиус (в блоках)

Когда чат отключен через /chatdisable global |local |msg (alias: /cdbТолько ChatAdmins может отправлять сообщения для этого канала (Global/Local/Msg).
/chatdisable msg блокирует только личные сообщения/msg).
Важное примечание по безопасности: чат-инвалид ()/cdb) требует Admin/Op (консоль разрешена). ChatAdmins также может выполнять его без администратора.
Периодическое предупреждение чата (необязательно):
- Каждый игрок может получить Частное напоминание Сообщение каждые X минут.
- ChatAdmins может изменить интервал или отключить его с помощью /cw <minutes> Даже без админ/оп. Admins/Ops также может выполнять его.

]

"Мини" учебник

командование

Все (без разрешения)

г
- Переключает вас на глобальный Чат-канал.
/л
- Переключает вас на местный чат-канал (дистанционный).
/msg <player> <message...>
- Отправляет a частное сообщение другому игроку (полностью) розовый).
- Пример: /msg плеер2 Привет, как дела?

Команды персонала (Admin/Op; консоль разрешена)

Все команды ниже требуют Admin/Op, если не указано. ChatAdmins можно использовать чат-инвалид и Предупреждение Даже без админ/оп.

/localradius <число
- Только администратор/оп.
- Установить Местный чат В кварталах.
- Дефолт есть 50.
- Эта ценность является Сохраненный/постоянный После перезапуска.
- Пример: /localradius 80
/clearchat
- Только администратор/оп.
- Очистка игрового чата для всех онлайн-игроковГлобальный и локальный).
- Алиас: смс
/chatbug
- Дисплей Отладка информации / переменные связанный с серверным чатом (полезный для проверки текущих настроек/состояния).
- Алиас: /cdg
/chatdisable global |local |msg
- Закрытие чата по каналам (глобальные, локальные или частные сообщения).
- Используется Admin/Op или ChatAdmin.
- Алиас: /cdb
- Примеры: /chat-инвалидный глобальный, /chat-инвалидный местный, /chatdisable msg
/chatadmin
- Только админ/оп (консоль разрешена).
- Управляющий Список разрешений Chat Admin (Игроки, которые могут говорить во время чата, отключены).
- Варианты:
- /chatadmin add (<Player> или <UUID>)
- Добавляет чат-админ разрешение выбранному игроку (разрешает говорить, даже если чат отключен).
- Пример: /chatadmin Добавить имя игрока
- Пример: /chatadmin add 123e4567-e89b-12d3-a456-426614174000
- /chatadmin remove (<Player> или <UUID>)
- Удалите разрешение чат-администратора от выбранного игрока.
- /chatadmin список
- Список всех игроков (и их UUID), которые в настоящее время имеют разрешение чат-администратора.
/chatwarning <minds>
- Выполняемые Admin/Op и ChatAdmins (чатадмины не нуждаются в админ/op).
- Конфигурирует Периодическое предупреждение чат-режима (Частное напоминание).
- <Минуты> Это интервал в минутах.
- Использовать 0 то отключать Предупреждение.
- Алиас: /кв
- Примеры:
- /cw 5 (отправлять каждые 5 минут)
- /cw 0 (отключен)

Разрешения / Доступ

Этот плагин использует эти уровни доступа:

Все (нулевое разрешение):
- г, /л, /msg
Admin/Op (и консоль):
- Требуется для всех остальных команд
ChatAdmin (допускной список):
- Можно использовать чат-инвалид ()/cdb) и Предупреждение ()/кв) даже без админ/оп
- Только ChatAdmins может говорить, когда чат отключен.

Дополнительно:

Chat Admin (дополнительный список) Управляется через /chatadmin add/move/list.

Настойчивость (Local Radius / Chat Admins / Warning Interval)

Настройки сохраняются в файле конфигурации и сохраняются после перезагрузки.

Путь по умолчанию: ./plugins/com.example_ChatInteractions/localglobalchat.properties

Пример хранимых ключей:

Местный Радиус = 50
chatAdmins=<uuid1>,<uuid2>,...
Обсуждение WarningMinutes=5

Заметки

Локальный фильтр чата:
- Тот же мир
- Расстояние ≤ сконфигурированный радиус
Плагин автоматически использует TinyMsg при установке (иначе используется чистый простой текст).

Показать оригинальное описание (English)

Chat Interactions Plugin

Chat plugin for Hytale featuring Global/Local chat, private messaging, admin tools, a configurable local chat radius, an optional chat lockdown mode (allowlist), and a configurable periodic chat-mode warning.

Requirements (Dependencies)

ChatInteractions has no required dependencies to run.
TinyMessage / TinyMsg (Optional) If installed, it enables better colors and formatting in chat. Just drop tinymessage-*.jar into mods/.

Features

Global and Local chat channels
Local chat filtered by distance radius (same world)
Private messages with /msg (message is fully pink). Private messages can be disabled via /chatdisable msg.
Admin command to clear the chat (Global + Local)
Admin command to inspect/debug chat variables (mode, locks, admin/op, warning, ping)
Admin-only local radius setting (persists after restart)
Per-channel chat disable: /chatdisable global|local|msg (alias: /cdb)
Chat Admin allowlist: only ChatAdmins can talk while chat is disabled; they can also use /chatdisable and /chatwarning (even without admin/op)
Periodic chat-mode warning (per-player):
- Sends a private reminder telling the player whether they are in LOCAL or GLOBAL
- Fully colored when TinyMessage/TinyMsg is installed
- Clean plain-text fallback when TinyMessage is not present
- Configurable interval (or disabled) via /chatwarning / /cw
Optional TinyMessage/TinyMsg support for better colors/formatting

Installation

Build the plugin and get the generated .jar.
Move the plugin .jar to:
- mods/
(Optional, recommended) Install TinyMessage/TinyMsg:
- Move tinymessage-*.jar to mods/
Restart the server.

With TinyMessage/TinyMsg installed, chat colors and formatting look better.

How It Works

When a player joins, their default chat channel is Local.

Local chat is only delivered to players:
- in the same world
- within the configured radius (in blocks)

When chat is disabled via /chatdisable global|local|msg (alias: /cdb), only ChatAdmins can send messages for that channel (Global/Local/Msg).
/chatdisable msg blocks only private messages (/msg).
Important security note: /chatdisable (/cdb) requires Admin/Op (console allowed). ChatAdmins can also execute it without admin/op.
Periodic chat warning (optional):
- Each player can receive a private reminder message every X minutes.
- ChatAdmins can change the interval or disable it using /cw <minutes> even without admin/op. Admins/Ops can also execute it.

]

"Mini" Tutorial

Commands

Everyone (no permission required)

/g
- Switches you to the Global chat channel.
/l
- Switches you to the Local chat channel (distance-based).
/msg <player> <message...>
- Sends a private message to another player (fully pink).
- Example: /msg player2 hi how are you?

Staff commands (Admin/Op; console allowed)

All commands below require Admin/Op unless noted. ChatAdmins can also use /chatdisable and /chatwarning even without admin/op.

/localradius <number>
- Admin/Op only.
- Sets the Local chat radius in blocks.
- Default is 50.
- This value is saved/persistent after restart.
- Example: /localradius 80
/clearchat
- Admin/Op only.
- Clears the game chat for all online players (Global + Local).
- Alias: /cc
/chatdebug
- Displays debug information / variables related to the server chat (useful for verifying current settings/state).
- Alias: /cdg
/chatdisable global|local|msg
- Toggles chat lockdown per channel (Global, Local, or private messages).
- Usable by Admin/Op or ChatAdmin.
- Alias: /cdb
- Examples: /chatdisable global, /chatdisable local, /chatdisable msg
/chatadmin
- Admin/Op only (console allowed).
- Manages the Chat Admin allowlist (players who can talk while chat is disabled).
- Variants:
- /chatadmin add (<Player> or <UUID>)
- Adds chat-admin permission to the chosen player (allow to talk even if chat is disabled).
- Example: /chatadmin add PlayerName
- Example: /chatadmin add 123e4567-e89b-12d3-a456-426614174000
- /chatadmin remove (<Player> or <UUID>)
- Removes chat-admin permission from the chosen player.
- /chatadmin list
- Lists all players (and their UUIDs) who currently have chat-admin permission.
/chatwarning <minutes>
- Executable by Admin/Op and ChatAdmins (chatadmins do not need admin/op).
- Configures the periodic chat-mode warning (private reminder).
- <minutes> is the interval in minutes.
- Use 0 to disable the warning.
- Alias: /cw
- Examples:
- /cw 5 (send every 5 minutes)
- /cw 0 (disable)

Permissions / Access

This plugin uses these access levels:

Everyone (permission zero):
- /g, /l, /msg
Admin/Op (and console):
- Required for all other commands
ChatAdmin (allowlist):
- Can use /chatdisable (/cdb) and /chatwarning (/cw) even without admin/op
- Only ChatAdmins can talk when chat is disabled

Additionally:

Chat Admin (allowlist) is managed via /chatadmin add/remove/list.

Persistence (Local Radius / Chat Admins / Warning Interval)

Settings are saved to a config file and persist after a restart.

Default fallback path: ./plugins/com.example_ChatInteractions/localglobalchat.properties

Stored keys example:

localRadius=50
chatAdmins=<uuid1>,<uuid2>,...
chatWarningMinutes=5

Notes

Local chat filtering:
- Same world
- Distance ≤ configured radius
The plugin automatically uses TinyMsg if installed (otherwise clean plain text is used).