No description
Find a file
2026-02-23 14:11:30 +01:00
.gitea/workflows Fix: use token for git clone 2025-12-29 15:19:18 +01:00
bin refactor: Remove all legacy managers, complete SOLID migration 2026-02-23 12:17:37 +01:00
gradle/wrapper Initial commit: LoChat v1.0.0 with Gradient module 2025-12-29 14:57:49 +01:00
src fix: Use correct placeholder format {prefix} {player} {message} instead of angle brackets 2026-02-23 14:11:30 +01:00
.gitignore Initial commit: LoChat v1.0.0 with Gradient module 2025-12-29 14:57:49 +01:00
496 refactor: Remove all legacy managers, complete SOLID migration 2026-02-23 12:17:37 +01:00
build.gradle refactor: Remove emoji system and chat filters, implement SOLID architecture 2026-02-23 12:10:51 +01:00
CLEANUP_REPORT.md refactor: Remove all legacy managers, complete SOLID migration 2026-02-23 12:17:37 +01:00
gradle.properties v1.5.0: Добавлены кастомные команды, алиасы, цвета чата, многоядерная сборка 2025-12-30 12:29:39 +01:00
gradlew Initial commit: LoChat v1.0.0 with Gradient module 2025-12-29 14:57:49 +01:00
gradlew.bat Initial commit: LoChat v1.0.0 with Gradient module 2025-12-29 14:57:49 +01:00
README.md Complete config redesign and feature additions 2026-01-23 22:06:46 +01:00
REFACTORING_PLAN.md refactor: Remove emoji system and chat filters, implement SOLID architecture 2026-02-23 12:10:51 +01:00
settings.gradle Initial commit: LoChat v1.0.0 with Gradient module 2025-12-29 14:57:49 +01:00
temp_methods.txt Fix TextDisplayManager: Add hide/show methods for sneak functionality 2026-01-01 23:21:36 +01:00
TODO.md docs: update TODO.md with completed features 2025-12-30 21:19:39 +01:00

LoChat

Продвинутый чат-плагин для Minecraft Paper 1.20.1 с интегрированным модулем градиентных ников

Автор: loki
Версия: 1.5.5-1.20.1


🚀 Установка

  1. Скачайте LoChat-1.5.5-1.20.1.jar из папки build/libs/
  2. Поместите файл в папку plugins/ вашего сервера
  3. Перезапустите сервер
  4. Настройте конфигурацию в файлах config.yml и других

✨ Основной функционал

💬 Система чата

  • Глобальный чат - !сообщение или /g <сообщение>
  • Локальный чат - радиус 100 блоков (настраивается)
  • Личные сообщения - /msg, /reply с поддержкой игнорирования
  • Автосообщения - многострочные сообщения с настраиваемым порядком
  • Смайлики - 200+ эмодзи для украшения сообщений

🛡️ Модерация

  • Система мутов - /lmute, /lunmute с поддержкой времени и причин
  • Фильтр мата - умная система с обходом символов (censor/block/warn)
  • Анти-спам - защита от CAPS, повторов и похожих сообщений
  • Кулдауны - настраиваемые задержки между сообщениями
  • Шпион режим - /chatspy для мониторинга всех сообщений
  • Очистка чата - /clearchat с настраиваемым сообщением

🌈 Градиентные ники (встроенный LoPreff)

  • Кастомные градиенты - /color <hex1> [hex2] ... до 7 цветов
  • Кастомные префиксы - /prefix <текст> с поддержкой цветов
  • Предустановки - fire, ocean, forest, sunset, rainbow и другие
  • Интеграция с LuckPerms - автоматическое обновление префиксов
  • Покупка за PlayerPoints - опциональная система оплаты
  • GUI подтверждения - красивый интерфейс для покупок

🎭 Дополнительные возможности

  • Головы игроков - :head_nickname: и @head nickname в чате
  • Кастомные команды - создание собственных команд через конфиг
  • Упоминания - @nickname с звуковыми уведомлениями
  • Интеграция с SkinsRestorer - поддержка кастомных скинов

📋 Команды

Чат

Команда Описание Право
!<сообщение> Глобальный чат chat.global.use
/g <сообщение> Глобальный чат chat.global.use
/globalchat toggle Переключить глобальный чат chat.global.toggle
/l <сообщение> Локальный чат chat.local.use
/msg <ник> <сообщение> Личное сообщение chat.pm.use
/reply <сообщение> Ответить на последнее PM chat.pm.use
/ignore <ник> Добавить в игнор chat.pm.ignore
/unignore <ник> Убрать из игнора chat.pm.ignore
/announce <сообщение> Объявление chat.announce.use

Модерация

Команда Описание Право
/chatspy Включить/выключить шпион режим chat.spy
/clearchat Очистить чат chat.clear
/clearchatconfig <действие> Настроить сообщение очистки lochat.clearchat.config
/lmute <ник> [время] [-s] [причина] Замутить игрока lochat.mute
/lunmute <ник> [-s] Размутить игрока lochat.unmute
/lmutelist Список замученных lochat.mutelist
/lmutehistory <ник> История мутов игрока lochat.mutehistory
/lmuteblame <модератор> Муты выданные модератором lochat.muteblame

Градиентные ники

Команда Описание Право
/color <hex1> [hex2] ... Установить градиент gradient.color
/color on/off/reset Управление градиентом gradient.color
/color copy <ник> Скопировать градиент gradient.color
/color preset <название> Использовать предустановку gradient.color
/prefix <текст> Установить префикс gradient.prefix
/prefix on/off/reset Управление префиксом gradient.prefix

Админские команды

Команда Описание Право
/lochat reload Перезагрузить конфиг lochat.admin
/aprefix <подкоманда> Админские команды градиентов gradient.admin

