Александр Петров
774b1cc7c4
Документы отстали от кода: PORT_PLAN писал «PoC не начат», хотя играется весь уровень 1, а четыре плана были исполнены целиком. - PORT_PLAN: таблица статусов по разделам; фазы 0-3 сделаны, 4-6 нет; риски §8 п.1/п.3 закрыты, п.2 переформулирован под реальный движок (спрайтовый движок для персонажей не используется, лимит «21 спрайт» неприменим), п.4 — найдено расхождение таймингов: оригинал считает логический кадр за 5 тиков при BASE_FPS=60 (83.3 мс, в бою 100 мс), а мы ждём три vsync (60 мс) — игра идёт примерно на 39 % быстрее эталона. - levels_plan.md — новый: машинерия перехода между уровнями, второй тайлсет (palace), потабличные различия и читы SDLPoP, которые окупаются сразу. Инвентарь тайлов снят прямо с res200N.bin: уровень 2 не требует ни одного нового ассета и ни одной новой механики. - roomtest/TASKS.md — новый: доска текущих задач с критериями готовности. - Удалены как исполненные и перекрытые кодом: clip_char_plan, double_buffer_plan, loose_floors_plan, size_optimization_plan. Его §8 (замеры скорости отрисовки) не был перекрыт — перенесён в layout_plan_v2 §9, чтобы не потерять цифры. - KID_PLAN / gates_spikes_plan — шапки «реализовано, оставлено справочником»; room_model_plan — «S1 сделан, остальное не срочно». - docs/README.md стал индексом с отметками актуальности. - ideas_backlog: зелье переворота экрана — оригинал переворачивает готовый буфер построчно, спрайты не трогает; по данным уровней тип 4 встречается только на уровне 9, до него механика не нужна. - examples/scroll: ссылка на удалённый план вела к неверному факту «теневая копия одна — общая»; заменено на подтверждённое «у каждой страницы своя». Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
43 lines
3.3 KiB
Markdown
43 lines
3.3 KiB
Markdown
# Prince of Persia на ZX Sprinter
|
||
|
||
Порт Prince of Persia на компьютер Sprinter Sp2000 поверх нашего
|
||
target-слоя SDCC (sprinter-cc / libc / libbgi). Цель — 320×256×256 (режим
|
||
0x81), VGA-256 ассеты оригинала переносятся почти впрямую.
|
||
|
||
**Состояние (2026-08-01): играется весь уровень 1** — комнаты и переходы,
|
||
Kid со всем набором действий, ловушки, ворота, дверь уровня, меч и бой,
|
||
стражи с ИИ, HP и зелья. Нет: перехода на следующий уровень, звука,
|
||
таймера/HUD, сохранений.
|
||
|
||
- Что в работе прямо сейчас — [`roomtest/TASKS.md`](roomtest/TASKS.md).
|
||
- Следующий этап (уровни 2+) — [`docs/levels_plan.md`](docs/levels_plan.md).
|
||
- Общий план и статус фаз — [`docs/PORT_PLAN.md`](docs/PORT_PLAN.md).
|
||
- Правила работы для ИИ-сессий — [`CLAUDE.md`](CLAUDE.md).
|
||
|
||
## Что где
|
||
|
||
| Папка | Назначение |
|
||
|-------|-----------|
|
||
| `roomtest/` | **Активная разработка.** Уровень 1 целиком: фон композицией тайлов, Kid (seqtbl-анимация, ввод, коллизия, падение, зацеп, окклюзия), ловушки, ворота, стражи, бой. Свой README/CLAUDE/TASKS. |
|
||
| `docs/` | Планы и разбор форматов ресурсов Apple II / DOS — см. индекс в [`docs/README.md`](docs/README.md). |
|
||
| `toolchain/` | Python-упаковщики ассетов под Sprinter (рендер комнат, атласы тайлов/Kid, извлечение данных анимации) + эталонные скриншоты. |
|
||
| `poc/` | Ранний proof-of-concept (снег, атлас, raw-клавиатура). Ассеты в `poc/res/`. |
|
||
| `bgtest/`, `coltest/` | Точечные проверки фона и коллизии. |
|
||
| `SDLPoP/`, `PR/`, `mininim/` | Референсные реализации движка (GPL) — читаем логику/константы, НЕ копируем код. `SDLPoP/data/` — источник распакованных VGA-ассетов. |
|
||
| `Prince-of-Persia-Apple-II/` | Оригинальный 6502-исходник 1989 г. |
|
||
| `MSDOS/` | Локальные `.DAT`-ресурсы DOS-версии. |
|
||
|
||
## Референсы = только справочник
|
||
|
||
`SDLPoP/`, `PR/`, `mininim/`, `Prince-of-Persia-Apple-II/` используются как
|
||
справочник структур/логики и как источник готовых ассетов — их код НЕ
|
||
копируется в наш порт (лицензии несовместимы, ABI другой). Любая механика
|
||
сверяется с `SDLPoP/src/` **до** реализации.
|
||
|
||
## Форматы ресурсов
|
||
|
||
Формат уровня почти идентичен в Apple II и DOS (2304 / 2305 байт,
|
||
`blueprnt`). Графика различается принципиально, но брать распакованные PNG
|
||
из `SDLPoP/data/` практичнее, чем декодировать сырой `.DAT`. Подробности —
|
||
[`docs/README.md`](docs/README.md).
|