Anomaly 666 - Superpowers

═══════════════════════════════════════════════════
🇬🇧 ENGLISH CHANGELOG
═══════════════════════════════════════════════════

v2.1 — The Ability Selector Update

NEW: ABILITY SELECTOR SYSTEM
- Press R to cycle through your abilities (Shift+R to scroll back)
- HUD panel above the energy bar shows the currently selected ability, its index (N/M), and its energy cost
- Press Z to activate the selected ability — one key for everything now
- Ability list: Ki Blast, Laser Eyes, Kamehameha, Spirit Bomb, Spike of Ruin, Fire Breath
- Scroll cooldown of 3 ticks prevents accidental double-switching
- Soft click sound on each scroll

NEW: SPIKE OF RUIN
- Summons a 3-block-tall red spike from the ground with grow/hold/shrink animation
- Normal use (Z with Spike selected): auto-targets a mob in your crosshair, 3.5s cooldown
- Alt+Z: places a spike on any block you are looking at, 2.5s cooldown per block (each block has its own cooldown timer)
- Alt+RMB+Z: mass eruption — spikes on every mob within 35 blocks; energy is charged per mob; 4s cooldown
- Spike damage: 760 HP, hit box matches visual, proper depth test so spikes are not visible through walls

NEW: FIRE BREATH
- Hold Z with Fire Breath selected to unleash a sustained cone of fire
- Burns blocks (wood, planks, leaves, wool, crops, flowers), melts ice into water, removes snow, scorches mobs
- Applies 90 damage/tick to mobs in the cone, applies Slowness, sets mobs on fire
- Full custom renderer: 4 layered cones (dark red → orange → yellow → white core) with pulsing living-flame feel
- Dedicated loop sound + camera shake during use
- Lasts up to 5 seconds, 4-second cooldown, auto-stops at max hold or when energy runs out

NEW: X-RAY VISION
- Press X to see every living entity through walls within 130 blocks
- Colour coding: players = blue, hostile mobs = red, passive mobs = yellow
- Lasts 25 seconds; 1.2s toggle-on cooldown, 2.5s toggle-off cooldown
- Limited to nearest 150 entities and rendered in batches of 40 for performance

NEW: BOOST RING VISUAL
- When you activate a flight boost, a white expanding ring appears at the activation point and fades over 1 second
- The ring is fixed in world space (does not follow the player)
- Only triggers on actual boost activation, not on regular flight

REWORKED: KEY BINDINGS
- R — ability selector (forward), Shift+R — backward
- Z — activate selected ability
- C — Lightning Storm (moved from H)
- X — X-Ray Vision (new)
- V — Scream (unchanged)
- B — Teleport (unchanged)
- Y — Energy Shield (unchanged)
- N — Invisibility (unchanged)
- G — Telekinesis (unchanged)
- M — Regeneration (unchanged)
- Alt + [key] — super mode (unchanged)
- Double-tap space — toggle flight; Ctrl — boost; hold space during boost — stack boost (unchanged)

IMPROVED: NETWORKING & MULTIPLAYER SYNC
- All ability states (laser mode, scream active, regen, spiritual bomb charge, fireball charge, firebreath) are now synced through a single unified network channel (AbilityStateNetwork) — fewer desyncs in multiplayer
- Sound effects are now server-authoritative: laser, scream, kamehameha charge, fireball charge and firebreath sounds play via level.playSound on the server so nearby players hear them correctly, and the caster is excluded to avoid double-playing
- Sword Lightning Storm now drains energy per tick on the server (was client-only before)
- Laser server handler now reads state from AbilityStateNetwork instead of ClientKeyState, so teleport/desync issues are gone
- Scream server handler reads state from AbilityStateNetwork
- PlayerStatsHandler regeneration reads state from AbilityStateNetwork
- Spiritual Bomb explode packet routed through AbilityStateNetwork
- Fireball charge packet routed through AbilityStateNetwork

IMPROVED: ANIMATIONS & VISUAL POLISH
- Unified second-layer model sync via AnimationHandler.syncSecondLayer() — hat, jacket, left/right sleeve, left/right pants now correctly follow the first-layer parts in every animation (kamehameha, flight, fireball, super attack, spiritual bomb). No more desynced sleeves or floating hats on other players
- Kamehameha arm pose now syncs the second layer
- PlayerModelMixin now syncs the second layer after flight and fireball poses
- Super Attack pose no longer overrides Fire Breath pose
- Spiritual Bomb arm pose priority raised to 1500 (above PlayerModelMixin 1000) so it wins the arm pose during charging, but correctly releases control once post-release ticks reach 60 — arms are no longer stuck in the air

