LoChat/TODO.md

🚀 Loki Plugins - TODO

📦 Проекты

1. LoChat - Чат плагин (Paper/Folia)

Статус: ✅ Готов к использованию

Функции

• ✅ Глобальный/локальный чат
• ✅ PM система с игнором
• ✅ Мут система с историей
• ✅ Фильтры (мат, спам, CAPS)
• ✅ Градиентные ники (LuckPerms интеграция)
• ✅ Смайлики (300+ эмодзи)
• ✅ PlaceholderAPI
• ✅ Markdown форматирование (bold, italic, strike, code)
• ✅ Упоминания (@player, @everyone, @here, @role:permission)
• ✅ Фильтры URL/IP/повторов

---

2. LoHub - Hub плагин (Paper/Folia)

Статус: 🔄 В разработке (21% готово)

✅ Готово

• ✅ Spawn система с телепортом
• ✅ WorldGuard регионы (авто-создание)
• ✅ Защита мира (блоки, PvP, мобы)
• ✅ Команды /hub, /sethub, /lohub
• ✅ Базовые утилиты (ItemBuilder, TextUtil, PlaceholderUtil)

🔄 В работе - ЭТАП 2: Action система

• Action интерфейс и ActionType enum
• MessageAction - отправка сообщений
• SoundAction - звуки
• TitleAction - title/subtitle
• CommandAction - команды от игрока
• ConsoleAction - команды от консоли
• GamemodeAction - смена режима
• EffectAction - эффекты
• ActionManager - парсинг и выполнение

📋 Запланировано

ЭТАП 3: Join система

• PlayerJoinListener
• Телепорт на спавн при входе
• Хил и очистка эффектов
• Кастомные сообщения входа/выхода
• Интеграция с Action системой

ЭТАП 4: Custom Join Items

• HotbarManager
• Выдача предметов при входе
• Обработка кликов (actions)
• Защита от выбрасывания

ЭТАП 5: Launchpad

• LaunchpadListener
• Прыжковые площадки (плита + редстоун)

ЭТАП 6: Double Jump

• DoubleJumpListener
• CooldownManager
• Двойной прыжок в воздухе

ЭТАП 7: Player Hider

• PlayerHiderManager
• Скрытие/показ игроков
• Предмет для переключения

ЭТАП 8-10: Опционально

• Scoreboard модуль
• Tablist модуль
• Announcements модуль

---

3. LoVelocity - Velocity плагин

Статус: ✅ Готов

Функции

• ✅ Команда /hub для телепорта на lobby/hub сервер
• ✅ Кастомные сообщения
• ✅ Поддержка PlaceholderAPI

---

🏗️ Структура проекта

LoChat/                          # Root проекта
├── src/main/                    # LoChat (основной модуль)
│   ├── java/com/loki/lochat/
│   │   ├── api/                 # API интерфейсы
│   │   ├── commands/            # Команды
│   │   ├── config/              # Конфигурация
│   │   ├── core/                # Реализации
│   │   ├── gradient/            # Градиентные ники
│   │   ├── listener/            # Слушатели событий
│   │   ├── utils/               # Утилиты
│   │   └── LoChat.java          # Главный класс
│   └── resources/               # Конфиги
│
├── lohub/                       # LoHub модуль
│   ├── src/main/
│   │   ├── java/com/loki/lohub/
│   │   │   ├── actions/         # Action система
│   │   │   ├── commands/        # Команды
│   │   │   ├── config/          # Конфигурация
│   │   │   ├── listeners/       # Слушатели
│   │   │   ├── managers/        # Менеджеры
│   │   │   ├── utils/           # Утилиты
│   │   │   └── LoHub.java       # Главный класс
│   │   └── resources/           # Конфиги
│   └── build.gradle.kts         # Gradle конфиг
│
├── lovelocity/                  # LoVelocity модуль
│   ├── src/main/
│   │   └── java/com/loki/lovelocity/
│   └── build.gradle.kts         # Gradle конфиг
│
├── build.gradle.kts             # Root Gradle (Kotlin DSL)
├── settings.gradle.kts          # Настройки проектов
└── TODO.md                      # Этот файл

---

🎯 Текущий фокус

LoHub - ЭТАП 2: Action система

Создание гибкой системы действий для настройки поведения через конфиг:

actions:
  - "[MESSAGE] &aПривет, %player%!"
  - "[SOUND] ENTITY_PLAYER_LEVELUP"
  - "[TITLE] &b&lДобро пожаловать;&fНа сервер;1;3;1"
  - "[COMMAND] spawn"
  - "[CONSOLE] give %player% diamond 1"
  - "[GAMEMODE] survival"
  - "[EFFECT] SPEED;1"

---

📝 Правила разработки

1. Никакого русского текста в Java файлах - только в конфигах
2. Цвета только в формате &#RRGGBB - унифицированный стиль
3. SOLID принципы - чистая архитектура
4. Классы до 100-150 строк - читаемость кода
5. Gradle Kotlin DSL - современный подход
6. Без лишних MD файлов - только TODO.md и docs/

---

🔧 Технологии

• Java 17+
• Paper API 1.20.1
• Velocity API 3.3.0
• Gradle 9.1+ (Kotlin DSL)
• WorldGuard 7.0.9
• PlaceholderAPI 2.11.6
• LuckPerms API