🔐 Права доступа

Чат

Право По умолчанию Описание
chat.global.use true Использование глобального чата
chat.global.toggle true Переключение глобального чата
chat.local.use true Использование локального чата
chat.pm.use true Личные сообщения
chat.pm.ignore true Игнорирование игроков
chat.mention.use true Упоминания @nickname

Модерация

Право По умолчанию Описание
chat.announce.use op Объявления
chat.spy op Шпион режим
chat.clear op Очистка чата
chat.bypass.cooldown op Обход кулдаунов
chat.bypass.filter op Обход фильтра мата
chat.bypass.antispam op Обход анти-спама
lochat.mute op Выдача мутов
lochat.unmute op Снятие мутов
lochat.clearchat.config op Настройка очистки чата

Градиенты

Право По умолчанию Описание
gradient.color true Градиентные ники
gradient.prefix true Кастомные префиксы
gradient.admin op Админские команды
gradient.bypass.cooldown op Обход кулдаунов
gradient.bypass.cost op Бесплатные градиенты

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

Право По умолчанию Описание
lochat.heademoji.use true Головы игроков в чате
lochat.admin op Админские команды

🎨 PlaceholderAPI

Основные плейсхолдеры

%lochat_muted%           — замучен (true/false)
%lochat_mute_time%       — оставшееся время мута
%lochat_mute_reason%     — причина мута
%lochat_ignored_count%   — количество игнорируемых
%lochat_global_enabled%  — глобальный чат включен
%lochat_spy_enabled%     — шпион режим включен

Градиентные плейсхолдеры

%lochat_gradient_full%   — полное имя (префикс + ник)
%lochat_gradient_name%   — только градиентный ник
%lochat_gradient_prefix% — только префикс
%lochat_full%            — алиас для gradient_full
%lochat_name%            — алиас для gradient_name
%lochat_prefix%          — алиас для gradient_prefix

📁 Конфигурационные файлы

Файл Описание
config.yml Основные настройки плагина
messages.yml Сообщения плагина
automessages.yml Настройки автосообщений
emojis.yml Список смайликов
custom-commands.yml Кастомные команды
gradient-config.yml Настройки градиентов
gradient-messages.yml Сообщения градиентного модуля
ignores.yml Сохранённые игноры (создается автоматически)
mutes.yml Активные муты (создается автоматически)
gradient-data.yml Данные градиентов (создается автоматически)

🎯 Кастомные команды

LoChat позволяет создавать собственные команды через custom-commands.yml. После изменения файла выполните /lochat reload.

Структура команды

command-name:
  permission: "право.для.использования"  # Опционально
  message: "Текст сообщения"             # Обязательно
  aliases: ["alias1", "alias2"]          # Опционально
  type: "chat"                           # chat, broadcast, title, actionbar
  target: "sender"                       # sender, all, permission:право

Типы команд

  • chat — отправляет сообщение в чат
  • broadcast — отправляет сообщение всем игрокам
  • title — показывает title (разделение строк через \n)
  • actionbar — показывает сообщение в actionbar

Целевая аудитория

  • sender — только отправителю команды
  • all — всем игрокам на сервере
  • permission:право — только игрокам с указанным правом

Плейсхолдеры в командах

  • {player} — имя игрока
  • {x}, {y}, {z} — координаты игрока
  • {world} — название мира
  • {arg0}, {arg1}, {arg2} — аргументы команды
  • {args} — все аргументы через пробел
  • Все плейсхолдеры PlaceholderAPI

🎭 Головы игроков

Использование

  • :head_nickname: — показать ASCII голову игрока
  • @head nickname — показать интерактивную голову с информацией

Требования

  • Право lochat.heademoji.use
  • Включенная настройка head-emoji.enabled: true

🎨 Форматирование цветов

MiniMessage (рекомендуется)

<red>Красный текст</red>
<gradient:red:blue>Градиент от красного к синему</gradient>
<rainbow>Радужный текст</rainbow>
<bold>Жирный</bold>
<italic>Курсив</italic>

HEX цвета

<#FF0000>Красный через HEX</color>
<gradient:#FF0000:#0000FF>HEX градиент</gradient>

Legacy коды (поддерживаются)

&cКрасный
&aЗеленый
&lЖирный
&nПодчеркнутый

🔧 Требования

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

  • Paper 1.20.1 или новее
  • Java 21

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

  • PlaceholderAPI — для плейсхолдеров
  • PlayerPoints — для покупки градиентов за поинты
  • LuckPerms — для интеграции с префиксами
  • SkinsRestorer — для поддержки кастомных скинов
  • LibertyBans — для интеграции с банами

🏗️ Сборка

./gradlew clean build

Готовый jar файл: build/libs/LoChat-1.5.5-1.20.1.jar


📝 Changelog

v1.5.5-1.20.1

  • ✅ Адаптация для Minecraft 1.20.1 Paper
  • ✅ Исправлен фильтр мата с поддержкой обходов
  • ✅ Исправлена команда spy для мониторинга всех сообщений
  • ✅ Добавлена поддержка голов игроков в чате
  • ✅ Добавлена команда настройки сообщения очистки чата
  • ✅ Интеграция с SkinsRestorer
  • ✅ Улучшено качество кода (SOLID, DRY, KISS)
  • ✅ Обновлены все конфиги в едином стиле
  • ✅ Исправлены все предупреждения компилятора

🤝 Поддержка

Если у вас возникли проблемы или вопросы:

  1. Проверьте конфигурационные файлы
  2. Убедитесь в совместимости версий
  3. Проверьте права доступа игроков
  4. Создайте issue в репозитории

© 2024 loki. Все права защищены.