FIXED: LASER BEAM NaN BUG (KNOWN BUG)
- When looking straight up or straight down, the beam's right-vector was computed from cross(look, worldUp) which becomes a zero vector → NaN vertices → invisible or glitched beams
- Replaced with rightFromYaw(viewYaw) which stays stable at any pitch
- Added an isNaN() safety check before writing each vertex
- Beams now render correctly even when you look exactly at the zenith or nadir

FIXED: VARIOUS
- Super Attack animation no longer interferes with Fire Breath's arm animation
- Spiritual Bomb arm pose no longer gets stuck after animation ends (t >= 60 resets cleanly)
- Lightning Storm no longer fires from the wrong direction if you move the crosshair while holding
- Energy Shield drains energy per tick scaled by current shield progress
- Boost flight no longer consumes hunger
- Spike renderer respects depth test — no more visible-through-wall spikes
- X-Ray is capped and batched to prevent crash on densely populated servers
- Ability Selector panel no longer overlaps the energy bar
- Sounds no longer play twice for the caster (was: local + server; now: local only for caster, server for everyone else)
- Removed leftover X keybinding from Kamehameha (now handled by the selector)
- Removed unused Example Mod config references

Known issues:
- Fire Breath can drop FPS in large forests (many blocks processed per tick)
- X-Ray with 150+ entities may impact FPS on low-end systems (config planned for 2.2)
- Ability Selector and Energy HUD positions are fixed (bottom-left); config planned for 2.2

═══════════════════════════════════════════════════
🇷🇺 РУССКИЙ CHANGELOG
═══════════════════════════════════════════════════

v2.1 — Обновление системы выбора способностей

НОВОЕ: СИСТЕМА ВЫБОРА СПОСОБНОСТЕЙ
- Нажми R, чтобы переключаться между способностями (Shift+R — прокрутка назад)
- HUD-панель над шкалой энергии показывает текущую выбранную способность, её индекс (N/M) и стоимость энергии
- Нажми Z, чтобы активировать выбранную способность — теперь одна клавиша на всё
- Список способностей: Ки-бластер, Лазеры из глаз, Камехамеха, Духовная бомба, Шип разрушения, Огненное дыхание
- Кулдаун прокрутки 3 тика защищает от случайных двойных переключений
- Мягкий щелчок при каждой прокрутке

НОВОЕ: ШИП РАЗРУШЕНИЯ
- Призывает красный шип высотой 3 блока из земли с анимацией роста/удержания/сжатия
- Обычное использование (Z при выборе Шипа): автонаведение на моба в прицеле, кулдаун 3.5 сек
- Alt+Z: ставит шип на любой блок, на который смотришь, кулдаун 2.5 сек на блок (у каждого блока свой таймер)
- Alt+ПКМ+Z: массовое извержение — шипы на всех мобах в радиусе 35 блоков; энергия тратится за каждого моба; кулдаун 4 сек
- Урон шипа: 760 HP, хитбокс совпадает с визуалом, корректный depth test — шипы не видны сквозь стены

НОВОЕ: ОГНЕННОЕ ДЫХАНИЕ
- Удерживай Z при выборе Огненного дыхания, чтобы выпустить конус огня
- Сжигает блоки (дерево, доски, листва, шерсть, урожай, цветы), плавит лёд в воду, убирает снег, опаляет мобов
- Наносит 90 урона за тик мобам в конусе, накладывает Замедление, поджигает мобов
- Полный кастомный рендерер: 4 слоя конусов (тёмно-красный → оранжевый → жёлтый → белое ядро) с пульсирующим эффектом живого пламени
- Отдельный loop-звук + тряска камеры при использовании
- До 5 секунд, кулдаун 4 секунды, авто-стоп при максимуме удержания или когда кончается энергия

НОВОЕ: РЕНТГЕН-ЗРЕНИЕ
- Нажми X, чтобы видеть всех живых сущностей сквозь стены в радиусе 130 блоков
- Цветовая кодировка: игроки = синие, враждебные мобы = красные, мирные = жёлтые
- Длительность 25 секунд; 1.2 сек нельзя выключить, 2.5 сек нельзя включить обратно
- Лимит — 150 ближайших сущностей и рендер батчами по 40 для производительности

НОВОЕ: ВИЗУАЛ КОЛЬЦА БУСТА
- При активации буста полёта появляется белое расширяющееся кольцо в точке срабатывания, затухает за 1 секунду
- Кольцо фиксируется в мире (не следует за игроком)
- Срабатывает только при фактической активации буста, не при обычном полёте

