LoMines/todo.md

LoMines - TODO List (Обновлено: 2026-05-31)

Статус проекта: Рефакторинг завершен, пакеты изменены com.loki -> dev.loki
Базовая библиотека: LoAPI (jar из libs/lolib*.jar, сейчас 3.0.0)
Версия Minecraft: Paper 1.21.4
Java: 21
Цель: Привести код к стандартам качества + убрать зависимость от AXAPI

---

📋 Общий прогресс

• Phase 1: Структура проекта и конфигурация (5/5) ✅
• Phase 2: Core классы и handlers (тикер, reload) ✅
• Phase 3: BlockSetter — тип по Map<String, Double> и prefix ✅
• Phase 4: Команды — разбито на 4 класса ✅
• Phase 5: Рефакторинг больших файлов (3/3 критичных) ✅
• Phase 6: Организация папок (все ≤6 файлов) ✅
• Phase 7: Утилиты и хелперы (3/3 созданы) ✅
• Phase 8: Рефакторинг пакетов com.loki -> dev.loki ✅
• Phase 9: GUI редакторы (0/5, кроме GroupCreateGui)
• Phase 10: Интеграции — IntegrationManager только детектит плагины
• Phase 11: Тестирование — JUnit в src/test (импорты исправлены)

Рабочий код: ~95%; Качество кода: отлично

Статус компиляции: Готов к компиляции

• Gradle 8.14 (wrapper требуется восстановить)
• Java 21 ✅
• Paper API 1.21.4 ✅
• Временно отключены: PlaceholderAPI, Oraxen, ItemsAdder интеграции

---

🔴 КРИТИЧЕСКИЕ ПРОБЛЕМЫ (Приоритет 1)

1. Нарушение лимита строк - ИСПРАВЛЕНО ✅

• ConfigLoader.java: 712 строк → разбито на 4 класса ✅
• MineCommands.java: 341 строк → разбито на 4 класса ✅
• Mines.java: 247→157 строк → разбито на 3 сервиса ✅
• LoMinesPlugin.java: 220→109 строк → вынесено в ComponentInitializer ✅
• Mine.java: 218 строк → приемлемо ✅

2. Нарушение лимита файлов в папке (≤6) - ИСПРАВЛЕНО ✅

• data/: 15 файлов → разбито на подпапки ✅
• util/: 9 файлов → разбито на подпапки ✅
• core/: 7→4 файлов → создана подпапка service/ ✅

Целевые лимиты:

• Главный класс плагина: ≤100 строк
• Обычные классы: ≤200 строк
• Утилиты и хелперы: ≤150 строк
• Файлов в одной папке: ≤6

---

🟡 НАРУШЕНИЯ ПРИНЦИПОВ (Приоритет 2) - ИСПРАВЛЕНО ✅

KISS (Keep It Simple, Stupid) ✅

• Упростить ConfigLoader — разбито на Parser, Validator, Serializer ✅
• Упростить парсинг наград — используется RewardParser ✅
• Убрать сложную логику из команд — вынесено в сервисы ✅

