/*
 * pop_tune.h — НАСТРАИВАЕМЫЕ КОНСТАНТЫ движка (аналог custom_options
 * SDLPoP) в одном месте.
 *
 * Зачем отдельный заголовок.  У оригинала «особые события» уровней зашиты
 * магическими числами прямо в код (`current_level == 3 && Char.room == 7`),
 * и SDLPoP вынес их в структуру `custom_options_type` (types.h) с
 * загрузкой из SDLPoP.ini и правкой через меню Settings/Mods.  Нам нужно
 * то же самое по двум причинам:
 *
 *   1. ОТЛАДКА.  Некоторые сцены руками почти не проверить (успеть в
 *      закрывающуюся решётку), и единственный вменяемый способ — временно
 *      растянуть тайминг.  Такие крутилки обязаны жить в одном месте, а не
 *      прятаться числами по трём модулям.
 *   2. МОДЫ.  Тот, кто захочет свой набор уровней, меняет ровно эти числа.
 *
 * Пока это только `#define` — ни INI, ни меню нет (см. TASKS.md, запись
 * TUNE-1).  Но правило уже действует: НОВОЕ «особое событие» или тайминг
 * заводится ЗДЕСЬ, а не константой по месту.  Имена — как у SDLPoP
 * (custom->имя), чтобы сверка с оригиналом оставалась механической.
 */
#ifndef POP_TUNE_H
#define POP_TUNE_H

/* ---- Чекпойнт уровня 3 (SDLPoP: checkpoint_*) ----------------------- *
 * Оригинал: level3_set_chkp (seg002:0665) взводит флаг, когда Кид уходит
 * ВЛЕВО ИЗ комнаты 7 (вызов стоит до goto_other_room, поэтому Char.room там
 * ещё старая); do_startpos (seg003:0141) подменяет по
 * нему стартовую позицию и убирает loose-плиту, через которую туда
 * попадают (иначе после респавна дорога назад была бы уже провалена). */
#define POP_CHKP_LEVEL            3   /* checkpoint_level                */
#define POP_CHKP_ROOM             7   /* комната, ИЗ КОТОРОЙ уходят влево (у
                                       * SDLPoP хардкод; это НЕ комната
                                       * назначения — см. roomtest.c) */
#define POP_CHKP_RESPAWN_ROOM     2   /* checkpoint_respawn_room         */
#define POP_CHKP_RESPAWN_TILEPOS  6   /* checkpoint_respawn_tilepos      */
#define POP_CHKP_RESPAWN_DIR   (-1)   /* checkpoint_respawn_dir: влево   */
#define POP_CHKP_CLEAR_ROOM       7   /* checkpoint_clear_tile_room      */
#define POP_CHKP_CLEAR_COL        4   /* checkpoint_clear_tile_col       */
#define POP_CHKP_CLEAR_ROW        0   /* checkpoint_clear_tile_row       */

/* ---- Отладочные крутилки (в оригинале и в SDLPoP их НЕТ) ------------ *
 * POP_DBG_GATE_HOLD — сколько кадров решётка держится поднятой после
 * нажатия кнопки, ПРЕЖДЕ чем пойдёт вниз.  В оригинале это таймер связи
 * дверей: trigger_button ставит 5, animate_button вычитает по единице, и
 * решётка стоит, пока таймер > 1 (то есть ~4 кадра после того, как Кид
 * сошёл с кнопки).  Проверять руками проход в закрывающуюся решётку при
 * таком окне почти невозможно, поэтому значение вынесено сюда: поставь
 * 30 — и успеешь дойти спокойно.  ОБЯЗАН быть 5 в игровой сборке.
 *
 * ПОТОЛОК 30.  Таймер связи — пять бит модификатора кнопки (маска 0x1F), а
 * значение 31 у оригинала означает «событие заклинено» (`link_timer != 0x1F`
 * в trigger_button).  Больше 30 ставить нельзя — кнопка перестанет
 * срабатывать вовсе. */
#define POP_DBG_GATE_HOLD         5

/* ---- Улучшения SDLPoP (в ОРИГИНАЛЕ их нет) -------------------------- *
 * POP_ENABLE_JUMP_GRAB — зацепиться за кромку можно ПРЯМО В ПРЫЖКЕ, если
 * Shift зажат заранее (SDLPoP `enable_jump_grab`, seg006:1228).  Ваниль
 * разрешает зацеп только в начале падения (`check_grab`, кадры 102..105),
 * то есть Shift приходится нажимать уже в полёте — это и раздражало на
 * приёмке.  0 — как в оригинале, 1 — как в SDLPoP с включёнными
 * enhancements. */
#define POP_ENABLE_JUMP_GRAB      1

#endif /* POP_TUNE_H */