LoParkour/TODO.md

LoParkour Bug Tracker

CRITICAL

1. ProfileValue.asInt/asDouble — NumberFormatException при пустой строке

• Файл: Profile.java:57-58
• Описание: Integer.parseInt(value) и Double.parseDouble(value) падают при пустой строке "", которая возвращается по умолчанию при отсутствии ключа (new ProfileValue(""))
• Фикс: Добавить дефолтное значение либо кидать понятное исключение, а не NFE

2. Bukkit.createBlockData — IllegalArgumentException при невалидном materialName

• Файл: GeneratorProfileManager.java:133
• Описание: Если materialName из конфига невалидный (опечатка в generation.yml), Bukkit.createBlockData() кинет исключение
• Фикс: Валидировать materialName перед вызовом, либо ловить конкретно на строке 133

3. JumpDirector диагональный дрейф — heading никогда не выпрямляется

• Файл: JumpDirector.java:87-99
• Описание: getRecommendedHeading() всегда создает Vector(1,0,1) для X и Z границ. После нормализации heading становится диагональным и НИКОГДА не возвращается к осевому направлению
• Фикс: Использовать Vector(1,0,0) для X и Vector(0,0,1) для Z. Сбрасывать heading на исходный при отсутствии границы

4. subList().clear() на synchronizedList(LinkedList) — повреждение node связей

• Файл: GeneratorCleanup.java:50-56
• Описание: history.subList(0, removeCount).clear() на Collections.synchronizedList(new LinkedList<>()) — compound операция не атомарна. ConcurrentModificationException или повреждение связей
• Фикс: Оборачивать в synchronized(history) или использовать CopyOnWriteArrayList

5. Мультиплеер — runaway генерация блоков

• Файл: PlayerInteractionHandler.java:116-118 + LifecycleTickManager.java:89-97
• Описание: Каждый игрок триггерит generate(1) при скоре. N игроков = N блоков/тик. maintainBlockLead добавляет еще. Положительная обратная связь
• Фикс: Не больше 1 блока за тик независимо от числа игроков, кэп на maintainBlockLead

6. Система схематик полностью сломана

• Файл: PlayerInteractionHandler.java:111-113 + BlockPlacer.java:207-212
• Описание: isSchematicEndBlock возвращает true для ЛЮБОГО schematic блока. При входе в схематик сразу удаляется + блоки засчитываются как очки
• Фикс: isSchematicEndBlock должен проверять только ПОСЛЕДНИЙ блок схематика. Исключить schematic блоки из скоринга

7. Прыжки за границами валидации

• Файл: JumpCalculator.java:101-114
• Описание: JumpOffsetGenerator генерирует offset до 5 блоков, total horizontal = sqrt(4²+5²)=6.4 при лимите 4.1. Retry-цикл не гарантирует валидность за 10 попыток
• Фикс: Ограничить randomOffset пределами валидатора: maxRandomOffset = sqrt(maxHorizontal² - distance²)

HIGH

8. angleInY вращает offset относительно глобального Option.HEADING

• Файл: JumpCalculator.java:105-113
• Описание: rotateAroundY использует разницу между текущим heading и Option.HEADING, а не между текущим и предыдущим heading. Блоки уходят вбок
• Фикс: Вращать offset относительно предыдущего heading

9. Дублирование canJump(Location) и canJump(Vector) — рассинхронизация

• Файл: JumpValidator.java:73-161
• Описание: Два метода canJump. Location-версия учитывает slab-корректировку, Vector — нет
• Фикс: Убрать дублирование или добавить adjustment в Vector-версию

10. synchronizedList — итерации без синхронизации

• Файл: GeneratorState.java:35
• Описание: Итерации по history (cleanupDistantBlocks, historyContains, indexOfBlock) не обернуты в synchronized. Пока все на main thread, но это хрупко
• Фикс: Добавить synchronized(history) на все итерации, либо убрать synchronizedList

11. heading.clone() без null-проверки

• Файл: JumpCalculator.java:101-103
• Описание: generator.state.heading.clone() упадет с NPE, если heading не инициализирован до первого вызова calculateJumpOffset
• Фикс: Добавить null-guard: если heading == null, инициализировать из Option.HEADING

MEDIUM

12. BlockSelector.selectBlockData рекурсия при пустом списке стилей

• Файл: BlockSelector.java:32-33
• Описание: Если style == null, код сбрасывает стиль на первый. orElseThrow() упадет, если список пуст
• Фикс: Проверка if (styles.isEmpty()) return Material.STONE.createBlockData()

13. checkPlayerFall — break вместо continue

• Файл: LifecycleTickManager.java:74-78
• Описание: При падении двух игроков в одном тике, второй пропускает обработку до следующего тика
• Фикс: Заменить break на continue

14. removeTrailBlocks сдвигает индексы истории

• Файл: GeneratorCleanup.java:79-93
• Описание: history.subList(startIndex, endIndex).clear() сдвигает индексы при параллельном вызове historyContains
• Фикс: Защититься копированием или проверять синхронизацию

15. Дублирование isSlabMaterial

• Файл: JumpValidator.java:67-71
• Описание: JumpValidator и BlockSelector имеют дублирующуюся логику определения slab. Рассинхронизация при изменениях
• Фикс: Вынести в общий утилитарный метод

16. DifficultyScore thresholds для льда (1.0/2.0) могут быть недостижимы

• Файл: GeneratorProfileManager.java:57-69
• Описание: packed_ice добавляется при difficulty >= 1.0, blue_ice при >= 2.0. Многие конфиги не достигают этих значений. Лед не появляется
• Фикс: Нормализовать difficulty до предсказуемой шкалы или изменить thresholds

17. schematicBlocks — ArrayList без thread safety

• Файл: GeneratorState.java:41
• Описание: schematicBlocks это plain ArrayList, без синхронизации, в отличие от history
• Фикс: Добавить синхронизацию или документировать main-thread-only

LOW

18. scoredBlocks HashSet не очищается при fall

• Файл: ParkourPlayer.java:125-127
• Описание: HashSet растет бесконечно. При возрождении на тех же координатах не засчитает блоки
• Фикс: scoredBlocks.clear() при fall/reset

19. getFormattedTime() — Date(elapsed) хак

• Файл: GeneratorStatistics.java:90-91
• Описание: new Date(elapsed) — Date ожидает timestamp от 1970, а передается длительность. Сломается при >24ч
• Фикс: Использовать Duration API для форматирования

20. isUnsafeParkourMaterial блокирует PUMPKIN и _BED без причины

• Файл: BlockSelector.java:48-60
• Описание: PUMPKIN не имеет onPlace-сканирования соседей. _BED безопасны при setBlockData с флагом false
• Фикс: Убрать лишние исключения