ПЕРЕРАБОТКА: КЛАВИШИ
- R — селектор способностей (вперёд), Shift+R — назад
- Z — использовать выбранную способность
- C — Шквал молний (переехал с H)
- X — Рентген-зрение (новое)
- V — Крик (без изменений)
- B — Телепорт (без изменений)
- Y — Энергощит (без изменений)
- N — Невидимость (без изменений)
- G — Телекинез (без изменений)
- M — Регенерация (без изменений)
- Alt + [клавиша] — супер-режим (без изменений)
- Двойной тап пробела — полёт; Ctrl — ускорение; удержание пробела в бусте — стак-буст (без изменений)

УЛУЧШЕНО: СЕТЬ И СИНХРОНИЗАЦИЯ В МУЛЬТИПЛЕЕРЕ
- Все состояния способностей (режим лазера, крик, регенерация, заряд духовной бомбы, заряд огненного шара, огненное дыхание) теперь синхронизируются через единый сетевой канал (AbilityStateNetwork) — меньше рассинхронов в мультиплеере
- Звуковые эффекты теперь серверно-авторитетные: звуки лазера, крика, заряда камехамехи, заряда огненного шара и огненного дыхания играются через level.playSound на сервере, так что соседние игроки слышат их корректно, а кастер исключён — нет двойного воспроизведения
- Шквал молний от меча теперь тратит энергию за тик на сервере (раньше — только на клиенте)
- Серверный обработчик лазера читает состояние из AbilityStateNetwork вместо ClientKeyState — проблема рассинхрона ушла
- Серверный обработчик крика читает состояние из AbilityStateNetwork
- Регенерация в PlayerStatsHandler читает состояние из AbilityStateNetwork
- Пакет взрыва духовной бомбы идёт через AbilityStateNetwork
- Пакет заряда огненного шара идёт через AbilityStateNetwork

УЛУЧШЕНО: АНИМАЦИИ И ВИЗУАЛ
- Унифицированная синхронизация второго слоя модели через AnimationHandler.syncSecondLayer() — шляпа, куртка, левый/правый рукав, левые/правые штаны теперь корректно следуют за первым слоем во всех анимациях (камехамеха, полёт, огненный шар, супер-удар, духовная бомба). Больше нет отстающих рукавов или висящих в воздухе шляп у других игроков
- Поза камехамехи теперь синхронизирует второй слой
- PlayerModelMixin синхронизирует второй слой после поз полёта и огненного шара
- Поза супер-удара больше не перекрывает позу Огненного дыхания
- Приоритет позы духовной бомбы поднят до 1500 (выше PlayerModelMixin с 1000) — она выигрывает позу рук при заряде, но корректно отпускает контроль, когда postReleaseTicks достигает 60 — руки больше не застревают в воздухе

ИСПРАВЛЕНО: БАГ NaN У ЛАЗЕРОВ (ИЗВЕСТНЫЙ БАГ)
- При взгляде ровно вверх или ровно вниз правый вектор луча вычислялся через cross(look, worldUp), который становится нулевым → NaN-вершины → невидимые или глючащие лучи
- Заменено на rightFromYaw(viewYaw), который стабилен при любом pitch
- Добавлена защита isNaN() перед записью каждой вершины
- Лучи теперь корректно рендерятся, даже когда смотришь ровно в зенит или надир

ИСПРАВЛЕНО: РАЗНОЕ
- Анимация супер-удара больше не мешает анимации рук Огненного дыхания
- Поза духовной бомбы больше не застревает после окончания анимации (при t >= 60 чисто сбрасывается)
- Шквал молний больше не стреляет в неправильном направлении, если двигать прицел во время удержания
- Энергощит тратит энергию за тик пропорционально текущему прогрессу щита
- Boost-полёт больше не расходует голод
- Рендерер шипов уважает depth test — шипы больше не видны сквозь стены
- Рентген ограничен по количеству и рендерится батчами — не крашит на густонаселённых серверах
- Панель селектора способностей больше не перекрывает шкалу энергии
- Звуки больше не играются дважды для кастера (было: локально + сервер; стало: только локально для кастера, сервер — для остальных)
- Убрана забытая клавиша X у камехамехи (теперь это селектор)
- Убраны неиспользуемые ссылки на конфиг Example Mod

Известные проблемы:
- Огненное дыхание может просаживать FPS в больших лесах (много блоков обрабатывается за тик)
- Рентген при 150+ сущностях может просадить FPS на слабых ПК (конфиг в 2.2)
- Позиции HUD селектора и энергии фиксированы (слева внизу); настройка в 2.2