refactor: комплексный рефакторинг + Isaac-like геймплей

Баги и гигиена (Wave 1): - Player.addWeapon использует MODE_MELEE вместо литерала 1 - Фильтрация мёртвых врагов из room.enemies (раньше массив рос в долгих боях) - Кап миньёнов босса (BOSS.maxMinions=4) — иначе комната могла не зачиститься - aliveCount корректно считает живых в knockback-фазе - equipSlot валидирует диапазон слота - Магические числа range=70/spread=0.15 вынесены в WeaponDef (beamRange/spread) - Регрессия cleared-flag: после фильтрации массива длина 0, но cleared должен стать true Распил Game.ts 683→465 строк (Wave 2): - systems/movement.ts: moveEntity(e, dx, dy, room) — убрал 5 копий коллизионного паттерна - systems/projectiles.ts: applyWeaponProjectileStats, explodeBomb, projectileHitWall - systems/ai.ts: runAI через диспетчер-таблицу (вместо if/else-if каскада) - Переходы/этажи оставлены в Game.ts (тесно завязаны на cc/cr/player) Тесты 33→72 (Wave 3): - movement.test.ts, projectiles.test.ts, combat.test.ts, regressions.test.ts, items.test.ts - Покрытие: ближний/дальний бой, огнемёт, бомба, лазер, splitter, сундук→пикап, переход комнат, фазы босса + кап миньёнов, фильтрация мёртвых, секретка Isaac-like геймплей (Wave 4): - Статы игрока: damageMul/fireRateMul/rangeMul/shotSpeedMul (мультипликативно поверх WeaponDef), effectiveDamage/Cooldown, отображение в HUD - 8-направленный прицел: aimDir: Dir → aimVec: {x,y}, стрелки дают диагонали - Пассивные предметы (items.ts, 6 штук): сундук дропает 50/50 оружие/предмет - Новый тип врага splitter: при смерти распадается на двух fast - Новый тип комнаты secret: +1 max HP один раз при первом входе
Merge pull request #4 from VovaManul/feature/new-game-plus
2026-06-19 16:50:15 +03:00 · 2026-06-19 15:53:00 +03:00 · 2026-06-19 15:50:02 +03:00 · 2026-06-19 13:27:47 +03:00 · 2026-06-19 13:26:19 +03:00 · 2026-06-19 13:09:28 +03:00
115 changed files with 3870 additions and 384 deletions
@@ -0,0 +1,4 @@
+# Эти строки раскомментируй, если появятся ссылки на спонсорство
+# github: [VovaManul]
+# patreon: # username
+# ko_fi: # username
@@ -0,0 +1,34 @@
+---
+name: Сообщить о баге
+about: Что-то работает не так
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Описание
+
+<!-- Чёткое описание бага. -->
+
+## Воспроизведение
+
+1. Открыть `dist/index.html` (или `bun run dev`)
+2. Выбрать уровень «…»
+3. Перейти в комнату …
+4. Использовать …
+5. Видно, что …
+
+## Ожидаемое поведение
+
+<!-- Что должно было произойти. -->
+
+## Скриншоты / видео
+
+## Среда
+
+- Браузер: Chrome/Firefox/Safari
+- ОС: macOS/Windows/Linux
+
+## Дополнительно
+
+<!-- Логи консоли, seed забега и т.д. -->
@@ -0,0 +1,29 @@
+---
+name: Предложить идею
+about: Новая фича, улучшение или изменение
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## Проблема
+
+<!-- Какая проблема решается? Чего не хватает? -->
+
+## Решение
+
+<!-- Как это должно работать? Опиши желаемое поведение. -->
+
+## Альтернативы
+
+<!-- Какие ещё варианты рассматривал? -->
+
+## Совместимость
+
+- [ ] Меняет архитектуру «ядро ↔ рендер»
+- [ ] Добавляет новую зависимость
+- [ ] Ломает обратную совместимость
+
+## Дополнительно
+
+<!-- Скетчи, ссылки, примеры из других игр. -->
@@ -0,0 +1,28 @@
+## Описание
+
+<!-- Краткое описание изменений. Что и зачем. -->
+
+## Связанный issue
+
+<!-- Fixes #номер -->
+
+## Чеклист
+
+- [ ] `bun run check` зелёный (typecheck + tests)
+- [ ] Добавлены/обновлены тесты (если менялась логика)
+- [ ] Проверено в браузере (если геймплей/рендер)
+- [ ] Обновлена документация (если нужно)
+- [ ] Нет `any` (кроме узких мест по согласованию)
+- [ ] Нет `Math.random()` в `src/core/`
+
+## Тип изменений
+
+- [ ] Исправление бага
+- [ ] Новая функциональность
+- [ ] Рефакторинг
+- [ ] Документация
+- [ ] Другое
+
+## Дополнительно
+
+<!-- Любая дополнительная информация для ревьюера -->
@@ -0,0 +1,105 @@
+# AGENTS.md — как работать с этим проектом
+
+Инструкции для ИИ-агентов **и** разработчика. Прочитай целиком перед правками.
+Цель проекта — держать **рабочую, расширяемую базу** рогалика. Не ломать то, что
+работает; добавлять — по правилам ниже.
+
+## Что это
+
+Top-down рогалик (в духе Binding of Isaac). Логика — чистый TypeScript
+(`src/core/`), рендер — three.js в псевдо-3D (наклонная `PerspectiveCamera`, `src/render/`), сборка/тесты — Bun.
+Обзор — [`README.md`](./README.md), детали — [`docs/ARCHITECTURE.md`](./docs/ARCHITECTURE.md),
+рецепты доработки — [`docs/HOWTO.md`](./docs/HOWTO.md).
+
+## 🔑 Золотые правила (нарушать = ломать архитектуру)
+
+1. **Ядро без рендера и DOM.** В `src/core/**` НЕЛЬЗЯ импортировать `three`,
+   обращаться к `window`/`document`/`canvas`. Логика общается с миром только через
+   `InputState` (вход) и публичные поля `Game` (для чтения рендером).
+2. **Рендер ничего не меняет в игре.** `src/render/**` только ЧИТАЕТ `Game` и
+   рисует. Любая мутация состояния из рендера — баг.
+3. **Случайность только через `Rng`.** Никаких `Math.random()` в `core/`. Это
+   сохраняет детерминизм (тесты, отладка по seed).
+4. **Время — в «шагах» (1/60 c), а не в кадрах.** Скорости — «пиксели/шаг»,
+   перезарядки — «шаги». Не двигай ничего в коде рендера или прямо в rAF.
+5. **Числа — не в коде.** Константы движка (размеры, геометрия дверей, базовый
+   баланс) — в `src/config.ts`; параметры конкретного забега (размер карты, сила
+   врагов, HP игрока, seed) — в правилах уровня `src/core/rules.ts`. Не раскидывай
+   «магические числа» по логике.
+6. **Освобождай ресурсы three.js.** Создаёшь геометрию/материал на сущность —
+   обеспечь `dispose()` при её удалении (см. `sync*`/`sweep` в `ThreeRenderer`).
+7. **Комментарии и текст для игрока — по-русски**, как в существующем коде.
+
+## Команды
+
+```bash
+bun run dev        # дев-сервер + watch → http://localhost:3000
+bun run build      # прод-сборка в dist/
+bun run typecheck  # tsc --noEmit (строгий) — НЕ ловится при bun build!
+bun test           # юнит-тесты ядра
+bun run check      # typecheck + test
+```
+
+> ⚠️ `bun build` **не проверяет типы**. Поэтому `bun run typecheck` обязателен —
+> именно отсутствие тайп-чека когда-то скрыло рантайм-регрессию.
+
+## Definition of Done (для любой правки)
+
+1. `bun run check` зелёный (типы + тесты).
+2. Если менял логику — **добавил/обновил тест** в `tests/`.
+3. Если менял геймплей/рендер — **проверил в браузере** (`bun run dev`, открыть
+   страницу, увидеть, что играется, в консоли нет ошибок). Юнит-тесты не видят
+   рендер — визуальную проверку не пропускать.
+4. Обновил доки, если поменялось поведение или структура.
+
+## Где что лежит (карта для навигации)
+
+| Хочешь поменять… | Иди в… |
+|---|---|
+| константы движка (размер тайла/комнаты, геометрия дверей, базовый баланс) | `src/config.ts` |
+| правила уровня / пресеты в меню (размер карты, сила врагов, HP, seed) | `src/core/rules.ts` |
+| поведение за один шаг (движение, атака, ИИ, переходы) | `src/core/Game.ts` |
+| данные сущности | `src/core/entities/*` |
+| генерацию карты | `src/core/world/RoomMap.ts` |
+| форму комнаты/тайлы | `src/core/world/tiles.ts`, `Room.ts` |
+| коллизии | `src/core/systems/collision.ts` |
+| расстановку врагов | `src/core/systems/spawner.ts` |
+| как рисуется мир (псевдо-3D) | `src/render/ThreeRenderer.ts` |
+| спрайты/текстуры (графика) | `src/render/assets.ts` (бриф на художку — `docs/ASSET_BRIEF.md`) |
+| цвета/тинты/фон | `src/render/theme.ts` |
+| HUD/миникарту | `src/render/HudOverlay.ts` |
+| стартовое меню | `src/ui/StartMenu.ts` |
+| раскладку клавиш | `src/input/KeyboardController.ts` |
+| тайминг/цикл, поток меню↔игра | `src/engine/GameLoop.ts`, `src/main.ts` |
+
+Пошаговые рецепты («добавить врага», «новое оружие», «тип комнаты», «сменить
+рендер») — в [`docs/HOWTO.md`](./docs/HOWTO.md).
+
+## Грабли, на которые уже наступали (не повторять)
+
+- **Пустая карта.** `new RoomMap(rng)` ДОЛЖЕН генерировать карту в конструкторе.
+  Если карта пустая — `curRoom` будет `undefined` и всё упадёт на старте.
+- **`OPP` направлений.** Противоположное к `up` — это `down`, к `left` — `right`.
+  Любая другая раскладка ломает встречные двери и связность карты.
+- **Пол «выворачивает» перспективу.** Пол в псевдо-3D надо класть ПЛАШМЯ
+  (`flatMesh`, поворот −90° вокруг X). Без поворота он встаёт вертикально и вид
+  ломается. Спрайты/стены — `DoubleSide` (камера переворачивает Y, иначе грани отсекаются).
+- **Canvas вылезает за рамки.** Холстам нужен CSS-размер (`width/height:100%`),
+  иначе они показываются в размер HiDPI-буфера.
+- **Комната без врагов не открывается.** Если в комнате 0 врагов (сокровищница) —
+  она должна стать `cleared` сразу при входе, иначе двери не появятся.
+
+## Стиль кода
+
+- TypeScript strict, без `any` (кроме узких мест вроде `window as …` в `main.ts`).
+- Маленькие чистые функции для логики; классы — для сущностей/состояния.
+- Имена и комментарии осмысленные, по-русски. Комментарий объясняет «почему», а не «что».
+- Перед коммитом — `bun run check`.
+
+## Чего НЕ делать без явной просьбы
+
+- Не добавлять тяжёлые зависимости (физдвижки, фреймворки). База намеренно лёгкая.
+- Не переписывать архитектуру «ядро ↔ рендер».
+- Не коммитить `dist/` и `node_modules/` (см. `.gitignore`).
+- Не превращать игру в полноценное 3D, пока этого не попросили (рендер для этого
+  готов — он изолирован, — но это отдельная большая задача).
@@ -7,7 +7,7 @@
 ## Что это

 Top-down рогалик (в духе Binding of Isaac). Логика — чистый TypeScript
-(`src/core/`), рендер — three.js с ортокамерой (`src/render/`), сборка/тесты — Bun.
+(`src/core/`), рендер — three.js в псевдо-3D (наклонная `PerspectiveCamera`, `src/render/`), сборка/тесты — Bun.
 Обзор — [`README.md`](./README.md), детали — [`docs/ARCHITECTURE.md`](./docs/ARCHITECTURE.md),
 рецепты доработки — [`docs/HOWTO.md`](./docs/HOWTO.md).

@@ -64,8 +64,9 @@ bun run check      # typecheck + test
 | форму комнаты/тайлы | `src/core/world/tiles.ts`, `Room.ts` |
 | коллизии | `src/core/systems/collision.ts` |
 | расстановку врагов | `src/core/systems/spawner.ts` |
-| как рисуется мир | `src/render/ThreeRenderer.ts` |
-| цвета/внешний вид/ассеты мира | `src/render/theme.ts` |
+| как рисуется мир (псевдо-3D) | `src/render/ThreeRenderer.ts` |
+| спрайты/текстуры (графика) | `src/render/assets.ts` (бриф на художку — `docs/ASSET_BRIEF.md`) |
+| цвета/тинты/фон | `src/render/theme.ts` |
 | HUD/миникарту | `src/render/HudOverlay.ts` |
 | стартовое меню | `src/ui/StartMenu.ts` |
 | раскладку клавиш | `src/input/KeyboardController.ts` |
@@ -80,8 +81,9 @@ bun run check      # typecheck + test
  Если карта пустая — `curRoom` будет `undefined` и всё упадёт на старте.
 - **`OPP` направлений.** Противоположное к `up` — это `down`, к `left` — `right`.
  Любая другая раскладка ломает встречные двери и связность карты.
- **Чёрный экран при работающем рендере.** Ортокамера инвертирует Y → нужен
-  `DoubleSide` на материалах, иначе грани отсекаются.
+- **Пол «выворачивает» перспективу.** Пол в псевдо-3D надо класть ПЛАШМЯ
+  (`flatMesh`, поворот −90° вокруг X). Без поворота он встаёт вертикально и вид
+  ломается. Спрайты/стены — `DoubleSide` (камера переворачивает Y, иначе грани отсекаются).
 - **Canvas вылезает за рамки.** Холстам нужен CSS-размер (`width/height:100%`),
  иначе они показываются в размер HiDPI-буфера.
 - **Комната без врагов не открывается.** Если в комнате 0 врагов (сокровищница) —
