248 lines
10 KiB
Markdown
248 lines
10 KiB
Markdown
# LoParkour — TODO & Roadmap
|
||
|
||
> **Принципы:** KISS · DRY · SOLID
|
||
> **Версия:** 1.3.0 → 2.0.0
|
||
> **Обновлено:** 2026-03-05
|
||
|
||
---
|
||
|
||
## 📊 Статус миграции vilib → LoLib 2.0
|
||
|
||
✅ **МИГРАЦИЯ ЗАВЕРШЕНА** (2026-03-01)
|
||
- Файлов изменено: 120+
|
||
- Строк кода: 3000+
|
||
- Ошибок исправлено: 250+
|
||
- Размер jar: 655 КБ
|
||
- Все меню работают
|
||
- Схематики работают
|
||
|
||
---
|
||
|
||
## Легенда
|
||
- 🔴 **Критично** — баги/краши, нужно прямо сейчас
|
||
- 🟡 **Важно** — неработающие фичи
|
||
- 🟢 **Планово** — улучшения и новые фичи
|
||
- ✅ **Готово**
|
||
|
||
---
|
||
|
||
## 🔴 Критично
|
||
|
||
| # | Задача | Файл | Статус |
|
||
|---|--------|------|--------|
|
||
| 1 | GUIManager.init() не вызывался — клики не отменялись | `LoParkour.java` | ✅ |
|
||
| 2 | SQL race condition: CREATE TABLE до connect() | `StorageSQL.java` | ✅ |
|
||
| 3 | PreparedStatement leak в sendQuery() | `StorageSQL.java` | ✅ |
|
||
| 4 | Leaderboard читал данные до готовности SQL | `Leaderboard.java` | ✅ |
|
||
| 5 | Scoreboard не назначался игроку / обновление отключено | `ParkourUser.java` | ✅ |
|
||
| 6 | Только 16 уникальных entries в scoreboard (§0..§f) | `ParkourUser.java` | ✅ |
|
||
| 7 | NPE в World.setup() если createWorld() упал | `World.java` | ✅ |
|
||
| 8 | World.world не обновлялся при крэш-рестарте | `World.java` | ✅ |
|
||
| 9 | UUID сравнивался через == вместо .equals() | `ParkourUser.java` | ✅ |
|
||
| 10 | Async world creation вызывалось не на main thread | `LoParkour.java` | ✅ |
|
||
| 11 | StorageSQL.close() не проверяет connection == null | `StorageSQL.java` | ✅ |
|
||
|
||
---
|
||
|
||
## 🟡 Важно — неработающие фичи
|
||
|
||
### Партиклы
|
||
**Файл:** `generator/ParkourGenerator.java` → `generator/EffectManager.java`
|
||
- [x] Реализован базовый DOT/CIRCLE/BOX через `EffectManager`
|
||
- [ ] Протестировать все три режима в игре
|
||
- [ ] Убедиться что `ParticleUtil.circle()` принимает `List<Player>`
|
||
|
||
### ConfigUpdater
|
||
**Файл:** `config/Config.java`
|
||
- [ ] Раскомментировать `ConfigUpdater.update(...)` (закомментировано с TODO)
|
||
- [ ] Убедиться что `ignoredSections` правильно пробрасываются
|
||
|
||
### SpeedrunMode — блоки не синхронизированы с генератором
|
||
**Файл:** `mode/SpeedrunMode.java`
|
||
- [ ] Переопределить `tick()` в `SpeedrunGenerator`
|
||
- [ ] Блоки должны исчезать через `history`, а не независимо
|
||
|
||
### HardcoreMode — сброс наград при падении
|
||
**Файл:** `mode/HardcoreMode.java`
|
||
- [ ] Переопределить `reset()` в `HardcoreGenerator`
|
||
- [ ] Очищать `player.collectedRewards` при `regenerate=true`
|
||
|
||
---
|
||
|
||
## 🟢 Планово — новые фичи
|
||
|
||
### ElytraMode — кольца
|
||
**Файл:** `mode/ElytraMode.java`
|
||
- [ ] `ElytraGenerator extends ParkourGenerator` — генерировать кольца из партиклов
|
||
- [ ] Детекция пролёта через кольцо (bounding box check в tick)
|
||
- [ ] Cooldown на фейерверки (буст)
|
||
|
||
### GravityShiftMode — визуальные эффекты
|
||
**Файл:** `mode/GravityShiftMode.java`
|
||
- [ ] Title при смене эффекта
|
||
- [ ] Партиклы PORTAL при смене
|
||
- [ ] Звук при смене
|
||
|
||
### Валидация прыжков
|
||
**Файл:** `generator/ParkourGenerator.java`
|
||
- [ ] Включить `JUMP_VALIDATION_ENABLED` из конфига в `selectNext()`
|
||
- [ ] Retry-loop: до 10 попыток если прыжок невозможен
|
||
- [ ] Использовать уже существующий `JumpValidator`
|
||
|
||
### Специальные прыжки
|
||
**Файл:** `generator/JumpType.java` (создать)
|
||
- [ ] neo-jump (4 блока по диагонали)
|
||
- [ ] head-hitter (блок над головой)
|
||
- [ ] Интегрировать в `selectBlocks()` через шанс из конфига
|
||
|
||
### Ghost система
|
||
**Файл:** `ghost/`
|
||
- [ ] Протестировать `GhostRecorder` и `GhostPlayer`
|
||
- [ ] Включить в конфиге `ghost-mode.enabled: true`
|
||
- [ ] Команда `/lp ghost <on|off>`
|
||
|
||
### Мультиплеер режимы
|
||
- [ ] RaceMode (гонка — кто первый наберёт N очков)
|
||
- [ ] CoopMode (кооператив — общий счёт)
|
||
|
||
### Локализация режимов
|
||
**Файлы:** `locales/en.yml`, `locales/ru.yml`
|
||
- [ ] gravity-shift: название эффекта, `effect-applied`
|
||
- [ ] elytra: `ring-passed`, `boost-ready`, `boost-cooldown`
|
||
- [ ] hardcore: `rewards-lost`
|
||
|
||
---
|
||
|
||
## ✅ Архитектурный рефакторинг — завершён
|
||
|
||
| Что сделано | Результат |
|
||
|-------------|-----------|
|
||
| `Command.java` → удалён (дубликат) | `LoParkourCommand.java` — единственный файл |
|
||
| `LoParkourCommand.java` (528 строк) | `command/PlayerCommandHandler` + `AdminCommandHandler` + `SchematicCommandHandler` + тонкий роутер |
|
||
| `Events.java` (268 строк) | `listener/PlayerConnectionListener` + `ParkourRestrictionListener` + `SchematicWandListener` |
|
||
| `ParkourGenerator.java` (666 строк) | Делегирует в `EffectManager` + `GeneratorTick` |
|
||
| `Option.java` (247 строк) | `SqlOptions` + `ParticleOptions` + `GenerationOptions` + тонкий `Option` |
|
||
| GUI-паттерн (13 меню) | Исправлены на правильный `create()` API |
|
||
| Scoreboard | Полная реализация через Team prefix API |
|
||
| SQL инициализация | `pendingTableCreations` queue + `onConnectCallbacks` |
|
||
|
||
---
|
||
|
||
## 🎮 Чек-лист перед релизом
|
||
|
||
- [ ] `./gradlew build` без ошибок и предупреждений
|
||
- [ ] Запуск сервера без ошибок в консоли
|
||
- [ ] Паркур создаётся и работает (прыжки, счёт, рекорд)
|
||
- [ ] Скорборд обновляется во время игры
|
||
- [ ] Все меню открываются корректно
|
||
- [ ] SQL: таблицы создаются, данные сохраняются/читаются
|
||
- [ ] Схематики: save → reload → paste работает
|
||
- [ ] Лидерборд: запись и чтение рекордов
|
||
- [ ] Частицы и звук работают в каждом режиме
|
||
- [ ] `/lp forcejoin`, `forceleave`, `reset`, `recoverinventory`
|
||
|
||
|
||
---
|
||
|
||
## 🔧 План рефакторинга больших файлов
|
||
|
||
### Проблемные файлы (>200 строк):
|
||
- `generator/ParkourGenerator.java` (306) → разбить на 3 файла
|
||
- `storage/StorageSQL.java` (248) → разбить на 2 файла
|
||
- `session/Session.java` (236) → разбить на 2 файла
|
||
- `player/ParkourUser.java` (220) → разбить на 2 файла
|
||
- `player/ParkourPlayer.java` (202) → разбить на 2 файла
|
||
|
||
### 1. ParkourGenerator.java → 3 файла
|
||
```
|
||
generator/
|
||
├── ParkourGenerator.java (150) - координация
|
||
├── GeneratorState.java (80) - состояние (score, history)
|
||
└── GeneratorLifecycle.java (80) - tick, reset, fall
|
||
```
|
||
|
||
### 2. StorageSQL.java → 2 файла
|
||
```
|
||
storage/
|
||
├── SQLConnection.java (120) - управление подключением
|
||
└── SQLRepository.java (130) - CRUD операции
|
||
```
|
||
|
||
### 3. Session.java → 2 файла
|
||
```
|
||
session/
|
||
├── Session.java (120) - основная логика
|
||
└── SessionMembers.java (120) - управление участниками
|
||
```
|
||
|
||
### 4. ParkourUser.java → 2 файла
|
||
```
|
||
player/
|
||
├── ParkourUser.java (120) - базовый user
|
||
└── UserScoreboard.java (100) - scoreboard логика
|
||
```
|
||
|
||
### 5. ParkourPlayer.java → 2 файла
|
||
```
|
||
player/
|
||
├── ParkourPlayer.java (120) - gameplay
|
||
└── PlayerSettings.java (80) - настройки
|
||
```
|
||
|
||
---
|
||
|
||
## 🎨 Новые фичи (Фаза 3-6)
|
||
|
||
### Визуальные темы
|
||
```java
|
||
public enum VisualTheme {
|
||
NEON, // неоновые блоки + яркие партиклы
|
||
NATURE, // трава, листья, цветы
|
||
SPACE, // космос, звёзды
|
||
UNDERWATER,// вода, кораллы
|
||
HELL // нижний мир, лава
|
||
}
|
||
```
|
||
|
||
### Combo система
|
||
- Множитель очков за последовательные прыжки (x2, x3... x10)
|
||
- Визуальный индикатор combo
|
||
- Combo break при падении
|
||
- Бонусные очки за высокий combo
|
||
|
||
### Специальные прыжки
|
||
- **Neo-jump** - 4 блока по диагонали (5% шанс)
|
||
- **Head-hitter** - блок над головой (10% шанс)
|
||
- **Ladder jump** - прыжок на лестницу (15% шанс)
|
||
|
||
### Replay система
|
||
- Запись последнего прохождения
|
||
- Просмотр replay с камерой
|
||
- Экспорт/импорт replay файлов
|
||
- Замедление/ускорение воспроизведения
|
||
|
||
---
|
||
|
||
## 📅 Временная шкала (6-7 недель)
|
||
|
||
| Фаза | Задачи | Время |
|
||
|------|--------|-------|
|
||
| 0 | Критические баги | 1-2 дня |
|
||
| 1 | Рефакторинг файлов | 1 неделя |
|
||
| 2 | Исправление фич | 1 неделя |
|
||
| 3 | Новые режимы | 2 недели |
|
||
| 4 | Визуал (темы, combo) | 1 неделя |
|
||
| 5 | Ghost система | 3 дня |
|
||
| 6 | Replay система | 1 неделя |
|
||
|
||
---
|
||
|
||
## 🎯 Критерии релиза 2.0.0
|
||
|
||
- ✅ Все файлы < 200 строк
|
||
- ✅ 5+ режимов игры
|
||
- ✅ Ghost система активна
|
||
- ✅ Визуальные темы
|
||
- ✅ Combo система
|
||
- ✅ Replay система
|
||
- ✅ Специальные прыжки
|