CladeWelcome - Описание проекта

Общая информация

CladeWelcome - это плагин для Minecraft серверов (Paper/Spigot/Purpur), который предоставляет расширенную систему приветственных сообщений для игроков при входе и выходе с сервера.

- Версия: 1.0.0.0.a
- Автор: Vunlior
- Язык разработки: Java 17
- Поддерживаемые версии Minecraft: 1.17.x - 1.21.x
- Система сборки: Maven

Основные функции

1. Система сообщений
- Кастомные сообщения входа/выхода с поддержкой плейсхолдеров
- Группы сообщений на основе прав (admin, op, default)
- Случайный выбор из списка сообщений для каждого события
- Поддержка многоязычности (10 языков: en, ru, uz, de, es, tr, fr, pl, pt, it)

2. Визуальные эффекты
- Звуковые эффекты при входе игроков
- Subtitles (подзаголовки) с настраиваемой задержкой
- ActionBar сообщения с настраиваемой длительностью
- BossBar с настраиваемым цветом и стилем
- Фейерверки при первом входе игрока

3. Информационная панель
- Отображение информации о сервере при входе
- Показывает ранг игрока, количество онлайн, текущее время
- Возможность отключения для OP и админов

4. Интеграции
- PlaceholderAPI (опционально) для расширенных плейсхолдеров
- Adventure API для современного форматирования текста
- Проверка обновлений через Modrinth

5. Управление
- Команда `/cw` для управления плагином
- Подкоманды:
- `/cw help` - справка
- `/cw reload` - перезагрузка конфигурации
- `/cw lang <язык>` - смена языка
- `/cw status` - статус плагина
- `/cw toggle` - включение/выключение сообщений входа для себя

6. Система разрешений
- `cladewelcome.admin` - административные команды
- `cladewelcome.reload` - перезагрузка плагина
- `cladewelcome.lang` - смена языка
- `cladewelcome.status` - просмотр статуса
- `cladewelcome.op` - сообщения для OP
- `cladewelcome.default` - сообщения по умолчанию
- `cladewelcome.toggle` - отключение сообщений для себя

Технические особенности

Конфигурация
- config.yml - основная конфигурация плагина
- lang/*.yml - файлы локализации

Зависимости
- PlaceholderAPI (опционально)
- Apache Commons Lang3 (для исправления уязвимостей)

Конфигурируемые параметры

Сообщения (messages)
- Включение/выключение сообщений входа/выхода

Звуки (sounds)
- Включение/выключение звуковых эффектов

Subtitle (subtitle)
- Включение/выключение подзаголовков
- Задержка отображения

ActionBar (actionbar)
- Включение/выключение
- Длительность отображения

BossBar (bossbar)
- Включение/выключение
- Цвет (BLUE, RED, GREEN, etc.)
- Стиль (SOLID, SEGMENTED, etc.)
- Длительность отображения

Фейерверки при первом входе (first-join-firework)
- Включение/выключение

Информационная панель (info-panel)
- Включение/выключение
- Отключение для OP
- Отключение для админов

Проверка обновлений (update-check)
- Включение/выключение автоматической проверки

Статистика (stats)
- Счётчик уникальных входов

Поддерживаемые плейсхолдеры

- `%player%` - имя игрока
- `%ping%` - пинг игрока
- `%online%` - количество игроков онлайн
- `%unique%` - номер уникального входа
- `%rank%` - ранг игрока
- `%time%` - текущее время
- `%version%` - версия плагина
- `%lang%` - текущий язык
- И любые плейсхолдеры PlaceholderAPI (если установлен)

Ссылки на скачивание
- Modrinth: https://modrinth.com/project/oAd9YfsP
- Hangar: https://hangar.papermc.io/Vunlior/CladeWelcome
- SpigotMC: https://www.spigotmc.org/resources/cladewelcome.135054/

Особенности реализации

1. Асинхронная загрузка - языки и конфигурация загружаются асинхронно
2. Поддержка legacy и modern - автоматическое определение и использование Adventure API или legacy методов
3. Кроссплатформенность - работа на Paper, Spigot и Purpur
4. Оптимизация - использование ConcurrentHashMap для потокобезопасности
5. Кастомные события - PlayerWelcomeEvent для интеграции с другими плагинами
6. Система мута - игроки могут отключать сообщения входа для себя

Требования к системе

- Java: 17 или выше
- Minecraft Server: Paper, Spigot или Purpur 1.17.x - 1.21.x
- Память: Минимальные требования (плагин лёгкий)

Лицензия и права

Проект разработан Vunlior и распространяется через популярные платформы для Minecraft плагинов. (Apache-2.0)