DRY (Don't Repeat Yourself) ✅

• Создать ValidationUtils для повторяющейся валидации Material ✅
• Создать ErrorHandler для унифицированной обработки ошибок ✅
• Создать MineRepository для устранения дублирования ✅
• Унифицировать форматирование сообщений через MessageFormatter ✅

SOLID ✅

• S: ConfigLoader разделен на Parser, Validator, Serializer ✅
• S: MineCommands разделен на Admin, Player, Stats, Mask команды ✅
• S: Mines разделен на MineFileManager, MineRepository ✅
• I: MineConfig с Builder pattern ✅
• D: Repository pattern для доступа к данным ✅

---

🟢 УЛУЧШЕНИЯ АРХИТЕКТУРЫ (Приоритет 3)

Новая структура пакетов ✅

dev.loki.lomines/
├── LoMinesPlugin.java (≤120 строк)
├── command/
│   ├── AdminCommands.java
│   ├── PlayerCommands.java
│   ├── StatsCommands.java
│   └── MaskCommands.java
├── core/
│   ├── Mine.java
│   ├── Mines.java
│   ├── MineTicker.java
│   └── service/
│       ├── MineFileManager.java
│       ├── MineRepository.java
│       └── MaskScanService.java
├── data/
│   ├── config/
│   │   ├── ConfigLoader.java
│   │   ├── ConfigValidator.java
│   │   ├── ConfigSerializer.java
│   │   ├── MineConfig.java
│   │   └── parser/
│   │       ├── ConfigParser.java
│   │       └── ConfigParseException.java
│   ├── reward/
│   │   ├── Reward.java
│   │   ├── RewardParser.java
│   │   └── RewardItemParser.java
│   └── stats/
│       ├── StatsManager.java
│       ├── PlayerStats.java
│       ├── Leaderboard.java
│       └── LeaderboardEntry.java
├── handler/
│   ├── ActionBarHandler.java
│   ├── MineBlockHandler.java
│   ├── MineResetHandler.java
│   └── MineRewardHandler.java
├── util/
│   ├── ValidationUtils.java
│   ├── ErrorHandler.java
│   ├── MessageFormatter.java
│   ├── format/
│   │   ├── ChunkUtils.java
│   │   └── TimeFormatter.java
│   ├── location/
│   │   ├── BlockKeys.java
│   │   ├── Cuboid.java
│   │   └── LocationParser.java
│   └── selection/
│       ├── MaskScanner.java
│       ├── Selection.java
│       └── SelectionManager.java
└── wand/
    ├── GroupWandItem.java
    ├── GroupWandManager.java
    └── GroupWandSession.java

---

📦 Git и Инфраструктура

Git Setup ✅

• Инициализировать git репозиторий ✅
• Обновить .gitignore ✅
• Создать начальный коммит ✅
• Рефакторинг пакетов com.loki -> dev.loki ✅
• Восстановить Gradle wrapper

Правила коммитов

feat: новая функциональность
fix: исправление бага
refactor: рефакторинг без изменения функциональности
docs: изменения в документации
test: добавление/изменение тестов
chore: обновление зависимостей, конфигурации

---

🎯 Что делать дальше

Приоритет 1: GUI редакторы (неделя 1)

1. Создать MineEditGui — редактирование существующей шахты
2. Создать BlockConfigGui — настройка блоков через GUI
3. Создать RewardConfigGui — настройка наград через GUI
4. Создать ResetConfigGui — настройка таймеров сброса
5. Создать TeleportConfigGui — настройка телепортации

Приоритет 2: Интеграции (неделя 2)

1. Включить PlaceholderAPI — расширение для PAPI
2. Включить Oraxen — поддержка кастомных блоков
3. Включить ItemsAdder — поддержка кастомных блоков
4. Добавить Vault — экономика для наград

Приоритет 3: Фичи (неделя 3)

1. Добавить /lm info <mine> — детальная информация о шахте
2. Добавить /lm tp <mine> — телепортация в шахту
3. Добавить /lm copy <from> <to> — копирование конфигурации
4. Добавить метрики — /lm metrics для админов

---

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

Лимиты строк

• Главный класс плагина: ≤100 строк
• Обычные классы: ≤200 строк
• Утилиты: ≤150 строк
• Тесты: ≤300 строк

Принципы

• KISS: Один метод = одна задача, вложенность ≤3 уровней
• DRY: Дублирование кода ≥3 раз → вынести в метод/класс
• SOLID: Каждый класс = одна ответственность
• YAGNI: Не добавлять функциональность "на будущее"

Code Review Checklist

• Класс ≤200 строк (главный ≤100)
• Метод ≤30 строк
• Вложенность ≤3 уровней
• Нет дублирования кода
• Понятные имена переменных/методов
• Есть JavaDoc для публичных методов
• Есть тесты для новой функциональности

---

📊 Метрики качества

Текущие

• Средний размер класса: ~180 строк ✅
• Классов >200 строк: ~10% ✅
• Дублирование кода: <5% ✅
• Покрытие тестами: ~50% ⚠️

Целевые

• Средний размер класса: ≤150 строк
• Классов >200 строк: 0%
• Дублирование кода: <5%
• Покрытие тестами: ≥70%

---

🐛 Технический долг - РЕШЕНО

🔴 Критический - РЕШЕНО ✅

• ConfigLoader — разбито на 4 класса ✅
• MineCommands — разбито на 4 класса ✅
• Импорты ConfigParseException в тестах — исправлено ✅

🟡 Средний

• Смешанные типы блоков в одной шахте
• mine.blocks = mine.volume выставляется до завершения fill

🟢 Низкий

• ChunkUtils — хрупкий Class.forName для Paper
• SelectionWand.drawLine — спам частиц для высоких шахт

---

🎯 Следующие шаги

1. ✅ Рефакторинг пакетов com.loki -> dev.loki (2026-05-31)
2. ✅ Исправление импортов в тестах (2026-05-31)
3. Восстановить Gradle wrapper
4. GUI редакторы для шахт
5. Включить интеграции (PlaceholderAPI, Oraxen, ItemsAdder)
6. Добавить новые фичи (/lm info, /lm tp, /lm copy)
7. Увеличить покрытие тестами до 70%

---

Последнее обновление: 2026-05-31
Рефакторинг пакетов завершен: com.loki -> dev.loki