@@ -0,0 +1,52 @@
+# Кодекс поведения
+
+## Наши обязательства
+
+Мы, как участники и лидеры этого проекта, обязуемся создать гостеприимную
+и безопасную среду для всех, независимо от возраста, телосложения,
+видимых или невидимых физических особенностей, этнической принадлежности,
+половых признаков, уровня опыта, образования, социально-экономического
+статуса, национальности, внешности, расы, религии или сексуальной
+идентичности и ориентации.
+
+Мы обязуемся действовать и взаимодействовать так, чтобы способствовать
+открытому, доброжелательному, инклюзивному и здоровому сообществу.
+
+## Приемлемое поведение
+
+Примеры поведения, способствующего созданию положительной среды:
+
+- Проявление доброты и эмпатии по отношению к другим участникам
+- Уважение к разным точкам зрения и опыту
+- Конструктивная обратная связь
+- Признание своих ошибок и извлечение уроков
+
+## Неприемлемое поведение
+
+- Использование сексуализированного языка или образов
+- Троллинг, оскорбительные/уничижительные комментарии
+- Преследование в любой форме
+- Публикация личной информации без явного разрешения
+- Другое поведение, которое можно обоснованно считать неуместным
+
+## Ответственность
+
+Лидеры проекта отвечают за разъяснение стандартов поведения и будут
+предпринимать соответствующие и справедливые меры в ответ на любое
+неприемлемое поведение.
+
+## Сфера действия
+
+Этот Кодекс поведения применяется во всех сообществах проекта, а также
+в публичных местах, когда человек представляет проект.
+
+## Enforcement
+
+О случаях неприемлемого поведения можно сообщать лидерам проекта.
+Все жалобы будут рассмотрены и приведут к ответным мерам, которые
+сочтут необходимыми и соответствующими обстоятельствам.
+
+## Атрибуция
+
+Этот Кодекс поведения адаптирован из [Contributor Covenant](https://www.contributor-covenant.org),
+версия 2.1.
@@ -0,0 +1,49 @@
+# Как вносить изменения
+
+Спасибо, что хочешь улучшить проект! Это живая база рогалика, и любая помощь
+пригодится. Пожалуйста, следуй правилам ниже — они сохраняют архитектуру.
+
+## Прежде чем писать код
+
+1. Прочитай [`CLAUDE.md`](./CLAUDE.md) — там золотые правила архитектуры.
+2. Почитай [`docs/HOWTO.md`](./docs/HOWTO.md) — там рецепты для типовых задач.
+3. Посмотри [`docs/ARCHITECTURE.md`](./docs/ARCHITECTURE.md) — пойми потоки данных.
+
+## Процесс
+
+1. Создай issue (баг или фича) — чтобы обсудить до начала работы.
+2. Форкни репозиторий и создай ветку от `main`:
+   ```bash
+   git checkout -b feature/что-делаешь
+   ```
+3. Пиши код, следуя стилю проекта:
+   - TypeScript strict, без `any`
+   - Комментарии по-русски, объясняют «почему», а не «что»
+   - Маленькие чистые функции; классы — для сущностей/состояния
+4. Убедись, что всё зелёное:
+   ```bash
+   bun run check   # typecheck + tests
+   ```
+5. Если менял логику — **добавь/обнови тест** в `tests/`.
+6. Если менял геймплей/рендер — **проверь в браузере** (`bun run dev`).
+7. Обнови доки, если поменялось поведение или структура.
+8. Создай Pull Request с описанием изменений.
+
+## Золотые правила (нарушать = ломать)
+
+1. **Ядро без рендера и DOM.** В `src/core/` нельзя импортировать `three`,
+   обращаться к `window`/`document`/`canvas`.
+2. **Рендер ничего не меняет в игре.** `src/render/` только читает и рисует.
+3. **Случайность только через `Rng`.** Никаких `Math.random()` в `core/`.
+4. **Время — в шагах (1/60 с).** Не двигай ничего в rAF или рендере.
+5. **Числа — не в коде.** Константы — в `src/config.ts`, параметры забега —
+   в `src/core/rules.ts`.
+6. **Освобождай ресурсы three.js** — `dispose()` геометрию/материалы при удалении.
+7. **Перед коммитом — `bun run check`.**
+
+## Чего не делать
+
+- Не добавлять тяжёлые зависимости (физдвижки, фреймворки).
+- Не переписывать архитектуру «ядро ↔ рендер».
+- Не коммитить `dist/` и `node_modules/`.
+- Не превращать игру в полноценное 3D без обсуждения.
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 VovaManul
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
@@ -1,12 +1,19 @@
-# Dungeon Crawl — рогалик в духе The Binding of Isaac
+# Биндим Фигняшку — рогалик в духе The Binding of Isaac

 Top-down рогалик: процедурный данжен из комнат, два режима боя (дальний/ближний),
-враги, босс. Логика на чистом TypeScript, рендер — на **three.js** (ортографическая
-камера, картинка плоская 2D-сверху). Сборка — **Bun**.
+враги, босс. Логика на чистом TypeScript, рендер — на **three.js** в **псевдо-3D**:
+наклонная камера, пол лежит плашмя, персонажи — вертикальные спрайты-биллборды
+(как в Isaac). Сборка — **Bun**.
+
+<p align="center">
+  <img src="./docs/assets/binding_fignyashka.png" alt="Биндим Фигняшку" width="720" />
+</p>

 Есть **стартовое меню** с выбором уровня: данжен генерируется процедурно каждый
 забег, но параметризуется набором правил (размер, плотность/сила врагов, HP, seed).
-Внешний вид мира вынесен в «тему» — задел под кастомные ассеты (спрайты/текстуры).
+Двери видны всегда (закрыты в бою, открыты после зачистки). Графика — PNG-ассеты в
+`src/assets/` (грузятся в `render/assets.ts`; при отсутствии файла — процедурный
+фолбэк). Бриф на художку — `docs/ASSET_BRIEF.md`.

 > Это рабочая **база для развития**, а не готовая игра. Архитектура специально
 > сделана так, чтобы её было легко расширять — и человеку, и ИИ-агентам.
@@ -44,6 +51,9 @@ bun run check      # и то, и другое разом
 | R | заново (на экране Game Over / Victory) |
 | Esc | вернуться в меню выбора уровня |

+Клавиши привязаны к **физическим** кнопкам (`event.code`), поэтому WASD/Q/R работают
+в любой раскладке (в т.ч. русской), независимо от языка ввода.
+
 Чтобы перейти в соседнюю комнату — зачисти текущую (двери откроются) и встань на
 дверь, нажимая в её сторону.

@@ -66,7 +76,7 @@ bun run check      # и то, и другое разом
 ## Стек и устройство

 - **Bun** — рантайм, бандлер и тест-раннер.
- **three.js** — WebGL-рендер мира через ортокамеру.
+- **three.js** — WebGL-рендер мира в псевдо-3D (наклонная `PerspectiveCamera`, биллборд-спрайты).
 - **TypeScript (strict)** — весь код.
 - Архитектура: **логика игры полностью отделена от рендера**. Ядро (`src/core/`)
  не знает ни про DOM, ни про three.js, поэтому его легко тестировать и при
@@ -94,8 +104,9 @@ src/
 │   └── KeyboardController.ts  клавиатура → InputState
 ├── render/                ── РЕНДЕР (читает состояние, рисует) ──
 │   ├── Renderer.ts        интерфейс рендера
-│   ├── ThreeRenderer.ts   мир на three.js (ортокамера)
-│   ├── theme.ts           ⭐ ВНЕШНИЙ ВИД (цвета; задел под спрайты/текстуры)
+│   ├── ThreeRenderer.ts   мир на three.js (псевдо-3D: наклон + биллборды)
+│   ├── assets.ts          ⭐ АССЕТЫ (процедурные спрайты/текстуры → текстуры three.js)
+│   ├── theme.ts           цвета/тинты мира (фон, эффекты)
 │   └── HudOverlay.ts      HUD и миникарта на 2D-канвасе поверх
 ├── ui/
 │   └── StartMenu.ts       стартовое меню (DOM) с выбором уровня
@@ -0,0 +1,24 @@
+# Политика безопасности
+
+## Поддерживаемые версии
+
+Активно разрабатывается только `main`-ветка. Стабильных релизов пока нет.
+
+| Версия | Поддержка |
+|---|---|
+| main (активная разработка) | ✅ |
+| Другие ветки | ❌ |
+
+## Сообщить об уязвимости
+
+Это локальная однопользовательская игра на Canvas/WebGL. Уязвимости
+безопасности маловероятны, но если найдёшь что-то серьёзное:
+
+- **Не создавай публичный issue.**
+- Напиши в [issues](https://github.com/VovaManul/Binding-Fignyaac/issues)
+  с пометкой `[SECURITY]` в заголовке — репозиторий приватный/маленький,
+  это безопасно.
+
+По умолчанию: игра не принимает пользовательский ввод, кроме клавиатуры,
+и не выполняет удалённый код. Риск сводится к XSS через `dist/index.html`
+при сборке — убедись, что билд чистый (`bun run build` из свежего клона).
@@ -3,6 +3,7 @@
 * плюс копия index.html. Открывай dist/index.html.
 */
 import { build } from 'bun';
+import { cp, mkdir } from 'node:fs/promises';

 const result = await build({
  entrypoints: ['./src/main.ts'],
@@ -19,4 +20,20 @@ if (!result.success) {
 }

 await Bun.write('./dist/index.html', await Bun.file('./index.html').text());
+
+// Копируем картинки в dist/<asset-pack> (если папка есть).
+try {
+  await mkdir('./dist/assets', { recursive: true });
+  await cp('./src/assets', './dist/assets', { recursive: true });
+} catch {
+  // src/assets ещё нет — не страшно, рендер откатится на процедурную графику.
+}
+
+try {
+  await mkdir('./dist/assets-binding-2', { recursive: true });
+  await cp('./src/assets-binding-2', './dist/assets-binding-2', { recursive: true });
+} catch {
+  // Второй пак ассетов опционален.
+}
+
 console.log('Сборка готова → dist/ (открой dist/index.html)');
@@ -1,5 +1,6 @@
 {
  "lockfileVersion": 1,
+  "configVersion": 0,
  "workspaces": {
    "": {
      "name": "dungeon-crawl",
@@ -22,6 +22,12 @@ const server = Bun.serve({
    if (url.pathname === '/' || url.pathname === '/index.html') {
      return new Response(Bun.file('./index.html'));
    }
+    // Картинки отдаём прямо из src/<asset-pack>/ — положил PNG → сразу подхватился.
+    if (url.pathname.startsWith('/assets/') || url.pathname.startsWith('/assets-binding-2/')) {
+      const asset = Bun.file('./src' + url.pathname);
+      if (await asset.exists()) return new Response(asset);
+      return new Response('Not found', { status: 404 });
+    }
    const file = Bun.file('./dist' + url.pathname);
    if (await file.exists()) return new Response(file);
    return new Response('Not found', { status: 404 });
@@ -37,7 +37,8 @@
 Старый код двигал всё прямо в `requestAnimationFrame`, поэтому скорость игры
 зависела от частоты монитора (на 144 Гц — в 2.4× быстрее). Теперь:

-1. Раз в кадр опрашиваем ввод (`controller.poll()`).
+1. Раз в кадр опрашиваем источник ввода (`controller.poll()`). Цикл знает только
+   маленький интерфейс `poll(): InputState`, а не конкретную клавиатуру.
 2. Однократные действия (смена оружия, рестарт) — `game.consumeActions(input)`.
 3. Копим реальное время в аккумуляторе и вызываем `game.step(input)` фиксированными
   порциями по `1/60` секунды. Сколько бы ни был лаг — логика всегда идёт 60 шагов/с.
@@ -66,10 +67,11 @@

 ## Ввод (input/)

-`InputState` — снимок намерений: оси движения, направление прицела, флаги
+`InputState` — снимок намерений: оси движения, вектор прицела, флаги
 удержания и однократные «edge»-действия. Делится на:

- **удерживаемые** (`moveX/Y`, `aimDir`, `attackHeld`) — читаются каждый шаг;
+- **удерживаемые** (`moveX/Y`, `aimVec`, `attackHeld`) — читаются каждый шаг;
+  `aimVec` — вектор из стрелок, поддерживает 8 направлений (вкл. диагонали);
 - **однократные** (`toggleWeapon`, `restart`) — срабатывают один раз на нажатие;
  поэтому они обрабатываются в `consumeActions()` раз в кадр, а не в `step()`.

@@ -105,26 +107,52 @@
 - **`#hud`** — 2D-канвас поверх, `HudOverlay` рисует HP, индикатор режима,
  счётчик врагов, подпись комнаты, миникарту и оверлеи Game Over/Victory.

-### ThreeRenderer — ортокамера и «плоское 2D»
+### ThreeRenderer — псевдо-3D (наклонный вид, как в Isaac)

- `OrthographicCamera(0, CW, 0, CH, …)` отображает мировые координаты **один в
-  один** в пиксельные (x вправо, y вниз). Поэтому вся математика ядра валидна без
-  пересчётов. Слои по `z` (пол < стены < сущности < снаряды).
- Камера переворачивает ось Y → инвертируется порядок вершин → при обычном
-  отсечении задних граней плоскости были бы невидимы. Поэтому все материалы —
-  **`DoubleSide`** (правильный выбор для плоских спрайтов).
+Логика остаётся 2D-сверху, но РЕНДЕР — псевдо-3D:

-> **Исторический баг №3.** Именно из-за инверсии Y и отсечения граней мир рисовался
-> «в пустоту» (чёрный экран при работающих draw-call). Лечится `DoubleSide`.
+- **Карта координат:** игровая точка `(x, y)` кладётся на пол в 3D как `(x, 0, y)`
+  — пол это плоскость `Y=0`, вверх это `+Y`, «низ» игры (`y`) идёт в глубину (`Z`).
+  Поэтому вся математика и **коллизии ядра без изменений** — псевдо-3D чисто визуальный.
+- **Камера** — `PerspectiveCamera`, наклонная и фиксированная на комнату (приподнята и
+  отодвинута на «юг», смотрит вниз-вперёд ≈50°). Кадрирует комнату целиком.
+- **Пол** — одна горизонтальная плоскость с бесшовной текстурой (повтор по сетке).
+  ⚠️ Плоскость кладём ПЛАШМЯ через `flatMesh()` (поворот −90° вокруг X). Если забыть
+  поворот — пол встанет вертикально и перспектива «вывернется» (был такой баг).
+- **Стены** — вертикальные плоскости по периметру с проёмами под двери.
+- **Персонажи/враги/двери/снаряды** — ВЕРТИКАЛЬНЫЕ спрайты-биллборды (плоскости в XY,
+  нормаль +Z), стоящие на полу: центр на `y = высота/2`, низ на полу. Текстуры — из
+  `assets.ts` (см. ниже). Материалы — `DoubleSide` (наша камера переворачивает Y, иначе
+  грани отсеклись бы) + `alphaTest` для чёткого контура спрайта.
+- **Двери всегда видимы:** рисуются из `room.doors` независимо от зачистки — закрытые
+  (засов) пока `!cleared`, открытый проём после. Группа комнаты пересобирается при смене
+  комнаты ИЛИ смене флага `cleared`.
+- **Тени** — отдельный плоский спрайт-«пятно» под каждой сущностью.
+
+### Ассеты (render/assets.ts)
+
+`Assets` грузит текстуры из `src/assets/<ключ>.png` (спрайты персонажей, пол, стены,
+двери, снаряд, эффекты, тень) и кэширует их; если PNG нет — рисует процедурный фолбэк
+на `<canvas>`, поэтому игра не ломается без ассетов. Dev-сервер отдаёт `/assets/*` из
+`src/assets/`, прод-сборка копирует их в `dist/assets/`. Подмена/добавление графики —
+`docs/HOWTO.md` и `docs/ASSET_BRIEF.md`. Ключи ассетов едины в рендере, брифе и именах файлов.
+
+### Эффекты оружия
+
+Рендер сам распознаёт события по состоянию (ядро не трогаем):
+- вспышка из дула — когда `player.atkCD` «подскочил» (выстрел);
+- искра — когда у врага вырос `hitTimer` (попадание);
+- облачко-«пуф» — когда мёртвый враг исчезает из комнаты.
+Эффекты — короткоживущие аддитивные спрайты-биллборды, гаснут по таймеру.

 ### Управление ресурсами GPU (важно — иначе утечки)

- Общие геометрии-«единицы» (`unitPlane`, `unitCircle`) масштабируются под размер
-  сущности — не плодим геометрии.
- Тайлы комнаты пересобираются **только при смене комнаты**.
- Меши сущностей создаются/удаляются по факту появления/исчезновения
-  (mark-and-sweep в `sync*`), их персональные материалы корректно `dispose()`-ятся.
- Общие ресурсы освобождаются один раз в `dispose()`.
+- Общие геометрии переиспользуются масштабированием — не плодим геометрии.
+- Группа комнаты (пол/стены/двери) пересобирается только при смене комнаты/`cleared`;
+  персональные материалы дверей `dispose()`-ятся при пересборке.
+- Спрайты сущностей и эффекты создаются/удаляются по факту появления/исчезновения
+  (mark-and-sweep), их персональные материалы корректно `dispose()`-ятся.
+- Общие материалы/геометрии и `Assets` освобождаются один раз в `dispose()`.

 ## HiDPI

@@ -163,6 +191,11 @@ LevelRules ──► Game(rules) ──► RoomMap(rng, rules)   // размер
                          └──► spawnEnemies(..., rules) // число/тип/сила врагов (множители)
 ```

+В бесконечном спуске выбранный `rules` остаётся базовым пресетом забега, а
+`Game` хранит отдельный активный снимок правил текущего этажа. Новая карта и
+спавн врагов должны брать именно активные правила этажа, иначе данжен растёт, но
+враги остаются с балансом первого этажа.
+
 Граница: **геометрия движка** (размер тайла/комнаты, геометрия дверей) живёт в
 `config.ts` и не меняется от уровня к уровню; **правила забега** — в `rules.ts`.
 `config` задаёт базовые значения, `rules` — поверх (например, множители HP врагов).
@@ -0,0 +1,105 @@
+# Бриф на ассеты — «Биндим Фигняшку»
+
+Документ для генерации/догенерации графики (через Claude/дизайн-ИИ или художника).
+Ниже — **готовый промпт** (можно копировать целиком) и **таблица ассетов**.
+
+> ✅ **Статус: набор уже подключён.** 21 PNG лежат в `src/assets/` и автоматически
+> грузятся `src/render/assets.ts` по имени файла (`assets/<ключ>.png`); если какого-то
+> файла нет — рисуется процедурный фолбэк. Этот бриф нужен, чтобы **догенерировать или
+> заменить** ассеты: достаточно положить PNG с тем же именем в `src/assets/`.
+
+---
+
+## Готовый промпт (копировать целиком)
+
+> Ты — художник 2D-игр. Сделай ПОЛНЫЙ набор ассетов для рогалика «Биндим Фигняшку»
+> в духе The Binding of Isaac.
+>
+> **Игра и ракурс.** Вид сверху под наклоном (псевдо-3D): пол лежит плашмя и виден под
+> углом ≈50° (камера приподнята и смотрит вниз-вперёд), а персонажи и враги — это
+> ВЕРТИКАЛЬНЫЕ спрайты-биллборды, стоящие на полу и обращённые к камере (фронтальный
+> вид, чуть сверху). Стены — невысокий бортик по периметру комнаты. Комната — прямоугольник
+> 15×11 тайлов.
+>
+> **Стиль.** Мрачное подземелье, мультяшно-гротескный, читаемые силуэты, плотные тёмные
+> контуры, без мелкой суеты — всё должно читаться на маленьком размере. Допустимы пиксель-арт
+> ИЛИ чистый векторно-мультяшный стиль — но ЕДИНЫЙ для всего набора.
+>
+> **Палитра.** Пол — светлый серо-песочный камень (≈#6b6657), стены — холодный сине-серый
+> кирпич (≈#47475a). Поэтому персонажи/враги должны быть НАСЫЩЕННЫМИ и контрастными, чтобы
+> выделяться на светлом полу. Игрок дальнего боя — синий, ближнего — красный. Враги: «обычный» —
+> тёплый терракот, «быстрый» — ярко-красный, «босс» — тёмно-багровый с рогами.
+>
+> **Технические требования (обязательно):**
+> - PNG с прозрачным фоном (alpha), без подложки и без «приваренной» тени/пола.
+> - Спрайты персонажей/врагов/дверей — ВЕРТИКАЛЬНЫЕ, соотношение 3:4 (ширина:высота),
+>   персонаж по центру, СТУПНИ у самого нижнего края кадра (мы «ставим» спрайт на пол по низу).
+> - Текстуры пола и стен — БЕСШОВНЫЕ (tileable), повторяются по сетке.
+> - Эффекты (вспышка/искра/дымок) — на прозрачном фоне, со светлым (почти белым) центром,
+>   чтобы их можно было тонировать цветом в движке; рассчитаны на аддитивное смешивание.
+> - Никаких теней под персонажем внутри спрайта — тень рисуется отдельным ассетом.
+> - Единая «толщина пикселя»/уровень детализации во всём наборе.
+>
+> **Что нарисовать** — см. список ниже (каждый пункт = отдельный файл с указанным именем
+> и размером). Пришли файлы по этим именам (или один атлас + JSON-карта координат).
+
+(Дальше вставь таблицу ассетов из этого файла.)
+
+---
+
+## Таблица ассетов
+
+Имена файлов соответствуют ключам в `src/render/assets.ts` — присылай ровно с такими именами.
+
+### Персонажи и враги (вертикальные спрайты 3:4, прозрачный фон, ступни у нижнего края)
+
+| Файл | Что | Рекоменд. размер | Заметки |
+|---|---|---|---|
+| `player-ranged.png` | Игрок, режим «дальний» (с пистолетом) | 192×256 | синий; большая голова в духе Isaac |
+| `player-melee.png` | Игрок, режим «ближний» (с ножом) | 192×256 | красный; та же база, другое оружие/цвет |
+| `enemy-normal.png` | Обычный враг | 192×256 | терракот, медлительный, «толстенький» |
+| `enemy-fast.png` | Быстрый враг | 160×213 | ярко-красный, мельче, «дёрганый» |
+| `enemy-boss.png` | Босс | 288×384 | тёмно-багровый, рога, крупный и злой |
+
+> Опционально (на будущее, не обязательно сейчас): по 4 ракурса на персонажа
+> (вверх/вниз/влево/вправо) — тогда добавь суффиксы `-up/-down/-left/-right`.
+
+### Окружение
+
+| Файл | Что | Рекоменд. размер | Заметки |
+|---|---|---|---|
+| `floor.png` | Текстура пола | 256×256 | **бесшовная**, светлый серо-песочный камень, без сильных направленных деталей (виден под углом) |
+| `wall.png` | Текстура стены | 256×256 | **бесшовная**, сине-серый кирпич |
+| `door-closed.png` | Закрытая дверь (засов) | 192×256, 3:4 | стоит в проёме стены; видна во время боя |
+| `door-open.png` | Открытая дверь (тёмный проём/арка) | 192×256, 3:4 | после зачистки комнаты |
+
+### Снаряды и эффекты (прозрачный фон, светлый центр, под аддитивное смешивание)
+
+| Файл | Что | Рекоменд. размер | Заметки |
+|---|---|---|---|
+| `tear.png` | Снаряд-«слеза» игрока | 64×64 | голубая светящаяся капля |
+| `muzzle.png` | Вспышка из дула при выстреле | 128×128 | радиальная жёлто-белая |
+| `spark.png` | Искра попадания по врагу | 128×128 | бело-жёлтая, короткая |
+| `puff.png` | Облачко при гибели врага | 128×128 | серо-белое, рассеивается |
+| `shadow.png` | Мягкая тень-«пятно» под сущностью | 128×64 | чёрный радиальный градиент, эллипс |
+
+### Интерфейс и меню (опционально, но желательно)
+
+| Файл | Что | Рекоменд. размер | Заметки |
+|---|---|---|---|
+| `logo.png` | Логотип «Биндим Фигняшку» | 900×220 | прозрачный фон, для стартового меню |
+| `menu-bg.png` | Фон стартового меню | 880×660 | тёмное подземелье, не пёстрый (поверх — текст) |
+| `heart-full.png` / `heart-half.png` / `heart-empty.png` | Сердечки HP | 48×48 | замена полоске HP на сердечки (как в Isaac) |
+| `icon-ranged.png` / `icon-melee.png` | Иконки режимов (пистолет/нож) | 48×48 | для индикатора оружия в HUD |
+
+---
+
+## Как это подключено (уже работает)
+
+1. PNG лежат в `src/assets/` с именами-ключами (`floor.png`, `player-ranged.png`, …).
+2. `src/render/assets.ts` грузит их в рантайме через `THREE.TextureLoader` по пути
+   `assets/<ключ>.png` (НЕ импорт-бандлингом). Нет файла → процедурный фолбэк `drawX()`.
+3. Dev-сервер отдаёт `/assets/*` из `src/assets/`; прод-сборка копирует их в `dist/assets/`.
+4. HUD-ассеты (`heart-*`, `icon-*`) грузит `HudOverlay`, меню (`logo`, `menu-bg`) — `index.html`.
+
+**Заменить/добавить:** просто положи PNG с тем же именем в `src/assets/` — подхватится само.
@@ -0,0 +1,363 @@
+# Промпты для ассетов: «Биндинг 2.0»
+
+Этот файл нужен, чтобы сгенерировать второй набор ассетов в стиле постера
+`docs/assets/binding_fignyashka.png`, но в формате, который легко положить в игру
+и при необходимости вырезать руками.
+
+## Как пользоваться
+
+1. В генераторе сначала загрузи постер `docs/assets/binding_fignyashka.png` как
+   style reference, если сервис это поддерживает.
+2. Скопируй **базовый промпт** ниже в начало каждой генерации.
+3. Ниже по файлу копируй промпт конкретного ассета.
+4. Сохраняй результат ровно с указанным именем файла.
+
+Если генератор плохо делает прозрачный фон, проси однотонный chroma key:
+`pure #00ff00 background, no shadow, no glow touching the background`, затем
+удаляй фон любым инструментом. Для игры лучше PNG с alpha.
+
+## Базовый промпт
+
+```text
+Use the uploaded poster "Биндим Фигняшку" as the style reference only.
+
+Create one game asset for a top-down roguelike called "Биндинг 2.0".
+Style: grotesque dark cartoon dungeon art, chunky hand-painted shapes, high contrast, juicy slime colors, thick uneven black-purple outlines, expressive silly-horror faces, grimy stone dungeon details, saturated neon accents, readable silhouette at small size.
+
+Technical requirements:
+- One isolated asset only, centered.
+- Transparent PNG background with clean alpha.
+- If transparent background is not possible: pure #00ff00 chroma key background, no gradients, no contact shadow, no glow touching the background.
+- No text, no letters, no watermark, no UI frame, no mockup, no floor under the object, no baked shadow, unless the specific prompt asks for logo/menu background/floor/wall/shadow.
+- Keep the whole object inside the canvas with 8-12% padding.
+- Use the requested exact canvas size and filename.
+- Front-facing billboard sprite for characters, slightly top-down camera feel, feet aligned near the bottom edge.
+- Same lighting, palette, outline thickness, and detail density across all assets.
+- Make it easy to cut out: crisp silhouette, transparent outside pixels, no loose dust outside the silhouette.
+
+Negative prompt:
+photorealistic, realistic gore, anime, flat vector icon, pixel art, low contrast, blurry edges, tiny unreadable details, background scene, multiple objects, text, signature, watermark, drop shadow, floor shadow, square UI border, cropped body, cut off feet
+```
+
+## Персонажи и враги
+
+### `player-ranged.png` — игрок с дальним оружием, 192x256
+
+```text
+Asset: player-ranged.png, canvas 192x256.
+
+Small grotesque hero, huge uneven eyes, patched purple hood with little horns, anxious grin, compact body, holding a weird toy-like slime pistol or water gun pointed diagonally down-right. Blue/cyan weapon glow, tiny dungeon grime, funny horror expression. Full body, front-facing billboard sprite, feet at the bottom edge, transparent background.
+```
+
+### `player-melee.png` — игрок с ближним оружием, 192x256
+
+```text
+Asset: player-melee.png, canvas 192x256.
+
+Same hero as player-ranged, same face and purple hood, but holding a ridiculous melee weapon: toilet brush, rusty knife, or plunger club. Warmer red/orange accents, aggressive grin, ready to swing. Full body, front-facing billboard sprite, feet at the bottom edge, transparent background.
+```
+
+### `enemy-normal.png` — обычный враг, 192x256
+
+```text
+Asset: enemy-normal.png, canvas 192x256.
+
+Round lumpy dungeon monster, terracotta-pink skin, one lazy eye and one tiny eye, small teeth, stubby legs, goofy but hostile. Thick black-purple outline, slime spots, readable chunky silhouette. Full body, front-facing billboard sprite, feet at the bottom edge, transparent background.
+```
+
+### `enemy-fast.png` — быстрый враг, 160x213
+
+```text
+Asset: enemy-fast.png, canvas 160x213.
+
+Small twitchy fast monster, red bug-like gobbet, long thin legs, bulging eyes, frantic expression, motion-ready pose but not blurred. Bright red and magenta accents, sharp silhouette. Full body, front-facing billboard sprite, feet at the bottom edge, transparent background.
+```
+
+### `enemy-boss.png` — босс, 288x384
+
+```text
+Asset: enemy-boss.png, canvas 288x384.
+
+Huge grotesque boss head-body hybrid, swollen pink-brown flesh, mismatched giant eyes, crown made of junk metal, open screaming mouth, tiny arms with a plunger hammer. Dark dungeon grime, purple slime rim light, very readable massive silhouette. Full body, front-facing billboard sprite, base at bottom edge, transparent background.
+```
+
+### `enemy-charger.png` — рывковый враг, 192x256
+
+```text
+Asset: enemy-charger.png, canvas 192x256.
+
+Aggressive charger monster, red-orange flesh, low hunched body, one horn or metal spike on forehead, angry slit eyes, oversized jaw, pose leaning forward like it is about to rush. Thick outline, neon orange highlights. Full body, front-facing billboard sprite, feet at bottom edge, transparent background.
+```
+
+### `enemy-tank.png` — тяжёлый враг, 224x288
+
+```text
+Asset: enemy-tank.png, canvas 224x288.
+
+Heavy tank monster, bulky stone-and-flesh body, cracked skull plates, slow stupid face, tiny eyes, big square jaw, metal rivets embedded in skin. Dark brown, grey, bruised purple palette. Full body, front-facing billboard sprite, feet/base at bottom edge, transparent background.
+```
+
+### `enemy-shooter.png` — стрелок, 192x256
+
+```text
+Asset: enemy-shooter.png, canvas 192x256.
+
+Shooter monster, bluish sickly body, huge single watery eye, tiny nozzle mouth or fish-gun growth, cheeks full of glowing slime projectile. Cyan/green spit glow, nervous mean expression. Full body, front-facing billboard sprite, feet at bottom edge, transparent background.
+```
+
+## Окружение
+
+### `floor.png` — бесшовный пол, 256x256
+
+```text
+Asset: floor.png, canvas 256x256.
+
+Seamless tileable dungeon floor texture, top-down stone slabs from the poster style, dark grey-brown stones, subtle purple grime, tiny cracks, small slime stains, no strong directional light, no objects, no text. Must tile perfectly on all edges.
+```
+
+### `wall.png` — бесшовная стена, 256x256
+
+```text
+Asset: wall.png, canvas 256x256.
+
+Seamless tileable dungeon wall brick texture, cold blue-grey bricks, black-purple mortar, moss and slime in cracks, hand-painted chunky style, no perspective object, no text. Must tile perfectly on all edges.
+```
+
+### `door-closed.png` — закрытая дверь, 192x256
+
+```text
+Asset: door-closed.png, canvas 192x256.
+
+Closed dungeon doorway sprite, arched stone frame, chunky wooden planks, heavy golden latch/bar, purple slime outline, front-facing vertical billboard object. Transparent background outside the door frame, no floor, no shadow.
+```
+
+### `door-open.png` — открытая дверь, 192x256
+
+```text
+Asset: door-open.png, canvas 192x256.
+
+Open dungeon doorway sprite, arched stone frame, dark black interior void, broken wooden bits, purple slime rim light, front-facing vertical billboard object. Transparent background outside the door frame, no floor, no shadow.
+```
+
+### `chest.png` — сундук, 192x192
+
+```text
+Asset: chest.png, canvas 192x192.
+
+Treasure chest object, red-brown wood, gold metal bands, one goofy eye-shaped lock, tiny slime drips, cute-horror style from the poster. Isolated object, three-quarter top-down object view, transparent background, no shadow.
+```
+
+### `pickup.png` — универсальный пикап, 128x128
+
+```text
+Asset: pickup.png, canvas 128x128.
+
+Floating weapon pickup marker, glowing golden-purple diamond with slime sparkle, chunky outline, readable at small size. Isolated object, transparent background, no shadow.
+```
+
+## Снаряды и эффекты
+
+### `tear.png` — слеза, 64x64
+
+```text
+Asset: tear.png, canvas 64x64.
+
+Single glowing blue tear projectile, chunky droplet shape, white highlight, cyan edge glow contained inside transparent canvas. No trail, no shadow, transparent background.
+```
+
+### `fireball.png` — огненный шар, 64x64
+
+```text
+Asset: fireball.png, canvas 64x64.
+
+Single grotesque fireball projectile, orange-red slime flame orb, white-yellow hot center, small black-purple outline, contained glow, transparent background, no trail.
+```
+
+### `beam.png` — луч лазера, 128x128
+
+```text
+Asset: beam.png, canvas 128x128.
+
+Laser impact/beam blob sprite, bright white-cyan center with electric blue-purple rim, circular radial energy burst suitable for additive blending, transparent background, no hard square edges.
+```
+
+### `muzzle.png` — вспышка выстрела, 128x128
+
+```text
+Asset: muzzle.png, canvas 128x128.
+
+Muzzle flash effect sprite, white-hot center, yellow-orange starburst, purple edge sparks, soft radial alpha, designed for additive blending. Transparent background.
+```
+
+### `spark.png` — искра попадания, 128x128
+
+```text
+Asset: spark.png, canvas 128x128.
+
+Hit spark effect sprite, jagged white-yellow impact burst with tiny purple fragments, clear center, fades to transparent edges, designed for additive blending. Transparent background.
+```
+
+### `puff.png` — дымок смерти, 128x128
+
+```text
+Asset: puff.png, canvas 128x128.
+
+Cartoon death puff cloud, grey-white smoke with purple grime, soft edges, funny splat-cloud shape, fades to transparent, no hard outline outside the cloud. Transparent background.
+```
+
+### `shadow.png` — тень, 128x64
+
+```text
+Asset: shadow.png, canvas 128x64.
+
+Soft oval blob shadow, black center fading smoothly to full transparency, no colored tint, no hard edge. Transparent PNG, exactly one horizontal ellipse.
+```
+
+## HUD и меню
+
+### `logo.png` — логотип, 900x220
+
+```text
+Asset: logo.png, canvas 900x220.
+
+Logo text in Russian: "Биндим Фигняшку".
+Use the exact poster lettering vibe: chunky slime letters, green top word "Биндим", orange-yellow bottom word "Фигняшку", purple slime outline, black thick shadow. Transparent background. No extra characters, no subtitle, no watermark.
+```
+
+### `menu-bg.png` — фон меню, 880x660
+
+```text
+Asset: menu-bg.png, canvas 880x660.
+
+Dark dungeon menu background in the same poster style, top-down room fragments, dim torches, purple slime, scattered silly-horror props. No text, no logo, no centered character, leave the central area readable for UI overlay. Full rectangular background, not transparent.
+```
+
+### `heart-full.png` — полное сердце, 48x48
+
+```text
+Asset: heart-full.png, canvas 48x48.
+
+Full HP heart icon, red fleshy cartoon heart, thick dark outline, tiny slime highlight, readable at 24 px. Transparent background, no shadow.
+```
+
+### `heart-half.png` — половина сердца, 48x48
+
+```text
+Asset: heart-half.png, canvas 48x48.
+
+Half HP heart icon matching heart-full, left half full red flesh, right half dark empty husk, thick dark outline, readable at 24 px. Transparent background, no shadow.
+```
+
+### `heart-empty.png` — пустое сердце, 48x48
+
+```text
+Asset: heart-empty.png, canvas 48x48.
+
+Empty HP heart icon matching heart-full, dark cracked heart outline with hollow center, subtle purple grime, readable at 24 px. Transparent background, no shadow.
+```
+
+### `icon-ranged.png` — иконка дальнего режима, 48x48
+
+```text
+Asset: icon-ranged.png, canvas 48x48.
+
+Ranged mode HUD icon, tiny goofy slime pistol firing one blue tear, thick outline, high contrast, readable at 24 px. Transparent background, no shadow.
+```
+
+### `icon-melee.png` — иконка ближнего режима, 48x48
+
+```text
+Asset: icon-melee.png, canvas 48x48.
+
+Melee mode HUD icon, tiny ridiculous knife/plunger/brush weapon, red-orange accent, thick outline, high contrast, readable at 24 px. Transparent background, no shadow.
+```
+
+## Иконки оружия
+
+### `weapon-icon-tears.png`, 48x48
+
+```text
+Asset: weapon-icon-tears.png, canvas 48x48.
+
+Weapon icon for "Слёзы": single blue tear orb with white highlight, chunky outline, readable at 24 px. Transparent background, no shadow.
+```
+
+### `weapon-icon-melee.png`, 48x48
+
+```text
+Asset: weapon-icon-melee.png, canvas 48x48.
+
+Weapon icon for "Кулак": goofy clenched fist, bruised peach color, thick dark outline, tiny slime detail, readable at 24 px. Transparent background, no shadow.
+```
+
+### `weapon-icon-shotgun.png`, 48x48
+
+```text
+Asset: weapon-icon-shotgun.png, canvas 48x48.
+
+Weapon icon for "Дробовик": three small glowing pellets spreading outward, yellow-orange centers, dark outline, readable at 24 px. Transparent background, no shadow.
+```
+
+### `weapon-icon-axe.png`, 48x48
+
+```text
+Asset: weapon-icon-axe.png, canvas 48x48.
+
+Weapon icon for "Топор": rusty cartoon axe with chipped metal head and short handle, purple grime, thick outline, readable at 24 px. Transparent background, no shadow.
+```
+
+### `weapon-icon-staff.png`, 48x48
+
+```text
+Asset: weapon-icon-staff.png, canvas 48x48.
+
+Weapon icon for "Посох": crooked wooden staff with glowing orange fire gem, tiny slime drips, thick outline, readable at 24 px. Transparent background, no shadow.
+```
+
+### `weapon-icon-whip.png`, 48x48
+
+```text
+Asset: weapon-icon-whip.png, canvas 48x48.
+
+Weapon icon for "Хлыст": curled leather whip, exaggerated curve, warm brown with purple rim, thick outline, readable at 24 px. Transparent background, no shadow.
+```
+
+### `weapon-icon-bomb.png`, 48x48
+
+```text
+Asset: weapon-icon-bomb.png, canvas 48x48.
+
+Weapon icon for "Бомба": round black cartoon bomb with lit fuse, orange spark, silly eye-like rivet, thick outline, readable at 24 px. Transparent background, no shadow.
+```
+
+### `weapon-icon-boomerang.png`, 48x48
+
+```text
+Asset: weapon-icon-boomerang.png, canvas 48x48.
+
+Weapon icon for "Бумеранг": crooked wooden boomerang with teeth marks and purple slime stripe, thick outline, readable at 24 px. Transparent background, no shadow.
+```
+
+### `weapon-icon-laser.png`, 48x48
+
+```text
+Asset: weapon-icon-laser.png, canvas 48x48.
+
+Weapon icon for "Лазер": compact blue-white laser emitter crystal or ray gun barrel, cyan glow contained inside icon, thick outline, readable at 24 px. Transparent background, no shadow.
+```
+
+## После генерации
+
+Сложи файлы второго набора в отдельную папку, например:
+
+```text
+src/assets-binding-2/
+```
+
+Потом можно добавить выбор в меню:
+
+- `Классика` -> текущая папка `src/assets/`;
+- `Биндинг 2.0` -> новая папка `src/assets-binding-2/`.
+
+Когда ассеты будут готовы, самый чистый следующий шаг в коде: дать `Assets` параметр
+`packPath` и прокинуть выбранный пак из `StartMenu` в `ThreeRenderer`/`HudOverlay`.
@@ -28,8 +28,10 @@
   ```
 3. **`src/core/systems/spawner.ts`** — реши, когда он спавнится (логика выбора типа
   в начале цикла). Напр. с шансом: `rng.chance(0.15) ? 'tank' : rng.chance(ENEMY.fastChance) ? 'fast' : 'normal'`.
-4. **`src/render/ThreeRenderer.ts`** — цвет в `COLOR` и выбор цвета/геометрии в
-   `syncEnemies` (квадрат `unitPlane` или круг `unitCircle`).
+4. **`src/render/assets.ts`** — добавь ключ в `SpriteKey` и ветку в `Assets.sprite()`
+   (рисуется через `drawCharacter(...)` с твоими цветами).
+5. **`src/render/ThreeRenderer.ts`** — добавь строку в `enemyMatKey`, сопоставив новый
+   `Enemy['type']` этому `SpriteKey` (без этого не пройдёт проверка типов).

 ИИ, урон, отбрасывание, мигание при попадании — общие, их трогать не нужно.
 Добавь тест в `tests/spawner.test.ts`, если ввёл особое правило спавна.
@@ -111,9 +113,21 @@

 ---

-## 8. Кастомные ассеты (своя тема / текстуры)
+## 8. Кастомные ассеты (спрайты, текстуры, тема)

-Сейчас вид мира — это цвета в **`src/render/theme.ts`** (`Theme` + `DEFAULT_THEME`).
+Графика грузится из PNG в **`src/assets/`** (класс `Assets` в `src/render/assets.ts`
+тянет `assets/<ключ>.png` через `THREE.TextureLoader`); если файла нет — рисуется
+процедурный фолбэк на canvas, и игра не ломается.
+
+- **Свой/новый ассет:** просто положи PNG с именем `<ключ>.png` в **`src/assets/`**
+  (dev-сервер отдаёт их сразу, прод-сборка копирует в `dist/assets`). Код менять не нужно.
+  Ключи = именам файлов (`player-ranged`, `enemy-boss`, `floor`, `door-closed`, `tear`,
+  `heart-full`, `icon-ranged`, …); полный список и промпт для дизайн-ИИ — в **`docs/ASSET_BRIEF.md`**.
+- **Запасной рисунок (фолбэк):** функции `drawX()` в `assets.ts` — правь их, только если
+  нужен другой плейсхолдер на случай отсутствия PNG.
+- **Цвета/тинты/фон** (не текстуры) — в **`src/render/theme.ts`** (`Theme` + `DEFAULT_THEME`).
+- **HUD-ассеты** (сердечки `heart-*`, иконки `icon-*`) грузит `HudOverlay`; меню (`logo`,
+  `menu-bg`) — `index.html`. Те же имена в `src/assets/`.

 - **Своя палитра:** сделай ещё один объект `Theme` и передай его в
  `new ThreeRenderer(canvas, myTheme)` в `main.ts`. Сейчас рендер создаётся один
@@ -133,10 +147,11 @@
 Рендер изолирован за интерфейсом **`src/render/Renderer.ts`** (`render(game, alpha)`
 + `dispose()`). Варианты:

- **Доработать вид** (спрайты, текстуры, частицы) — внутри `ThreeRenderer`.
- **Сделать 3D** — поменяй `OrthographicCamera` на `PerspectiveCamera`, добавь
-  свет и 3D-меши. Мир рисуется по тем же координатам сущностей из `Game` — логику
-  менять не нужно.
+- **Доработать вид** (спрайты, текстуры, частицы) — внутри `ThreeRenderer` (камера
+  уже наклонная `PerspectiveCamera`, сущности — биллборд-спрайты).
+- **Усилить 3D** — для настоящего объёма замени `MeshBasicMaterial` (он без света)
+  на `MeshStandardMaterial`, добавь источники света и объёмные меши вместо плоскостей.
+  Мир рисуется по тем же координатам сущностей из `Game` — логику менять не нужно.
 - **Другой рендер целиком** (например, Canvas2D для отладки) — реализуй `Renderer`
  и подставь в `main.ts`. Ядро не трогается вообще.

@@ -3,7 +3,7 @@
 <head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Dungeon Crawl — three.js</title>
+  <title>Биндим Фигняшку</title>
  <style>
    * { margin: 0; padding: 0; box-sizing: border-box; }
    body {
@@ -27,12 +27,25 @@
    /* Стартовое меню — поверх холстов, перекрывает сцену своим фоном. */
    #menu {
      position: absolute; inset: 0; z-index: 10;
-      background: #0a0a0fee;
+      /* фон-картинка с тёмным затемнением для читаемости; фолбэк — тёмный цвет */
+      background: linear-gradient(rgba(10,10,15,0.7), rgba(10,10,15,0.82)),
+                  url(assets/menu-bg.png) center / cover no-repeat, #0a0a0f;
      display: flex; flex-direction: column; align-items: center; justify-content: center;
      gap: 14px; padding: 24px;
    }
-    #menu h1 { font-size: 40px; letter-spacing: 4px; color: #c9b27a; }
+    #menu h1 { font-size: 40px; letter-spacing: 4px; color: #c9b27a; margin-bottom: 4px; }
+    #menu-logo { display: block; width: min(560px, 80%); height: auto; }
    .menu-sub { color: #888; margin-bottom: 6px; }
+    .menu-packs { display: flex; gap: 8px; margin-bottom: 2px; }
+    .menu-pack {
+      cursor: pointer;
+      background: rgba(12,12,18,0.86); color: #aaa;
+      border: 1px solid #333; border-radius: 4px;
+      padding: 7px 12px; font-family: monospace; font-size: 12px;
+      transition: background .12s, border-color .12s, color .12s;
+    }
+    .menu-pack:hover { background: #1d1d2c; border-color: #5a78c0; color: #ddd; }
+    .menu-pack.is-selected { color: #f0d887; border-color: #8f6f25; background: rgba(42,32,12,0.88); }
    #menu-presets { display: flex; flex-direction: column; gap: 10px; width: 360px; max-width: 90%; }
    .menu-preset {
      display: flex; flex-direction: column; gap: 3px;
@@ -55,7 +68,7 @@

    <!-- Стартовое меню. Кнопки уровней генерирует StartMenu из PRESETS. -->
    <div id="menu">
-      <h1>DUNGEON CRAWL</h1>
+      <h1><img id="menu-logo" src="assets/logo.png" alt="Биндим Фигняшку" /></h1>
      <p class="menu-sub">Выбери уровень</p>
      <div id="menu-presets"></div>
      <p class="menu-hint">WASD — движение · Стрелки — стрельба · Tab — оружие · Esc — меню</p>
@@ -28,6 +28,11 @@ export const OY = 80;            // отступ комнаты сверху (м
 export const FIXED_FPS = 60;
 export const FIXED_DT = 1 / FIXED_FPS; // секунд на шаг

+export const GAME_LOOP = {
+  maxFrameTimeSec: 0.25,  // не «отыгрывать» долгие паузы (фон/таб)
+  maxStepsPerFrame: 5,    // защита от «спирали смерти» при лагах
+};
+
 // ─────────────────────────────────────────────────────────────
 //  Типы тайлов
 // ─────────────────────────────────────────────────────────────
@@ -88,6 +93,7 @@ export const PLAYER = {
  speed: 3.2,        // px за шаг
  maxHp: 6,
  invFrames: 60,     // неуязвимость после удара, в шагах
+  entryInvFrames: 20, // короткая неуязвимость при входе в комнату, в шагах
  rangedCooldown: 10, // перезарядка выстрела, в шагах
  meleeCooldown: 22,  // перезарядка удара ближнего боя, в шагах
  transitionLock: 15, // блок повторного перехода между комнатами, в шагах
@@ -118,6 +124,10 @@ export const ENEMY_STATS = {
  normal: { size: 32, hp: 3, speed: 1.15, damage: 1 },
  fast: { size: 26, hp: 2, speed: 1.9, damage: 1 },
  boss: { size: 46, hp: 10, speed: 0.9, damage: 2 },
+  charger: { size: 32, hp: 5, speed: 1.6, damage: 1 },
+  tank: { size: 44, hp: 10, speed: 0.6, damage: 2 },
+  shooter: { size: 28, hp: 3, speed: 1.0, damage: 1 },
+  splitter: { size: 34, hp: 4, speed: 1.1, damage: 1 },
 } as const;

 export const ENEMY = {
@@ -137,6 +147,36 @@ export const SPAWN = {
  minDistFromDoor: 180, // не спавнить ближе к двери входа
  minDistFromPlayer: 150,
  minDistBetween: 60,
+  maxPlacementTries: 100,
  treasureChance: 0.12, // шанс комнаты-сокровищницы
  bossChance: 0.2,      // шанс назначить комнату боссом
+  secretChance: 0.08,   // шанс секретной комнаты (+1 max HP один раз при входе)
+};
+
+// ─────────────────────────────────────────────────────────────
+//  Сундук (сокровищница)
+// ─────────────────────────────────────────────────────────────
+export const CHEST = {
+  size: 40,
+  hp: 5,
+};
+
+// ─────────────────────────────────────────────────────────────
+//  Масштабирование этажей (New Game+)
+// ─────────────────────────────────────────────────────────────
+export const FLOOR_SCALING = {
+  roomsPerFloor: 2,           // + комнат на этаж
+  hpMulPerFloor: 0.15,        // + множитель HP врагов на этаж
+  speedMulPerFloor: 0.05,     // + множитель скорости на этаж
+  densityMulPerFloor: 0.1,    // + множитель плотности на этаж
+  bossHpMulPerFloor: 0.2,     // + множитель HP босса на этаж
+  fastChancePerFloor: 0.03,   // + доля быстрых врагов на этаж
+};
+
+// ─────────────────────────────────────────────────────────────
+//  Боссы (мультифазные, milestone-этажи)
+// ─────────────────────────────────────────────────────────────
+export const BOSS = {
+  maxMinions: 4,        // верхний лимит живых миньёнов одного босса — иначе комната может не зачиститься
+  minionInterval: 120,  // шагов между попытками спавна миньёнов (фаза 3)
 };
@@ -1,20 +1,28 @@
 import {
-  DIR, DOOR, OX, OY, TILE, COLS, ROWS, T_WALL,
-  MODE_RANGED, MODE_MELEE, PLAYER, ENEMY, MELEE,
+  DIR, DOOR, OX, OY, TILE, COLS, ROWS,
+  MODE_RANGED, MODE_MELEE, PLAYER, ENEMY, MELEE, PROJECTILE,
 } from '../config';
 import type { Dir } from './types';
 import { Rng } from './rng';
 import { dist, overlap } from './util';
 import { Player } from './entities/Player';
+import { Enemy } from './entities/Enemy';
 import { Projectile } from './entities/Projectile';
 import { MeleeSwing } from './entities/MeleeSwing';
 import { RoomMap } from './world/RoomMap';
 import type { Room } from './world/Room';
 import { collidesWall } from './systems/collision';
-import { spawnEnemies } from './systems/spawner';
-import { DEFAULT_RULES, type LevelRules } from './rules';
+import { moveEntity } from './systems/movement';
+import { runAI, spawnSplitterChildren, type AIContext } from './systems/ai';
+import {
+  applyWeaponProjectileStats, explodeBomb, projectileHitWall,
+} from './systems/projectiles';
+import { spawnEnemies, spawnChest, pickChestWeapon } from './systems/spawner';
+import { Pickup } from './entities/Pickup';
+import { ITEMS, applyItem, ALL_ITEM_IDS, type ItemId } from './items';
+import { DEFAULT_RULES, scaleRulesForFloor, type LevelRules } from './rules';
 import type { InputState } from '../input/InputState';
-import { pressingDir } from '../input/InputState';
+import { pressingDir, cardinalFromVec } from '../input/InputState';

 /**
 * Game — «мозг» игры. Полностью независим от рендера и DOM: ничего не
@@ -28,6 +36,7 @@ import { pressingDir } from '../input/InputState';
 */
 export class Game {
  readonly rules: LevelRules;
+  private floorRules: LevelRules;
  rng: Rng; // пересоздаётся в reset() — для воспроизводимости фикс-сида
  roomMap: RoomMap;
  player: Player;
@@ -36,6 +45,9 @@ export class Game {
  meleeSwing: MeleeSwing | null = null;
  gameOver = false;
  won = false;
+  floor = 1;
+  inventoryOpen = false;
+  elapsedSteps = 0;

  /**
   * @param rules правила уровня (см. core/rules.ts). По умолчанию — «Стандарт».
@@ -43,9 +55,11 @@ export class Game {
   */
  constructor(rules: LevelRules = DEFAULT_RULES, rng?: Rng) {
    this.rules = rules;
+    this.floorRules = rules;
    this.rng = rng ?? new Rng(rules.seed);
    this.player = new Player(rules.player);
-    this.roomMap = new RoomMap(this.rng, rules);
+    this.player.mode = this.player.currentWeapon.type === 'ranged' ? MODE_RANGED : MODE_MELEE;
+    this.roomMap = new RoomMap(this.rng, this.floorRules);
    this.enterRoom('up');
  }

@@ -56,19 +70,40 @@ export class Game {

  // ── Публичный контракт цикла ──────────────────────────────

-  /** Однократные действия (смена оружия, рестарт). Вызывать раз в кадр. */
+  /** Однократные действия (смена оружия, рестарт, инвентарь). Вызывать раз в кадр. */
  consumeActions(input: InputState): void {
+    if (input.openInventory && !this.gameOver && !this.won) {
+      this.inventoryOpen = !this.inventoryOpen;
+    }
+    if (this.inventoryOpen) return;
    if (input.toggleWeapon && !this.gameOver && !this.won) {
-      this.player.mode = this.player.mode === MODE_RANGED ? MODE_MELEE : MODE_RANGED;
+      const p = this.player;
+      p.equipped = p.equipped === 0 ? 1 : 0;
+      p.mode = p.currentWeapon.type === 'ranged' ? MODE_RANGED : MODE_MELEE;
    }
    if (input.restart && (this.gameOver || this.won)) {
      this.reset();
    }
  }

+  /** Выбрать слот (из main.ts при открытом инвентаре). Молча игнорирует несуществующие. */
+  equipSlot(slot: number): void {
+    if (slot < 0 || slot >= this.player.weapons.length) return;
+    this.player.equipped = slot as 0 | 1;
+    this.player.mode = this.player.currentWeapon.type === 'ranged' ? MODE_RANGED : MODE_MELEE;
+    this.inventoryOpen = false;
+  }
+
+  /** Закрыть инвентарь без прямой мутации поля снаружи Game. */
+  closeInventory(): void {
+    this.inventoryOpen = false;
+  }
+
  /** Один фиксированный шаг симуляции (= 1/60 c). */
  step(input: InputState): void {
-    if (this.gameOver || this.won) return;
+    if (this.gameOver || this.won || this.inventoryOpen) return;
+
+    this.elapsedSteps++;

    const room = this.curRoom;
    const p = this.player;
@@ -87,11 +122,16 @@ export class Game {
    this.handleAttack(input, room, p);
    this.updateMelee(room);
    this.updateTears(room);
+    this.updateChest(room);
+    this.updatePickup(room, p);
    const aliveCount = this.updateEnemies(room, p);
    if (this.gameOver) return;

-    // Комната зачищена: открываем двери.
-    if (room.enemies.length > 0 && aliveCount === 0 && !room.cleared) {
+    // Комната зачищена: все враги мертвы (aliveCount === 0 после фильтра
+    // означает, что ни живых, ни свежеспавненных не осталось). Проверку
+    // через room.enemies.length использовать нельзя — после фильтрации длина
+    // уже 0; считаем по живым из updateEnemies.
+    if (aliveCount === 0 && !room.cleared && room.type !== 'spawn' && room.type !== 'treasure' && room.type !== 'secret') {
      room.cleared = true;
      room.rebuildTiles();
    }
@@ -104,10 +144,15 @@ export class Game {
  reset(): void {
    this.gameOver = false;
    this.won = false;
+    this.floor = 1;
+    this.inventoryOpen = false;
+    this.elapsedSteps = 0;
+    this.floorRules = this.rules;
    // Пере-сеем ГПСЧ из правил: фикс-сид → тот же данжен, иначе → новый каждый раз.
    this.rng = new Rng(this.rules.seed);
-    this.roomMap = new RoomMap(this.rng, this.rules);
+    this.roomMap = new RoomMap(this.rng, this.floorRules);
    this.player = new Player(this.rules.player);
+    this.player.mode = this.player.currentWeapon.type === 'ranged' ? MODE_RANGED : MODE_MELEE;
    this.cc = 0;
    this.cr = 0;
    this.meleeSwing = null;
@@ -119,6 +164,7 @@ export class Game {
  /** Расставляет игрока внутри текущей комнаты у двери fromDir и (при нужде) спавнит врагов. */
  enterRoom(fromDir: Dir): void {
    const room = this.curRoom;
+    const wasVisited = room.visited; // ловим «первый вход» до установки флага
    room.visited = true;

    const d = DOOR[fromDir];
@@ -128,16 +174,24 @@ export class Game {
    const py = OY + d.cy * TILE + TILE / 2 - ddr * TILE;
    this.player.place(px, py);
    this.player.facing = fromDir;
-    this.player.invTimer = 20;            // короткая неуязвимость на входе
+    this.player.invTimer = PLAYER.entryInvFrames;
    this.player.transCD = PLAYER.transitionLock;

    this.meleeSwing = null;
    room.tears = [];

    if (!room.cleared && room.type !== 'spawn') {
-      room.enemies = spawnEnemies(room, fromDir, this.player.x, this.player.y, this.rng, this.rules);
-      // Если врагов нет (напр. сокровищница) — зачищать нечего, открываем сразу,
-      // иначе двери никогда не появятся и игрок застрянет.
+      room.enemies = spawnEnemies(room, fromDir, this.player.x, this.player.y, this.rng, this.floorRules);
+      // Сундук в сокровищнице.
+      if (room.type === 'treasure' && !room.chest) {
+        room.chest = spawnChest(room, this.rng);
+      }
+      // Секретка: +1 max HP один раз при первом входе (лечит заодно на 1).
+      if (room.type === 'secret' && !wasVisited) {
+        this.player.growMaxHp(1);
+      }
+      // Если врагов нет (напр. сокровищница/секретка) — зачищать нечего,
+      // открываем сразу, иначе двери никогда не появятся и игрок застрянет.
      if (room.enemies.length === 0) room.cleared = true;
      room.rebuildTiles();
    } else {
@@ -163,29 +217,69 @@ export class Game {
    if (input.moveX < 0) p.moveDir = 'left';
    else if (input.moveX > 0) p.moveDir = 'right';

-    const dx = mx * p.speed;
-    const dy = my * p.speed;
-    // Раздельное разрешение коллизий по осям: позволяет «скользить» вдоль стен.
-    p.x += dx;
-    if (collidesWall(p.box, room)) p.x -= dx;
-    p.y += dy;
-    if (collidesWall(p.box, room)) p.y -= dy;
+    moveEntity(p, mx * p.speed, my * p.speed, room);
  }

  private handleAttack(input: InputState, room: Room, p: Player): void {
-    let dir: Dir | null = null;
-    if (input.aimDir) dir = input.aimDir;          // прицельная стрельба стрелками
-    else if (input.attackHeld) dir = p.moveDir;    // пробел — по ходу движения
+    // Приоритет: явный прицел (вектор стрелок) → иначе направление движения.
+    let nx = 0, ny = 0;
+    let aim = false;
+    if (input.aimVec) {
+      nx = input.aimVec.x;
+      ny = input.aimVec.y;
+      aim = true;
+    } else if (input.attackHeld) {
+      [nx, ny] = DIR[p.moveDir];
+      aim = true;
+    }

-    if (!dir || p.atkCD > 0) return;
+    if (!aim || p.atkCD > 0) return;

-    p.facing = dir;
-    p.atkCD = p.mode === MODE_RANGED ? PLAYER.rangedCooldown : PLAYER.meleeCooldown;
-    const [nx, ny] = DIR[dir];
-    if (p.mode === MODE_RANGED) {
-      room.tears.push(new Projectile(p.x, p.y, nx, ny));
+    const len = Math.hypot(nx, ny) || 1;
+    nx /= len; ny /= len;
+    // Для рендера и door-логики сохраняем facing как одно из 4 направлений.
+    p.facing = cardinalFromVec({ x: nx, y: ny });
+
+    const w = p.currentWeapon;
+    p.atkCD = p.effectiveCooldown(w);
+    const damage = p.effectiveDamage(w);
+
+    if (w.type === 'ranged') {
+      if (w.projectileType === 'beam') {
+        // Лазерный луч — стационарная зона поражения.
+        const range = w.beamRange ?? 70;
+        const t = new Projectile(p.x + nx * range, p.y + ny * range, 0, 0, 'beam');
+        t.speed = 0;
+        t.life = w.beamLife ?? 10;
+        t.damage = (w.beamTickDmg ?? 2) * p.stats.damageMul;
+        t.beamRadius = w.beamRadius ?? 44;
+        room.tears.push(t);
+      } else if (w.spreadCount && w.spreadCount > 1) {
+        const spread = w.spread ?? 0.15;
+        const perpX = -ny;
+        const perpY = nx;
+        const projectileType = w.projectileType ?? 'tear';
+        for (let i = 0; i < w.spreadCount; i++) {
+          const off = (i - (w.spreadCount - 1) / 2) * spread;
+          const sx = nx + perpX * off;
+          const sy = ny + perpY * off;
+          const sl = Math.hypot(sx, sy) || 1;
+          const t = new Projectile(p.x, p.y, sx / sl, sy / sl, projectileType);
+          applyWeaponProjectileStats(t, w, p);
+          room.tears.push(t);
+        }
      } else {
-      this.meleeSwing = new MeleeSwing(p.x, p.y, dir);
+        const t = new Projectile(p.x, p.y, nx, ny, w.projectileType ?? 'tear');
+        applyWeaponProjectileStats(t, w, p);
+        room.tears.push(t);
+      }
+    } else {
+      this.meleeSwing = new MeleeSwing(p.x, p.y, cardinalFromVec({ x: nx, y: ny }), {
+        damage,
+        knockback: w.knockback,
+        life: w.swingLife,
+        sizeMul: w.swingSizeMul,
+      });
    }
  }

@@ -198,56 +292,162 @@ export class Game {
      if (!e.alive || e.hitTimer > 0) continue;
      if (overlap(e.box, this.meleeSwing.box)) {
        e.hp -= this.meleeSwing.damage;
-        e.hitTimer = MELEE.life; // защита от повторного удара тем же взмахом
+        e.hitTimer = MELEE.life;
        const [dx, dy] = DIR[this.meleeSwing.dir];
        e.knx = dx * this.meleeSwing.kb;
        e.kny = dy * this.meleeSwing.kb;
      }
    }
+    // Удар по сундуку.
+    if (room.chest?.alive && overlap(room.chest.box, this.meleeSwing.box)) {
+      room.chest.hp -= this.meleeSwing.damage;
+    }
  }

  private updateTears(room: Room): void {
    for (const t of room.tears) {
      if (!t.alive) continue;
+
+      // Лазерный луч: стоит на месте, жжёт врагов каждые 2 тика.
+      if (t.type === 'beam') {
+        t.life--;
+        if (t.life <= 0) continue;
+        if (t.life % 2 === 0) {
+          const radius = t.beamRadius || 44;
+          for (const e of room.enemies) {
+            if (!e.alive) continue;
+            if (dist(t.x, t.y, e.x, e.y) < e.w / 2 + radius) {
+              e.hp -= t.damage;
+              e.hitTimer = ENEMY.hitFlash;
+            }
+          }
+        }
+        continue;
+      }
+
+      // Бумеранг: один раз на половине жизни разворачивается.
+      if (t.type === 'boomerang' && t.life === Math.floor(PROJECTILE.life / 2)) {
+        t.dx = -t.dx;
+        t.dy = -t.dy;
+      }
+
      t.x += t.dx * t.speed;
      t.y += t.dy * t.speed;
      t.life--;

-      const col = Math.floor((t.x - OX) / TILE);
-      const row = Math.floor((t.y - OY) / TILE);
-      if (col < 0 || col >= COLS || row < 0 || row >= ROWS || t.life <= 0) {
+      if (t.life <= 0 || projectileHitWall(t, room)) {
+        explodeBomb(room, t);
        t.life = 0;
        continue;
      }
-      if (room.tiles[row][col] === T_WALL) {
+
+      if (t.hostile) {
+        // Вражеский снаряд: бьёт игрока.
+        const p = this.player;
+        if (dist(t.x, t.y, p.x, p.y) < p.w / 2 + t.r && p.invTimer <= 0) {
+          p.hp -= t.damage;
+          p.invTimer = PLAYER.invFrames;
          t.life = 0;
+          if (p.hp <= 0) { p.hp = 0; this.gameOver = true; return; }
          continue;
        }
+      } else {
+        // Снаряд игрока: бьёт врагов.
        for (const e of room.enemies) {
          if (!e.alive) continue;
          if (dist(t.x, t.y, e.x, e.y) < e.w / 2 + t.r) {
            e.hp -= t.damage;
            e.hitTimer = ENEMY.hitFlash;
+            if (t.type === 'fireball') {
+              e.burnTimer = t.burnDuration;
+              e.burnDamage = t.burnDamage;
+              e.burnInterval = t.burnInterval;
+            }
+            if (t.type !== 'laser') {
              t.life = 0;
+              explodeBomb(room, t);
              break;
            }
          }
        }
+        // Попадание в сундук.
+        if (room.chest?.alive && dist(t.x, t.y, room.chest.x, room.chest.y) < room.chest.w / 2 + t.r) {
+          room.chest.hp -= t.damage;
+          if (t.type !== 'laser') {
+            t.life = 0;
+            explodeBomb(room, t);
+          }
+        }
+      }
+    }
    room.tears = room.tears.filter((t) => t.alive);
  }

+  /** Сундук уничтожен — спавним предмет или оружие (50/50). */
+  private updateChest(room: Room): void {
+    if (!room.chest || room.pickup) return;
+    if (room.chest.alive) return;
+    const dropWeapon = this.rng.chance(0.5);
+    if (dropWeapon) {
+      room.pickup = Pickup.weapon(room.chest.x, room.chest.y, pickChestWeapon(this.rng));
+    } else {
+      const itemId = this.rng.pick(ALL_ITEM_IDS);
+      room.pickup = Pickup.item(room.chest.x, room.chest.y, itemId);
+    }
+    room.chest = null;
+  }
+
+  /** Подбор пикапа игроком (оружие → слот, предмет → статы). */
+  private updatePickup(room: Room, p: Player): void {
+    if (!room.pickup) return;
+    if (overlap(p.box, room.pickup.box)) {
+      const pk = room.pickup;
+      if (pk.kind === 'weapon' && pk.weaponId !== undefined) {
+        p.addWeapon(pk.weaponId);
+      } else if (pk.kind === 'item' && pk.itemId !== undefined) {
+        const item: ItemId = pk.itemId;
+        const def = ITEMS[item];
+        applyItem(p.stats, def, (hpBonus) => p.growMaxHp(hpBonus));
+      }
+      room.pickup = null;
+    }
+  }
+
  private updateEnemies(room: Room, p: Player): number {
    let aliveCount = 0;
+    const newEnemies: Enemy[] = [];
+    const ctx: AIContext = {
+      room, player: p, rng: this.rng, floor: this.floor, floorRules: this.floorRules, newEnemies,
+    };
+
+    // Запоминаем splitter'ов, которые умерли в этом шаге — после цикла спавним
+    // их детей. (Делаем это в конце, чтобы не мутировать массив во время итерации.)
+    const deadSplitters: Enemy[] = [];

    for (const e of room.enemies) {
-      if (!e.alive) continue;
-      aliveCount++;
+      // Мёртвый враг: ловим splitter для распада, иначе пропускаем.
+      if (!e.alive) {
+        if (e.type === 'splitter') deadSplitters.push(e);
+        continue;
+      }

      if (e.hitTimer > 0) e.hitTimer--;

-      // Фаза отбрасывания: летит по инерции, ИИ не работает. Коллизии
-      // проверяем пораздельно по осям — иначе кнокбэк (до ~4.5 тайла)
-      // пробивал стену в 1 тайл, и враг застревал снаружи навсегда (софт-лок).
+      // Горение: урон каждые fireInterval тиков.
+      if (e.burnTimer > 0) {
+        e.burnTimer--;
+        if (e.burnTimer % e.burnInterval === 0) {
+          e.hp -= e.burnDamage;
+          e.hitTimer = ENEMY.hitFlash;
+        }
+      }
+      if (!e.alive) {
+        // Умер от горения/прошлого удара в этом шаге.
+        if (e.type === 'splitter') deadSplitters.push(e);
+        continue;
+      }
+
+      // Фаза отбрасывания: летит по инерции, ИИ не работает.
      if (Math.abs(e.knx) > 0.1 || Math.abs(e.kny) > 0.1) {
        e.x += e.knx * 3;
        if (collidesWall(e.box, room)) e.x -= e.knx * 3;
@@ -255,23 +455,21 @@ export class Game {
        if (collidesWall(e.box, room)) e.y -= e.kny * 3;
        e.knx *= ENEMY.knockbackDecay;
        e.kny *= ENEMY.knockbackDecay;
+        aliveCount++;
+        if (e.atkTimer > 0) e.atkTimer--;
        continue;
      }
      e.knx = 0;
      e.kny = 0;

-      // Преследование игрока.
-      const dx = p.x - e.x;
-      const dy = p.y - e.y;
-      const d = Math.hypot(dx, dy);
-      if (d > 0 && d < ENEMY.aggroRange) {
-        const mx = (dx / d) * e.speed;
-        const my = (dy / d) * e.speed;
-        e.x += mx;
-        if (collidesWall(e.box, room)) e.x -= mx;
-        e.y += my;
-        if (collidesWall(e.box, room)) e.y -= my;
-      }
+      aliveCount++;
+
+      runAI(e, ctx);
+
+      // Если за этот шаг враг умер от ИИ-фазы или снаряда (маловероятно,
+      // но возможно при касании уже летящего), отслеживаем.
+      if (!e.alive && e.type === 'splitter') deadSplitters.push(e);
+      if (!e.alive) continue;

      // Контактный урон по игроку.
      if (e.atkTimer > 0) e.atkTimer--;
@@ -282,11 +480,22 @@ export class Game {
        if (p.hp <= 0) {
          p.hp = 0;
          this.gameOver = true;
+          for (const parent of deadSplitters) newEnemies.push(...spawnSplitterChildren(parent));
+          room.enemies.push(...newEnemies);
+          room.enemies = room.enemies.filter((en) => en.alive);
          return aliveCount;
        }
      }
    }

+    // Распад splitter'ов на двух fast.
+    for (const parent of deadSplitters) {
+      newEnemies.push(...spawnSplitterChildren(parent));
+    }
+
+    room.enemies.push(...newEnemies);
+    // Убираем мёртвых — иначе массив растёт и зашумляет итерации/рендер.
+    room.enemies = room.enemies.filter((en) => en.alive);
    return aliveCount;
  }

@@ -315,10 +524,38 @@ export class Game {
    }
  }

+  /** Спуск на следующий этаж: новая карта, усиленные враги, HP/оружие сохраняются. */
+  private descend(): void {
+    this.floor++;
+    this.floorRules = scaleRulesForFloor(this.rules, this.floor);
+
+    const p = this.player;
+    const savedHp = p.hp;
+    const savedMode = p.mode;
+
+    const floorSeed = this.rules.seed !== undefined ? this.rules.seed + this.floor : undefined;
+    this.rng = floorSeed !== undefined ? new Rng(floorSeed) : new Rng();
+
+    this.roomMap = new RoomMap(this.rng, this.floorRules);
+    this.cc = 0;
+    this.cr = 0;
+    this.meleeSwing = null;
+
+    p.hp = savedHp;
+    p.atkCD = 0;
+    p.moveDir = 'up';
+    this.enterRoom('up');
+    p.mode = savedMode;
+  }
+
  private checkWin(): void {
    for (const room of this.roomMap.rooms.values()) {
      if (room.type === 'boss' && room.cleared) {
+        if (this.rules.endless) {
+          this.descend();
+        } else {
          this.won = true;
+        }
        return;
      }
    }
@@ -0,0 +1,24 @@
+import { CHEST } from '../../config';
+import type { Box } from '../types';
+
+export class Chest {
+  x: number;
+  y: number;
+  hp: number;
+  readonly w = CHEST.size;
+  readonly h = CHEST.size;
+
+  constructor(x: number, y: number) {
+    this.x = x;
+    this.y = y;
+    this.hp = CHEST.hp;
+  }
+
+  get box(): Box {
+    return { x: this.x - this.w / 2, y: this.y - this.h / 2, w: this.w, h: this.h };
+  }
+
+  get alive(): boolean {
+    return this.hp > 0;
+  }
+}
@@ -22,6 +22,14 @@ export class Enemy {
  kny = 0;            // отбрасывание по Y
  hitTimer = 0;       // мигание при попадании (шаги)
  atkTimer = 0;       // перезарядка контактного удара (шаги)
+  burnTimer = 0;      // тиков до конца горения (0 = не горит)
+  burnDamage = 1;     // урон за тик горения
+  burnInterval = 10;  // как часто горение наносит урон
+  chargeTimer = 0;    // перезарядка рывка для charger (шаги)
+  shootTimer = 0;     // перезарядка стрельбы для shooter (шаги)
+  phase = 1;          // фаза босса (мультифазные боссы на этажах 5/10/15)
+  phaseChanged = false; // флаг для рендера (сброс на след. шаге)
+  spawnTimer = 0;     // перезарядка спавна миньонов для босса

  /**
   * mods — множители из правил уровня (см. core/rules.ts). По умолчанию 1,
@@ -1,23 +1,29 @@
 import { MELEE, DIR } from '../../config';
 import type { Dir, Box } from '../types';

-/** Взмах ближнего боя: прямоугольный хитбокс перед игроком на MELEE.life шагов. */
+/** Взмах ближнего боя: прямоугольный хитбокс перед игроком на life шагов. */
 export class MeleeSwing {
  readonly dir: Dir;
  life = MELEE.life;
-  readonly damage = MELEE.damage;
-  readonly kb = MELEE.knockback;
+  readonly maxLife: number;
+  readonly damage: number;
+  readonly kb: number;
  readonly box: Box;

-  constructor(x: number, y: number, dir: Dir) {
+  constructor(x: number, y: number, dir: Dir, overrides?: { damage?: number; knockback?: number; life?: number; sizeMul?: number }) {
    this.dir = dir;
-    const { reach: d, size: s } = MELEE;
+    this.damage = overrides?.damage ?? MELEE.damage;
+    this.kb = overrides?.knockback ?? MELEE.knockback;
+    if (overrides?.life !== undefined) this.life = overrides.life;
+    this.maxLife = this.life;
+    const { reach: d } = MELEE;
+    const size = MELEE.size * (overrides?.sizeMul ?? 1);
    const [dx, dy] = DIR[dir];
    this.box = {
-      x: x + (dx > 0 ? d : dx < 0 ? -d - s : -s / 2),
-      y: y + (dy > 0 ? d : dy < 0 ? -d - s : -s / 2),
-      w: s,
-      h: s,
+      x: x + (dx > 0 ? d : dx < 0 ? -d - size : -size / 2),
+      y: y + (dy > 0 ? d : dy < 0 ? -d - size : -size / 2),
+      w: size,
+      h: size,
    };
  }

@@ -0,0 +1,48 @@
+import type { Box } from '../types';
+import type { WeaponId } from '../weapons';
+import type { ItemId } from '../items';
+
+/** Что выпало из сундука: новое оружие ИЛИ пассивный предмет. */
+export type PickupKind = 'weapon' | 'item';
+
+/**
+ * Пикап на полу. Может быть либо оружие (заменяет экипированный слот),
+ * либо пассивный предмет (модифицирует статы игрока при подборе).
+ */
+export class Pickup {
+  x: number;
+  y: number;
+  readonly kind: PickupKind;
+  /** ID оружия, если kind === 'weapon'. */
+  readonly weaponId?: WeaponId;
+  /** ID предмета, если kind === 'item'. */
+  readonly itemId?: ItemId;
+  readonly w = 30;
+  readonly h = 30;
+
+  private constructor(x: number, y: number, kind: PickupKind, weaponId?: WeaponId, itemId?: ItemId) {
+    this.x = x;
+    this.y = y;
+    this.kind = kind;
+    this.weaponId = weaponId;
+    this.itemId = itemId;
+  }
+
+  static weapon(x: number, y: number, weaponId: WeaponId): Pickup {
+    return new Pickup(x, y, 'weapon', weaponId);
+  }
+
+  static item(x: number, y: number, itemId: ItemId): Pickup {
+    return new Pickup(x, y, 'item', undefined, itemId);
+  }
+
+  get box(): Box {
+    return { x: this.x - this.w / 2, y: this.y - this.h / 2, w: this.w, h: this.h };
+  }
+}
+
+/**
+ * @deprecated Используйте Pickup. WeaponPickup оставлен как псевдоним для
+ * обратной совместимости со старым кодом/тестами.
+ */
+export const WeaponPickup = Pickup;
@@ -1,6 +1,31 @@
-import { PLAYER, MODE_RANGED } from '../../config';
+import { PLAYER, MODE_RANGED, MODE_MELEE } from '../../config';
+import { WEAPONS, type WeaponId, type WeaponDef } from '../weapons';
 import type { CombatMode, Box, Dir } from '../types';

+/**
+ * Статы-множители, которые модифицируют базовые характеристики оружия.
+ * Все начинают с 1 (нейтрально); пассивные предметы и баффы их меняют.
+ * Сделано мультипликативно поверх WeaponDef, чтобы предметы и оружие
+ * комбинировались независимо (как в Isaac: апгрейды работают с любым оружием).
+ */
+export interface PlayerStats {
+  /** Множитель урона выстрела/взмаха. */
+  damageMul: number;
+  /** Множитель скорости атаки (больше → чаще стреляет).Cooldown = base / fireRateMul. */
+  fireRateMul: number;
+  /** Множитель дальности полёта снаряда (в шагах жизни). */
+  rangeMul: number;
+  /** Множитель скорости полёта снаряда. */
+  shotSpeedMul: number;
+}
+
+export const NEUTRAL_STATS: PlayerStats = {
+  damageMul: 1,
+  fireRateMul: 1,
+  rangeMul: 1,
+  shotSpeedMul: 1,
+};
+
 /**
 * Игрок. Только данные и геометрия — никакой отрисовки.
 * prevX/prevY хранят позицию на прошлом шаге для плавной интерполяции
@@ -23,6 +48,14 @@ export class Player {
  invTimer = 0;         // неуязвимость (шаги)
  transCD = 0;          // блок перехода между комнатами (шаги)

+  /** Ровно 2 слота под оружие. */
+  weapons: [WeaponDef, WeaponDef] = [WEAPONS.tears, WEAPONS.melee];
+  /** 0 или 1 — какой слот сейчас экипирован. */
+  equipped: 0 | 1 = 0;
+
+  /** Текущие множители. Меняются предметами/баффами. */
+  stats: PlayerStats = { ...NEUTRAL_STATS };
+
  /** Переопределения из правил уровня; по умолчанию — баланс из config. */
  constructor(rules: { maxHp?: number; speed?: number } = {}) {
    this.maxHp = rules.maxHp ?? PLAYER.maxHp;
@@ -35,6 +68,37 @@ export class Player {
    return { x: this.x - this.w / 2, y: this.y - this.h / 2, w: this.w, h: this.h };
  }

+  get currentWeapon(): WeaponDef {
+    return this.weapons[this.equipped];
+  }
+
+  /** Эффективный урон оружия с учётом статов игрока. */
+  effectiveDamage(w: WeaponDef): number {
+    return w.damage * this.stats.damageMul;
+  }
+
+  /** Эффективная перезарядка оружия с учётом скорости атаки. */
+  effectiveCooldown(w: WeaponDef): number {
+    return Math.max(1, Math.round(w.cooldown / this.stats.fireRateMul));
+  }
+
+  /** Подобрать оружие — заменяет текущий экипированный слот. */
+  addWeapon(id: WeaponId): void {
+    this.weapons[this.equipped] = WEAPONS[id];
+    this.mode = WEAPONS[id].type === 'ranged' ? MODE_RANGED : MODE_MELEE;
+  }
+
+  /**
+   * Увеличить максимальное HP на bonus и подлечить на ту же величину.
+   * maxHp readonly снаружи, поэтому меняем через этот метод — он же не
+   * позволяет уйти в отрицательные значения.
+   */
+  growMaxHp(bonus: number): void {
+    if (bonus <= 0) return;
+    (this as { maxHp: number }).maxHp += bonus;
+    this.hp = Math.min(this.maxHp, this.hp + bonus);
+  }
+
  /** Поставить позицию мгновенно, сбросив интерполяцию (телепорт). */
  place(x: number, y: number): void {
    this.x = this.prevX = x;
@@ -1,6 +1,7 @@
 import { PROJECTILE } from '../../config';
+import type { ProjectileType } from '../types';

-/** Снаряд игрока («слеза»). Летит по прямой, пока не врежется или не истечёт life. */
+/** Снаряд. Летит по прямой, пока не врежется или не истечёт life. */
 export class Projectile {
  x: number;
  y: number;
@@ -8,16 +9,24 @@ export class Projectile {
  prevY: number;
  dx: number;
  dy: number;
+  readonly type: ProjectileType;
  readonly r = PROJECTILE.radius;
-  readonly speed = PROJECTILE.speed;
-  readonly damage = PROJECTILE.damage;
+  speed = PROJECTILE.speed;
+  damage = PROJECTILE.damage;
  life = PROJECTILE.life;
+  hostile = false; // true = вражеский снаряд, бьёт игрока
+  burnDuration = 0;
+  burnDamage = 1;
+  burnInterval = 10;
+  explosionRadius = 0;
+  beamRadius = 0;

-  constructor(x: number, y: number, dx: number, dy: number) {
+  constructor(x: number, y: number, dx: number, dy: number, type: ProjectileType = 'tear') {
    this.x = this.prevX = x;
    this.y = this.prevY = y;
    this.dx = dx;
    this.dy = dy;
+    this.type = type;
  }

  get alive(): boolean {
@@ -0,0 +1,78 @@
+/**
+ * items.ts — пассивные предметы (как в Isaac).
+ *
+ * Предмет модифицирует статы игрока (damageMul, fireRateMul и т.д.).
+ * В отличие от оружия (которое занимает слот и определяет тип атаки),
+ * предметов можно собрать сколько угодно — они стакаются в общей сумме
+ * статов. Это база для «билдов»: чувак, накопивший +damage и +fireRate,
+ * к боссу придёт совсем с другой огневой мощью.
+ */
+import type { PlayerStats } from './entities/Player';
+
+export type ItemId =
+  | 'sad-onion'      // +скорострельность
+  | 'cricket-head'   // +урон
+  | 'lemon-mishap'   // +дальность
+  | 'lucky-toe'      // +всё понемногу
+  | 'blood-penny'    // +HP
+  | 'speed-ball';    // +скорость полёта снаряда
+
+export interface ItemDef {
+  id: ItemId;
+  name: string;
+  description: string;
+  /** Изменения стат, которые применяются при подборе. */
+  stats?: Partial<PlayerStats>;
+  /** Сколько добавить к максимальному HP (и текущему). */
+  maxHpBonus?: number;
+}
+
+export const ITEMS: Record<ItemId, ItemDef> = {
+  'sad-onion': {
+    id: 'sad-onion', name: 'Грустный лук',
+    description: '+35% к скорострельности.',
+    stats: { fireRateMul: 0.35 }, // это дельта, применяется как += 0.35
+  },
+  'cricket-head': {
+    id: 'cricket-head', name: 'Голова сверчка',
+    description: '+50% к урону.',
+    stats: { damageMul: 0.5 },
+  },
+  'lemon-mishap': {
+    id: 'lemon-mishap', name: 'Лимонная неприятность',
+    description: '+60% к дальности.',
+    stats: { rangeMul: 0.6 },
+  },
+  'speed-ball': {
+    id: 'speed-ball', name: 'Скоростной шар',
+    description: '+40% к скорости снаряда.',
+    stats: { shotSpeedMul: 0.4 },
+  },
+  'lucky-toe': {
+    id: 'lucky-toe', name: 'Счастливый палец',
+    description: '+15% урон, +15% скорострельность.',
+    stats: { damageMul: 0.15, fireRateMul: 0.15 },
+  },
+  'blood-penny': {
+    id: 'blood-penny', name: 'Кровавый пенс',
+    description: '+2 к макс. HP и лечит на 2.',
+    maxHpBonus: 2,
+  },
+};
+
+/** Все айдishники предметов — для случайного дропа. */
+export const ALL_ITEM_IDS: readonly ItemId[] = Object.keys(ITEMS) as ItemId[];
+
+/**
+ * Применить предмет к статам/игроку. Используется при подборе.
+ * Стаки: каждый предмет модифицирует текущие множители дельтой.
+ */
+export function applyItem(stats: PlayerStats, item: ItemDef, onMaxHp: (bonus: number) => void): void {
+  if (item.stats) {
+    if (item.stats.damageMul) stats.damageMul += item.stats.damageMul;
+    if (item.stats.fireRateMul) stats.fireRateMul += item.stats.fireRateMul;
+    if (item.stats.rangeMul) stats.rangeMul += item.stats.rangeMul;
+    if (item.stats.shotSpeedMul) stats.shotSpeedMul += item.stats.shotSpeedMul;
+  }
+  if (item.maxHpBonus) onMaxHp(item.maxHpBonus);
+}
@@ -12,9 +12,9 @@ export class Rng {
  private state: number;

  /** Без seed — случайный старт; с seed — детерминированная цепочка. */
-  constructor(seed?: number) {
-    // 0 — валидный seed, поэтому проверяем именно на undefined.
-    this.state = (seed === undefined ? (Math.random() * 2 ** 32) >>> 0 : seed) >>> 0;
+  constructor(seed: number = autoSeed()) {
+    // 0 — валидный seed; авто-seed включается только когда аргумент не передан.
+    this.state = seed >>> 0;
  }

  /** Следующее число в [0, 1). Алгоритм mulberry32 — быстрый и достаточный. */
@@ -43,6 +43,7 @@ export class Rng {

  /** Случайный элемент массива. */
  pick<T>(arr: readonly T[]): T {
+    if (arr.length === 0) throw new Error('Rng.pick: пустой массив');
    return arr[this.int(0, arr.length - 1)];
  }

@@ -55,3 +56,22 @@ export class Rng {
    return arr;
  }
 }
+
+const AUTO_SEED_STEP = 0x9e3779b9;
+let autoSeedCounter = 0;
+
+/**
+ * Seed для нового нефиксированного забега. Энтропия берётся только внутри Rng:
+ * остальная игровая логика по-прежнему получает все случайные числа через next().
+ */
+function autoSeed(): number {
+  autoSeedCounter = (autoSeedCounter + AUTO_SEED_STEP) >>> 0;
+  let seed = Date.now() >>> 0;
+  const crypto = globalThis.crypto;
+  if (crypto?.getRandomValues) {
+    const value = new Uint32Array(1);
+    crypto.getRandomValues(value);
+    seed ^= value[0];
+  }
+  return (seed ^ autoSeedCounter) >>> 0;
+}
@@ -10,7 +10,7 @@
 * Геометрия (размер тайла/комнаты, геометрия дверей) остаётся в config.ts: это
 * не «правила уровня», а константы движка.
 */
-import { PLAYER, ENEMY, MIN_ROOMS, EXTRA_ROOMS, MAP_RADIUS } from '../config';
+import { PLAYER, ENEMY, MIN_ROOMS, EXTRA_ROOMS, MAP_RADIUS, FLOOR_SCALING } from '../config';

 export interface LevelRules {
  /** Машинный id (для сохранений/выбора). */
@@ -21,6 +21,8 @@ export interface LevelRules {
  description: string;
  /** Фиксированный seed генерации. undefined → случайный каждый забег. */
  seed?: number;
+  /** Бесконечный спуск: после босса — новый этаж с усилением, а не победа. */
+  endless?: boolean;

  /** Параметры генерации карты. */
  map: {
@@ -91,4 +93,38 @@ export const PRESETS: LevelRules[] = [
    player: { maxHp: PLAYER.maxHp, speed: PLAYER.speed },
    enemies: { densityMul: 1, fastChance: ENEMY.fastChance, hpMul: 1, speedMul: 1, bossHpMul: 1 },
  },
+  {
+    id: 'endless',
+    name: 'Бесконечный спуск',
+    description: 'После босса — спуск на новый этаж. Враги сильнее, комнат больше. HP и оружие сохраняются.',
+    endless: true,
+    map: { minRooms: MIN_ROOMS, extraRooms: EXTRA_ROOMS, mapRadius: MAP_RADIUS },
+    player: { maxHp: PLAYER.maxHp, speed: PLAYER.speed },
+    enemies: { densityMul: 1, fastChance: ENEMY.fastChance, hpMul: 1, speedMul: 1, bossHpMul: 1 },
+  },
 ];
+
+/**
+ * Возвращает правила для указанного этажа на основе базовых правил.
+ * С каждым этажом враги сильнее и комнат больше.
+ */
+export function scaleRulesForFloor(base: LevelRules, floor: number): LevelRules {
+  const f = floor - 1;
+  const cap = (v: number): number => Math.round(v * 100) / 100;
+  return {
+    ...base,
+    map: {
+      ...base.map,
+      minRooms: base.map.minRooms + f * FLOOR_SCALING.roomsPerFloor,
+      mapRadius: Math.min(base.map.mapRadius + Math.floor(f / 3), 6),
+    },
+    enemies: {
+      densityMul: cap(base.enemies.densityMul + f * FLOOR_SCALING.densityMulPerFloor),
+      fastChance: Math.min(base.enemies.fastChance + f * FLOOR_SCALING.fastChancePerFloor, 0.8),
+      hpMul: cap(base.enemies.hpMul + f * FLOOR_SCALING.hpMulPerFloor),
+      speedMul: cap(base.enemies.speedMul + f * FLOOR_SCALING.speedMulPerFloor),
+      bossHpMul: cap(base.enemies.bossHpMul + f * FLOOR_SCALING.bossHpMulPerFloor),
+    },
+    endless: true,
+  };
+}
@@ -0,0 +1,171 @@
+import { BOSS, ENEMY, OX, OY, TILE, COLS, ROWS } from '../../config';
+import { moveEntity } from './movement';
+import { Enemy } from '../entities/Enemy';
+import { Projectile } from '../entities/Projectile';
+import type { Room } from '../world/Room';
+import type { Player } from '../entities/Player';
+import type { Rng } from '../rng';
+import type { LevelRules } from '../rules';
+
+/**
+ * Контекст, нужный ИИ врагов на одном шаге. Передаётся извне (Game), чтобы
+ * сами функции ИИ оставались чистыми от глобального состояния и их было
+ * удобно тестировать.
+ */
+export interface AIContext {
+  room: Room;
+  player: Player;
+  rng: Rng;
+  floor: number;
+  floorRules: LevelRules;
+  /** Сюда босс складывает свежеспавненных миньёнов — Game добавит их в room.enemies. */
+  newEnemies: Enemy[];
+}
+
+/** Этаж кратный 5, начиная с 5 — на нём босс получает фазы и спавн миньёнов. */
+export function isMilestoneBossFloor(floor: number): boolean {
+  return floor % 5 === 0 && floor >= 5;
+}
+
+/**
+ * Раздвоение splitter'а при смерти: спавнит двух мелких `fast` по бокам.
+ * Возвращает свежезаспавненных врагов — Game добавит их в room.enemies.
+ */
+export function spawnSplitterChildren(parent: Enemy): Enemy[] {
+  const offset = 14;
+  return [
+    new Enemy(parent.x - offset, parent.y, 'fast'),
+    new Enemy(parent.x + offset, parent.y, 'fast'),
+  ];
+}
+
+type AIHandler = (e: Enemy, ctx: AIContext) => void;
+
+/**
+ * Диспетчер ИИ по типу врага. Добавишь новый тип — допиши ветку здесь
+ * (и в EnemyType/config). Заменяет прежний if/else-if каскад в Game.ts.
+ */
+export function runAI(e: Enemy, ctx: AIContext): void {
+  const handler = pickHandler(e, ctx.floor);
+  handler(e, ctx);
+}
+
+function pickHandler(e: Enemy, floor: number): AIHandler {
+  if (e.type === 'boss' && isMilestoneBossFloor(floor)) return updateMilestoneBoss;
+  if (e.type === 'shooter') return updateShooter;
+  if (e.type === 'charger') return updateCharger;
+  // normal, fast, tank, обычный boss — просто догоняют.
+  return updateChaser;
+}
+
+/** Стандартное преследование (normal, fast, tank, обычный boss). */
+function updateChaser(e: Enemy, ctx: AIContext): void {
+  const { player: p, room } = ctx;
+  const dx = p.x - e.x;
+  const dy = p.y - e.y;
+  const d = Math.hypot(dx, dy);
+  if (d > 0 && d < ENEMY.aggroRange) {
+    moveEntity(e, (dx / d) * e.speed, (dy / d) * e.speed, room);
+  }
+}
+
+/** Зарядчик: бежит прямо на игрока, время от времени делая рывок ×2.5. */
+function updateCharger(e: Enemy, ctx: AIContext): void {
+  const { player: p, room } = ctx;
+  if (e.chargeTimer > 0) e.chargeTimer--;
+  const dx = p.x - e.x;
+  const dy = p.y - e.y;
+  const d = Math.hypot(dx, dy);
+  if (d > 0 && d < ENEMY.aggroRange) {
+    const speedMul = e.chargeTimer <= 0 && d < 150 ? 2.5 : 1.0;
+    if (speedMul > 1) e.chargeTimer = 40; // перезарядка рывка
+    moveEntity(e, (dx / d) * e.speed * speedMul, (dy / d) * e.speed * speedMul, room);
+  }
+}
+
+/** Стрелок: держит дистанцию ~150–200 px, периодически стреляет в игрока. */
+function updateShooter(e: Enemy, ctx: AIContext): void {
+  const { player: p, room } = ctx;
+  const dx = p.x - e.x;
+  const dy = p.y - e.y;
+  const d = Math.hypot(dx, dy);
+
+  if (d > 0 && d < ENEMY.aggroRange) {
+    if (d < 150) {
+      // Слишком близко — отступает.
+      moveEntity(e, -(dx / d) * e.speed, -(dy / d) * e.speed, room);
+    } else {
+      moveEntity(e, (dx / d) * e.speed * 0.5, (dy / d) * e.speed * 0.5, room);
+    }
+  }
+
+  // Стрельба.
+  if (e.shootTimer > 0) e.shootTimer--;
+  if (e.shootTimer <= 0 && d < 350 && d > 40) {
+    e.shootTimer = 45;
+    const nd = d || 1;
+    const t = new Projectile(e.x, e.y, dx / nd, dy / nd, 'tear');
+    t.hostile = true;
+    t.damage = 1;
+    t.speed = 3.5;
+    t.life = 60;
+    ctx.room.tears.push(t);
+  }
+}
+
+/** Milestone-босс (этаж 5/10/15): фазы HP, стрельба с фазы 2, миньёны с фазы 3. */
+function updateMilestoneBoss(e: Enemy, ctx: AIContext): void {
+  const { player: p, room, rng, floor, floorRules, newEnemies } = ctx;
+  const maxPhase = floor <= 5 ? 2 : 3;
+  const hpRatio = e.hp / e.maxHp;
+
+  let targetPhase = 1;
+  if (maxPhase >= 2 && hpRatio < 0.66) targetPhase = 2;
+  if (maxPhase >= 3 && hpRatio < 0.33) targetPhase = 3;
+
+  if (targetPhase > e.phase) {
+    e.phase = targetPhase;
+    e.phaseChanged = true;
+    e.hitTimer = 15; // визуальная вспышка (для рендера)
+  }
+
+  const phaseSpeedMul = targetPhase >= 3 ? 1.8 : targetPhase === 2 ? 1.35 : 1.0;
+  const effectiveSpeed = e.speed * phaseSpeedMul;
+
+  // Движение к игроку.
+  const dx = p.x - e.x;
+  const dy = p.y - e.y;
+  const d = Math.hypot(dx, dy);
+  if (d > 0 && d < ENEMY.aggroRange) {
+    moveEntity(e, (dx / d) * effectiveSpeed, (dy / d) * effectiveSpeed, room);
+  }
+
+  // Стрельба снарядами (фаза 2+).
+  if (targetPhase >= 2) {
+    if (e.shootTimer > 0) e.shootTimer--;
+    const shootCD = targetPhase >= 3 ? 25 : 40;
+    if (e.shootTimer <= 0 && d < 400 && d > 50) {
+      e.shootTimer = shootCD;
+      const nd = d || 1;
+      const t = new Projectile(e.x, e.y, dx / nd, dy / nd, 'tear');
+      t.hostile = true;
+      t.damage = 1 + Math.floor(floor / 5);
+      t.speed = 3;
+      t.life = 60;
+      room.tears.push(t);
+    }
+  }
+
+  // Спавн миньёнов (фаза 3), но не больше BOSS.maxMinions живых — иначе комната не зачистится.
+  if (targetPhase >= 3) {
+    if (e.spawnTimer > 0) e.spawnTimer--;
+    const aliveMinions = room.enemies.filter((en) => en !== e && en.alive).length;
+    if (e.spawnTimer <= 0 && aliveMinions < BOSS.maxMinions) {
+      e.spawnTimer = BOSS.minionInterval;
+      const mx = OX + 2 * TILE + rng.float(0, COLS - 4) * TILE;
+      const my = OY + 2 * TILE + rng.float(0, ROWS - 4) * TILE;
+      const er = floorRules.enemies;
+      newEnemies.push(new Enemy(mx, my, 'fast', { hpMul: er.hpMul * 1.5, speedMul: er.speedMul * 1.2 }));
+    }
+  }
+}
@@ -0,0 +1,26 @@
+import { collidesWall } from './collision';
+import type { Room } from '../world/Room';
+import type { Box } from '../types';
+
+/**
+ * Сущность с прямоугольным хитбоксом и позицией, пригодная для скользящего
+ * перемещения (движение разрешается по осям раздельно, скользя вдоль стен).
+ */
+export interface Movable {
+  x: number;
+  y: number;
+  box: Box;
+}
+
+/**
+ * Сдвинуть сущность на (dx, dy) с разрешением коллизий по осям раздельно.
+ * Применяет X (откатывая при столкновении), затем Y — это даёт «скольжение»
+ * вдоль стен. Игрок, враги, боссы — все ходят через эту функцию, чтобы
+ * поведение у стен было единым.
+ */
+export function moveEntity(e: Movable, dx: number, dy: number, room: Room): void {
+  e.x += dx;
+  if (collidesWall(e.box, room)) e.x -= dx;
+  e.y += dy;
+  if (collidesWall(e.box, room)) e.y -= dy;
+}
@@ -0,0 +1,65 @@
+import { BOSS, ENEMY, PROJECTILE, TILE, OX, OY, COLS, ROWS, T_WALL } from '../../config';
+import { dist } from '../util';
+import { Projectile } from '../entities/Projectile';
+import type { Player, PlayerStats } from '../entities/Player';
+import type { Room } from '../world/Room';
+import type { WeaponDef } from '../weapons';
+
+/**
+ * Применяет к свежему снаряду характеристики оружия (урон, горение, радиус
+ * взрыва) с учётом статов игрока (damageMul, rangeMul, shotSpeedMul).
+ * Снаряд запоминает свойства на момент выстрела — поэтому смена оружия или
+ * статов после не меняет урон уже летящей «слезы».
+ */
+export function applyWeaponProjectileStats(t: Projectile, w: WeaponDef, stats: PlayerStats | Player): void {
+  const s: PlayerStats = 'stats' in stats ? stats.stats : stats;
+  t.damage = w.damage * s.damageMul;
+  t.burnDamage = (w.fireDmg ?? 1) * s.damageMul;
+  t.burnInterval = w.fireInterval ?? 10;
+  t.burnDuration = w.fireDuration ?? 0;
+  t.explosionRadius = w.explosionRadius ?? 0;
+  t.speed *= s.shotSpeedMul;
+  t.life = Math.round(t.life * s.rangeMul);
+}
+
+/** Взрыв бомбы: AoE-урон по всем врагам в радиусе, с отбрасыванием от центра. */
+export function explodeBomb(room: Room, t: Projectile): void {
+  if (t.type !== 'bomb') return;
+  const radius = t.explosionRadius || 60;
+  for (const e of room.enemies) {
+    if (!e.alive) continue;
+    if (dist(t.x, t.y, e.x, e.y) < radius) {
+      e.hp -= 3;
+      e.hitTimer = ENEMY.hitFlash;
+      const dx = e.x - t.x;
+      const dy = e.y - t.y;
+      const d = Math.hypot(dx, dy) || 1;
+      e.knx = (dx / d) * 12;
+      e.kny = (dy / d) * 12;
+    }
+  }
+}
+
+/** True, если снаряд вышел за пределы комнаты или уткнулся в стену. */
+export function projectileHitWall(t: Projectile, room: Room): boolean {
+  const col = Math.floor((t.x - OX) / TILE);
+  const row = Math.floor((t.y - OY) / TILE);
+  if (col < 0 || col >= COLS || row < 0 || row >= ROWS) return true;
+  if (room.tiles[row][col] === T_WALL) return true;
+  return false;
+}
+
+/**
+ * Параметры, общие для всех боссов: лимит миньёнов и интервал их спавна
+ * вынесены в BOSS (см. config), чтобы их можно было крутить отдельно от ИИ.
+ */
+export const BOSS_LIMITS = {
+  maxMinions: BOSS.maxMinions,
+  minionInterval: BOSS.minionInterval,
+} as const;
+
+/** Текущая скорость снаряда по умолчанию (для новых снарядов, не задающих свою). */
+export const PROJECTILE_DEFAULTS = {
+  speed: PROJECTILE.speed,
+  life: PROJECTILE.life,
+} as const;
@@ -1,17 +1,48 @@
 import { OX, OY, TILE, COLS, ROWS, DOOR, SPAWN } from '../../config';
 import { Enemy } from '../entities/Enemy';
+import { Chest } from '../entities/Chest';
 import { dist } from '../util';
 import type { Room } from '../world/Room';
 import type { Dir, EnemyType } from '../types';
 import type { Rng } from '../rng';
+import type { WeaponId } from '../weapons';
 import { DEFAULT_RULES, type LevelRules } from '../rules';

+function isSpawnSpotClear(
+  x: number,
+  y: number,
+  doorX: number,
+  doorY: number,
+  playerX: number,
+  playerY: number,
+  enemies: readonly Enemy[],
+): boolean {
+  if (dist(x, y, doorX, doorY) < SPAWN.minDistFromDoor) return false;
+  if (dist(x, y, playerX, playerY) < SPAWN.minDistFromPlayer) return false;
+  for (const e of enemies) {
+    if (dist(x, y, e.x, e.y) < SPAWN.minDistBetween) return false;
+  }
+  return true;
+}
+
 /**
 * Подбирает врагов для комнаты и расставляет их так, чтобы они не появились
 * вплотную к двери входа, к игроку или друг к другу. Число, тип и сила врагов
 * берутся из правил уровня (rules). Возвращает массив — вызывающий код кладёт
 * его в room.enemies.
 */
+function pickEnemyType(room: Room, rng: Rng, fastChance: number): EnemyType {
+  if (room.type === 'boss') return 'boss';
+  const roll = rng.next();
+  // normal: до 0.4, fast: 0.4-0.6, charger: 0.6-0.75, tank: 0.75-0.88, shooter: 0.88-0.95, splitter: 0.95-1.0
+  if (roll < 0.4) return 'normal';
+  if (roll < 0.4 + fastChance * 0.7) return 'fast';
+  if (roll < 0.7) return 'charger';
+  if (roll < 0.85) return 'tank';
+  if (roll < 0.95) return 'shooter';
+  return 'splitter';
+}
+
 export function spawnEnemies(
  room: Room,
  entryDir: Dir,
@@ -25,7 +56,7 @@ export function spawnEnemies(

  const count =
    room.type === 'boss' ? 1 :
-    room.type === 'treasure' ? 0 :
+    room.type === 'treasure' || room.type === 'secret' ? 0 :
    Math.max(1, Math.round((SPAWN.normalMin + rng.int(0, SPAWN.normalExtra)) * er.densityMul));

  const door = DOOR[entryDir];
@@ -33,8 +64,7 @@ export function spawnEnemies(
  const doorY = OY + door.cy * TILE + TILE / 2;

  for (let i = 0; i < count; i++) {
-    const type: EnemyType =
-      room.type === 'boss' ? 'boss' : rng.chance(er.fastChance) ? 'fast' : 'normal';
+    const type: EnemyType = pickEnemyType(room, rng, er.fastChance);
    const mods = {
      hpMul: er.hpMul * (type === 'boss' ? er.bossHpMul : 1),
      speedMul: er.speedMul,
@@ -43,22 +73,27 @@ export function spawnEnemies(
    let x = 0;
    let y = 0;
    let ok = false;
-    for (let tries = 0; tries < 100 && !ok; tries++) {
+    for (let tries = 0; tries < SPAWN.maxPlacementTries && !ok; tries++) {
      x = OX + 2 * TILE + rng.float(0, COLS - 4) * TILE;
      y = OY + 2 * TILE + rng.float(0, ROWS - 4) * TILE;
-      ok = true;
-
-      if (dist(x, y, doorX, doorY) < SPAWN.minDistFromDoor) ok = false;
-      else if (dist(x, y, playerX, playerY) < SPAWN.minDistFromPlayer) ok = false;
-      else {
-        for (const e of enemies) {
-          if (dist(x, y, e.x, e.y) < SPAWN.minDistBetween) { ok = false; break; }
-        }
-      }
+      ok = isSpawnSpotClear(x, y, doorX, doorY, playerX, playerY, enemies);
    }
+    if (!ok) continue;

    enemies.push(new Enemy(x, y, type, mods));
  }

  return enemies;
 }
+
+const TREASURE_WEAPONS: WeaponId[] = ['shotgun', 'axe', 'staff', 'whip', 'bomb', 'boomerang', 'laser'];
+
+export function spawnChest(room: Room, rng: Rng): Chest {
+  const cx = OX + (COLS / 2) * TILE;
+  const cy = OY + (ROWS / 2) * TILE;
+  return new Chest(cx, cy);
+}
+
+export function pickChestWeapon(rng: Rng): WeaponId {
+  return rng.pick(TREASURE_WEAPONS);
+}
@@ -1,9 +1,10 @@
 /** Общие типы данных, на которые опирается вся игра. */

-export type RoomType = 'spawn' | 'normal' | 'treasure' | 'boss';
+export type RoomType = 'spawn' | 'normal' | 'treasure' | 'boss' | 'secret';
 export type Dir = 'up' | 'down' | 'left' | 'right';
 export type CombatMode = 0 | 1; // MODE_RANGED | MODE_MELEE
-export type EnemyType = 'normal' | 'fast' | 'boss';
+export type EnemyType = 'normal' | 'fast' | 'boss' | 'charger' | 'tank' | 'shooter' | 'splitter';
+export type ProjectileType = 'tear' | 'fireball' | 'bomb' | 'boomerang' | 'laser' | 'beam';

 /** Прямоугольник (axis-aligned bounding box) для коллизий. */
 export interface Box {
@@ -0,0 +1,41 @@
+export type WeaponId = 'tears' | 'melee' | 'shotgun' | 'axe' | 'staff' | 'whip' | 'bomb' | 'boomerang' | 'laser';
+
+export type ProjectileType = 'tear' | 'fireball' | 'bomb' | 'boomerang' | 'laser' | 'beam';
+
+export interface WeaponDef {
+  id: WeaponId;
+  name: string;
+  type: 'ranged' | 'melee';
+  damage: number;
+  cooldown: number;
+  projectileType?: ProjectileType;
+  spreadCount?: number;
+  /** Угол бокового отклонения каждого снаряда при spreadCount > 1 (доля от перпендикуляра). */
+  spread?: number;
+  swingSizeMul?: number;
+  swingLife?: number;
+  knockback?: number;
+  fireDmg?: number;
+  fireInterval?: number;
+  fireDuration?: number;
+  explosionRadius?: number;  // для бомбы
+  beamLife?: number;         // длительность лазерного луча
+  beamRadius?: number;       // радиус поражения луча
+  beamTickDmg?: number;      // урон за тик луча
+  beamRange?: number;        // дальность постановки центра луча от игрока
+}
+
+export const WEAPONS: Record<WeaponId, WeaponDef> = {
+  tears: { id: 'tears', name: 'Слёзы', type: 'ranged', damage: 1, cooldown: 10, projectileType: 'tear' },
+  melee: { id: 'melee', name: 'Кулак', type: 'melee', damage: 2, cooldown: 22 },
+  shotgun: { id: 'shotgun', name: 'Дробовик', type: 'ranged', damage: 1, cooldown: 18, projectileType: 'tear', spreadCount: 3, spread: 0.15 },
+  axe: { id: 'axe', name: 'Топор', type: 'melee', damage: 4, cooldown: 35, swingSizeMul: 1.5, swingLife: 15, knockback: 15 },
+  staff: { id: 'staff', name: 'Посох', type: 'ranged', damage: 1, cooldown: 20, projectileType: 'fireball', fireDmg: 1, fireInterval: 10, fireDuration: 50 },
+  whip: { id: 'whip', name: 'Хлыст', type: 'melee', damage: 3, cooldown: 18, swingSizeMul: 2.5, swingLife: 12, knockback: 16 },
+  bomb: { id: 'bomb', name: 'Бомба', type: 'ranged', damage: 0, cooldown: 35, projectileType: 'bomb', explosionRadius: 80 },
+  boomerang: { id: 'boomerang', name: 'Бумеранг', type: 'ranged', damage: 2, cooldown: 25, projectileType: 'boomerang' },
+  laser: {
+    id: 'laser', name: 'Лазер', type: 'ranged', damage: 1, cooldown: 20,
+    projectileType: 'beam', beamLife: 12, beamRadius: 44, beamTickDmg: 2, beamRange: 70,
+  },
+};
@@ -2,6 +2,8 @@ import type { RoomType, Doors } from '../types';
 import { buildTiles } from './tiles';
 import type { Enemy } from '../entities/Enemy';
 import type { Projectile } from '../entities/Projectile';
+import type { Chest } from '../entities/Chest';
+import type { Pickup } from '../entities/Pickup';

 /**
 * Комната дандженa. Хранит свой тип, набор дверей, состояние «зачищена/
@@ -17,6 +19,8 @@ export class Room {
  cleared = false;
  enemies: Enemy[] = [];
  tears: Projectile[] = [];
+  chest: Chest | null = null;
+  pickup: Pickup | null = null;
  tiles: number[][];

  constructor(c: number, r: number, type: RoomType) {
@@ -76,6 +76,8 @@ export class RoomMap {
          type = 'boss';
        } else if (rng.chance(SPAWN.treasureChance) && count >= 2) {
          type = 'treasure';
+        } else if (rng.chance(SPAWN.secretChance) && count >= 3) {
+          type = 'secret';
        }

        this.add(nc, nr, type);
@@ -1,6 +1,6 @@
-import { FIXED_DT } from '../config';
+import { FIXED_DT, GAME_LOOP } from '../config';
 import type { Game } from '../core/Game';
-import type { KeyboardController } from '../input/KeyboardController';
+import type { InputSource } from '../input/InputState';

 /**
 * Игровой цикл с ФИКСИРОВАННЫМ шагом.
@@ -15,11 +15,10 @@ export class GameLoop {
  private last = 0;
  private rafId = 0;
  private running = false;
-  private readonly maxSteps = 5; // защита от «спирали смерти» при лагах

  constructor(
    private readonly game: Game,
-    private readonly controller: KeyboardController,
+    private readonly controller: InputSource,
    private readonly onRender: (alpha: number) => void,
  ) {}

@@ -31,16 +30,19 @@ export class GameLoop {
  }

  stop(): void {
+    if (!this.running) return;
    this.running = false;
    cancelAnimationFrame(this.rafId);
+    this.rafId = 0;
  }

  private frame = (now: number): void => {
+    if (!this.running) return;
    this.rafId = requestAnimationFrame(this.frame);

    let frameTime = (now - this.last) / 1000;
    this.last = now;
-    if (frameTime > 0.25) frameTime = 0.25; // не «отыгрывать» долгие паузы (фон/таб)
+    if (frameTime > GAME_LOOP.maxFrameTimeSec) frameTime = GAME_LOOP.maxFrameTimeSec;

    // Ввод опрашиваем раз в кадр; однократные действия — тоже раз в кадр.
    const input = this.controller.poll();
@@ -48,12 +50,12 @@ export class GameLoop {

    this.accumulator += frameTime;
    let steps = 0;
-    while (this.accumulator >= FIXED_DT && steps < this.maxSteps) {
+    while (this.accumulator >= FIXED_DT && steps < GAME_LOOP.maxStepsPerFrame) {
      this.game.step(input);
      this.accumulator -= FIXED_DT;
      steps++;
    }
-    if (steps === this.maxSteps) this.accumulator = 0; // отстали — ресинхронизируемся
+    if (steps === GAME_LOOP.maxStepsPerFrame) this.accumulator = 0; // отстали — ресинхронизируемся

    const alpha = this.accumulator / FIXED_DT;
    this.onRender(alpha);
@@ -7,16 +7,27 @@ import type { Dir } from '../core/types';
 * контроллер, отдающий такой же InputState.
 *
 * Поля делятся на два вида:
- *  • удерживаемые (move*, aimDir, attackHeld) — читаются каждый шаг симуляции;
+ *  • удерживаемые (move*, aimVec, attackHeld) — читаются каждый шаг симуляции;
 *  • однократные «edge» (toggleWeapon, restart) — срабатывают один раз на нажатие.
 */
 export interface InputState {
  moveX: number;        // -1 влево, +1 вправо, 0 нет
  moveY: number;        // -1 вверх, +1 вниз, 0 нет
-  aimDir: Dir | null;   // прицеливание стрелками (приоритетнее attackHeld)
+  /**
+   * Вектор прицеливания (например, из стрелок). Может быть диагональным:
+   * {1,-1} = вверх-вправо. null = игрок не целится явным образом. Не обязан
+   * быть нормализованным — приведением займётся логика.
+   */
+  aimVec: { x: number; y: number } | null;
  attackHeld: boolean;  // атака «по ходу движения» (пробел)
  toggleWeapon: boolean; // сменить оружие (однократно)
  restart: boolean;      // рестарт на экране конца игры (однократно)
+  openInventory: boolean; // открыть инвентарь (однократно, E)
+}
+
+/** Любой источник ввода для игрового цикла: клавиатура, геймпад, бот, тест. */
+export interface InputSource {
+  poll(): InputState;
 }

 /** Нейтральный снимок — ничего не нажато. */
@@ -24,19 +35,33 @@ export function emptyInput(): InputState {
  return {
    moveX: 0,
    moveY: 0,
-    aimDir: null,
+    aimVec: null,
    attackHeld: false,
    toggleWeapon: false,
    restart: false,
+    openInventory: false,
  };
 }

-/** Жмёт ли игрок в сторону dir (движением ИЛИ прицеливанием) — для переходов. */
+/**
+ * True, если вектор прицеливания или движения указывает в сторону dir.
+ * Нужно для переходов между комнатами (можно жать стрелку ИЛИ движение).
+ */
 export function pressingDir(input: InputState, dir: Dir): boolean {
  switch (dir) {
-    case 'up': return input.moveY < 0 || input.aimDir === 'up';
-    case 'down': return input.moveY > 0 || input.aimDir === 'down';
-    case 'left': return input.moveX < 0 || input.aimDir === 'left';
-    case 'right': return input.moveX > 0 || input.aimDir === 'right';
+    case 'up':    return input.moveY < 0 || (!!input.aimVec && input.aimVec.y < 0);
+    case 'down':  return input.moveY > 0 || (!!input.aimVec && input.aimVec.y > 0);
+    case 'left':  return input.moveX < 0 || (!!input.aimVec && input.aimVec.x < 0);
+    case 'right': return input.moveX > 0 || (!!input.aimVec && input.aimVec.x > 0);
  }
 }
+
+/**
+ * Округлить вектор прицеливания до ближайшего из 4 кардинальных направлений.
+ * Используется для `facing` (рендер спрайта игрока) и для случаев, когда
+ * логике нужен именно Dir (например, поставить дверь в комнату).
+ */
+export function cardinalFromVec(v: { x: number; y: number }): Dir {
+  if (Math.abs(v.x) > Math.abs(v.y)) return v.x > 0 ? 'right' : 'left';
+  return v.y > 0 ? 'down' : 'up';
+}
@@ -1,33 +1,39 @@
-import type { InputState } from './InputState';
-import type { Dir } from '../core/types';
+import type { InputSource, InputState } from './InputState';

 /**
 * Раскладка: WASD — движение, стрелки — прицельная стрельба, пробел —
 * атака по ходу движения, Tab/Q — смена оружия, R — рестарт.
 *
- * Контроллер держит набор зажатых клавиш и «защёлкивает» однократные
- * действия (смена оружия/рестарт). Раз в кадр вызывается poll(), который
- * собирает InputState и сбрасывает однократные флаги.
+ * ВАЖНО: используем `event.code` (ФИЗИЧЕСКАЯ клавиша), а не `event.key`.
+ * `code` не зависит от раскладки, поэтому WASD/Q/R работают и в русской
+ * раскладке (где те же клавиши дают «цфыв»/«й»/«к»). Стрелки/Tab/пробел в
+ * `code` называются ArrowUp/Tab/Space.
+ *
+ * Контроллер держит набор зажатых клавиш и «защёлкивает» однократные действия
+ * (смена оружия/рестарт). Раз в кадр вызывается poll(), который собирает
+ * InputState и сбрасывает однократные флаги.
 */
-export class KeyboardController {
+export class KeyboardController implements InputSource {
  private held = new Set<string>();
  private toggleWeaponEdge = false;
  private restartEdge = false;
+  private inventoryEdge = false;
  private attached = false;

  private onKeyDown = (e: KeyboardEvent): void => {
-    const k = e.key;
+    const c = e.code;
    // Однократные действия ловим по факту нажатия (не по удержанию).
-    if (!this.held.has(k)) {
-      if (k === 'Tab' || k === 'q' || k === 'Q') this.toggleWeaponEdge = true;
-      if (k === 'r' || k === 'R') this.restartEdge = true;
+    if (!this.held.has(c)) {
+      if (c === 'Tab' || c === 'KeyQ') this.toggleWeaponEdge = true;
+      if (c === 'KeyR') this.restartEdge = true;
+      if (c === 'KeyE') this.inventoryEdge = true;
    }
-    this.held.add(k);
-    if (PREVENT.has(k)) e.preventDefault();
+    this.held.add(c);
+    if (PREVENT.has(c)) e.preventDefault();
  };

  private onKeyUp = (e: KeyboardEvent): void => {
-    this.held.delete(e.key);
+    this.held.delete(e.code);
  };

  private onBlur = (): void => {
@@ -44,6 +50,7 @@ export class KeyboardController {
    this.held.clear();
    this.toggleWeaponEdge = false;
    this.restartEdge = false;
+    this.inventoryEdge = false;
  }

  /** Подписаться на события окна. Вызывается один раз при старте. */
@@ -57,37 +64,43 @@ export class KeyboardController {

  /** Собрать снимок ввода и сбросить однократные флаги. */
  poll(): InputState {
-    const down = (k: string) => this.held.has(k);
+    const down = (code: string) => this.held.has(code);

    let moveX = 0;
    let moveY = 0;
-    if (down('w') || down('W')) moveY -= 1;
-    if (down('s') || down('S')) moveY += 1;
-    if (down('a') || down('A')) moveX -= 1;
-    if (down('d') || down('D')) moveX += 1;
+    if (down('KeyW')) moveY -= 1;
+    if (down('KeyS')) moveY += 1;
+    if (down('KeyA')) moveX -= 1;
+    if (down('KeyD')) moveX += 1;

-    let aimDir: Dir | null = null;
-    if (down('ArrowUp')) aimDir = 'up';
-    else if (down('ArrowDown')) aimDir = 'down';
-    else if (down('ArrowLeft')) aimDir = 'left';
-    else if (down('ArrowRight')) aimDir = 'right';
+    // Прицел собираем из стрелок как ВЕКТОР — поддерживает 8 направлений
+    // (одновременные ArrowUp + ArrowRight дают диагональ {0,-1}+{1,0}).
+    let aimX = 0;
+    let aimY = 0;
+    if (down('ArrowUp')) aimY -= 1;
+    if (down('ArrowDown')) aimY += 1;
+    if (down('ArrowLeft')) aimX -= 1;
+    if (down('ArrowRight')) aimX += 1;
+    const aimVec = (aimX !== 0 || aimY !== 0) ? { x: aimX, y: aimY } : null;

    const snapshot: InputState = {
      moveX,
      moveY,
-      aimDir,
-      attackHeld: down(' ') || down('Spacebar'),
+      aimVec,
+      attackHeld: down('Space'),
      toggleWeapon: this.toggleWeaponEdge,
      restart: this.restartEdge,
+      openInventory: this.inventoryEdge,
    };

    this.toggleWeaponEdge = false;
    this.restartEdge = false;
+    this.inventoryEdge = false;
    return snapshot;
  }
 }

-/** Клавиши, у которых гасим стандартное поведение браузера (скролл и т.п.). */
+/** Физические клавиши (e.code), у которых гасим поведение браузера (скролл/таб). */
 const PREVENT = new Set([
-  'ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight', ' ', 'Spacebar', 'Tab',
+  'ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight', 'Space', 'Tab', 'KeyE',
 ]);
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
mayatnikov	a72172df72	refactor: комплексный рефакторинг + Isaac-like геймплей Баги и гигиена (Wave 1): - Player.addWeapon использует MODE_MELEE вместо литерала 1 - Фильтрация мёртвых врагов из room.enemies (раньше массив рос в долгих боях) - Кап миньёнов босса (BOSS.maxMinions=4) — иначе комната могла не зачиститься - aliveCount корректно считает живых в knockback-фазе - equipSlot валидирует диапазон слота - Магические числа range=70/spread=0.15 вынесены в WeaponDef (beamRange/spread) - Регрессия cleared-flag: после фильтрации массива длина 0, но cleared должен стать true Распил Game.ts 683→465 строк (Wave 2): - systems/movement.ts: moveEntity(e, dx, dy, room) — убрал 5 копий коллизионного паттерна - systems/projectiles.ts: applyWeaponProjectileStats, explodeBomb, projectileHitWall - systems/ai.ts: runAI через диспетчер-таблицу (вместо if/else-if каскада) - Переходы/этажи оставлены в Game.ts (тесно завязаны на cc/cr/player) Тесты 33→72 (Wave 3): - movement.test.ts, projectiles.test.ts, combat.test.ts, regressions.test.ts, items.test.ts - Покрытие: ближний/дальний бой, огнемёт, бомба, лазер, splitter, сундук→пикап, переход комнат, фазы босса + кап миньёнов, фильтрация мёртвых, секретка Isaac-like геймплей (Wave 4): - Статы игрока: damageMul/fireRateMul/rangeMul/shotSpeedMul (мультипликативно поверх WeaponDef), effectiveDamage/Cooldown, отображение в HUD - 8-направленный прицел: aimDir: Dir → aimVec: {x,y}, стрелки дают диагонали - Пассивные предметы (items.ts, 6 штук): сундук дропает 50/50 оружие/предмет - Новый тип врага splitter: при смерти распадается на двух fast - Новый тип комнаты secret: +1 max HP один раз при первом входе	2026-06-19 16:50:15 +03:00
Yuriy Mayatnikov	5d676b7d95	Merge pull request #4 from VovaManul/feature/new-game-plus Merged feature/new-game-plus into main via gh.	2026-06-19 15:53:00 +03:00
mayatnikov	3cdd3ac738	Add Binding 2.0 asset pack	2026-06-19 15:50:02 +03:00
mayatnikov	db545ce80b	Add optimized README artwork	2026-06-19 13:27:47 +03:00
mayatnikov	e55666f51c	Fix new game plus progression issues	2026-06-19 13:26:19 +03:00
Volodia	01c1f71159	feat: инвентарь 2 слота, 4 новых оружия, 3 врага, босс-фазы, иконки пикапов	2026-06-19 13:09:28 +03:00
Manul	d2d1d2381d	Merge pull request #3 from halofourteen/codex/refactor-obvious-issues [codex] Refactor core seams and spawning	2026-06-18 18:53:12 +03:00
mayatnikov	b7362a2ad8	refactor: tighten core seams and spawning	2026-06-18 18:34:45 +03:00
Manul	58bf96e9d9	Merge pull request #2 from halofourteen/round2/pseudo-3d Раунд 2: псевдо-3D + дизайнерский арт, сердечки/иконки, меню («Биндим Фигняшку»)	2026-06-18 16:24:33 +03:00
mayatnikovandClaude Opus 4.8	7dabfd4fff	docs: синхронизировать описание ассетов с реальностью (PNG из src/assets + фолбэк) Ревью отметило устаревшие тексты после перехода на загрузку PNG: - assets.ts: заголовок описывал «процедурно, без внешних файлов» — теперь PNG из src/assets/<ключ>.png с процедурным фолбэком. - HOWTO §8: убран совет «заменить тело drawX() на TextureLoader» (уже сделано); актуальный путь — положить PNG с нужным именем в src/assets/. - README/ARCHITECTURE/ASSET_BRIEF: статус «подключено», корректный механизм (рантайм- загрузка по пути, не импорт-бандлинг). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	2026-06-18 16:15:36 +03:00
mayatnikovandClaude Opus 4.8	35cb8de33a	feat(art): подключены дизайнерские ассеты + сердечки/иконки/лого в UI - Добавлены 21 PNG из Claude Design в src/assets/ (спрайты игрока и врагов, пол, стены, двери, снаряд, эффекты, тень, сердечки, иконки оружия, лого, фон меню). - HudOverlay: здоровье сердечками (2 HP = сердце) + иконка режима оружия; фолбэк на полосу/без иконки, если картинок нет. - index.html: лого и фон-подземелье в стартовом меню (с тёмным затемнением). - Мир/персонажи/двери теперь рисуются дизайнерскими спрайтами (через assets.ts). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	2026-06-18 16:08:40 +03:00
mayatnikovandClaude Opus 4.8	e2cb1ff855	feat(assets): загрузка PNG из src/assets с процедурным фолбэком - assets.ts: текстуры грузятся из src/assets/<key>.png; если файла нет — откат на процедурный рисунок (игра не ломается, сборка не зависит от наличия PNG). - dev.ts: отдаёт /assets/* прямо из src/assets/ (положил PNG → сразу подхватился). - build.ts: копирует src/assets → dist/assets. - Имена ключей = именам файлов из docs/ASSET_BRIEF.md (player-ranged.png и т.д.). - Добавлен src/assets/tear.png как рабочий пример из дизайна. Чтобы подключить полный арт: положить 21 PNG из проекта Claude Design в src/assets/. Бинарные ассеты переносятся файлами (не через модель — это триггерит usage-policy). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	2026-06-18 16:00:35 +03:00
mayatnikovandClaude Opus 4.8	3bb46e2f6b	feat(render): псевдо-3D, всегда видимые двери, ассеты+эффекты, русификация - Рендер переведён в псевдо-3D: наклонная PerspectiveCamera, пол лежит плашмя, персонажи/враги — вертикальные спрайты-биллборды, стены с высотой. Починен баг: пол создавался без поворота и стоял вертикально → «вывернутая» перспектива. - Двери видны всегда: закрыты (засов) во время боя, открытый проём после зачистки. - render/assets.ts: процедурные текстуры (спрайты персонажей/врагов, пол, стены, двери, снаряд, тень) + эффекты оружия (вспышка из дула, искры, облачко гибели). - Светлее палитра — исправлено «тёмное на тёмном». - Игра переименована в «Биндим Фигняшку»; полная русификация UI (ДАЛЬНИЙ/БЛИЖНИЙ, ИГРА ОКОНЧЕНА, ПОБЕДА); клавиши-подсказки оставлены латиницей. - Ввод по event.code → WASD/Q/R работают в любой раскладке (вкл. русскую). - theme.ts урезан до реально используемых тинтов (bg/swing/flash). - docs/ASSET_BRIEF.md — бриф и промпт на полную художку; доки синхронизированы. - Ядро (src/core) не тронуто — раунд чисто render/UI. 27 тестов + типы зелёные. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	2026-06-18 15:16:57 +03:00
Volodia	f4316431e0	add community health files - LICENSE (MIT) - CONTRIBUTING.md - CODE_OF_CONDUCT.md - SECURITY.md - .github/PULL_REQUEST_TEMPLATE.md - .github/ISSUE_TEMPLATE/bug_report.md - .github/ISSUE_TEMPLATE/feature_request.md - .github/FUNDING.yml	2026-06-18 14:33:47 +03:00
Manul	5a8cf0e500	Merge pull request #1 from halofourteen/refactor/game-foundation Рефакторинг: рабочая база на three.js + меню/правила уровней + доки	2026-06-18 14:22:17 +03:00