diff --git a/project.godot b/project.godot index dd3cef0..8bef197 100644 --- a/project.godot +++ b/project.godot @@ -53,7 +53,7 @@ pause={ } speed_cycle={ "deadzone": 0.5, -"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":4194306,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":70,"physical_keycode":0,"key_label":0,"unicode":70,"location":0,"echo":false,"script":null) ] } speed_normal={ @@ -81,6 +81,73 @@ cancel={ "events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":4194305,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) ] } +pan_up={ +"deadzone": 0.5, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":87,"physical_keycode":0,"key_label":0,"unicode":87,"location":0,"echo":false,"script":null), +Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":4194320,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) +] +} +pan_down={ +"deadzone": 0.5, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":83,"physical_keycode":0,"key_label":0,"unicode":83,"location":0,"echo":false,"script":null), +Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":4194322,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) +] +} +pan_left={ +"deadzone": 0.5, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":65,"physical_keycode":0,"key_label":0,"unicode":65,"location":0,"echo":false,"script":null), +Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":4194319,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) +] +} +pan_right={ +"deadzone": 0.5, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":68,"physical_keycode":0,"key_label":0,"unicode":68,"location":0,"echo":false,"script":null), +Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":4194321,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) +] +} +zoom_in={ +"deadzone": 0.5, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":61,"physical_keycode":0,"key_label":0,"unicode":61,"location":0,"echo":false,"script":null), +Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":4194453,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) +] +} +zoom_out={ +"deadzone": 0.5, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":45,"physical_keycode":0,"key_label":0,"unicode":45,"location":0,"echo":false,"script":null), +Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":4194452,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) +] +} +center_on_selection={ +"deadzone": 0.5, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":4194316,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null), +Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":67,"physical_keycode":0,"key_label":0,"unicode":67,"location":0,"echo":false,"script":null) +] +} +pawn_next={ +"deadzone": 0.5, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":4194306,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) +] +} +open_build={ +"deadzone": 0.5, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":66,"physical_keycode":0,"key_label":0,"unicode":66,"location":0,"echo":false,"script":null) +] +} +open_log={ +"deadzone": 0.5, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":76,"physical_keycode":0,"key_label":0,"unicode":76,"location":0,"echo":false,"script":null) +] +} +open_priorities={ +"deadzone": 0.5, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":80,"physical_keycode":0,"key_label":0,"unicode":80,"location":0,"echo":false,"script":null) +] +} +open_settings={ +"deadzone": 0.5, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":44,"physical_keycode":0,"key_label":0,"unicode":44,"location":0,"echo":false,"script":null) +] +} [rendering] diff --git a/scenes/ui/alerts_log.gd b/scenes/ui/alerts_log.gd index e10b042..4e1d06d 100644 --- a/scenes/ui/alerts_log.gd +++ b/scenes/ui/alerts_log.gd @@ -62,6 +62,10 @@ var log_button: Button = null func _ready() -> void: layer = 19 _build_ui() + # Hide the whole CanvasLayer when closed so the Backdrop ColorRect (which + # has MOUSE_FILTER_STOP for click-outside-to-close) does not eat mouse + # events in `_unhandled_input` for the world below. + visible = false _root.visible = false EventBus.alert_added.connect(_on_alert_added) @@ -86,6 +90,7 @@ func _exit_tree() -> void: func open() -> void: _rebuild_list() + visible = true _root.visible = true _unread_count = 0 _update_badge() @@ -93,6 +98,7 @@ func open() -> void: func close() -> void: + visible = false _root.visible = false Audit.log("alerts_log", "closed") @@ -277,6 +283,22 @@ func _pan_to(tile: Vector2i) -> void: close() +func _unhandled_input(event: InputEvent) -> void: + # L — toggle the alerts log. + if event.is_action_pressed("open_log"): + if _root != null and _root.visible: + close() + else: + open() + get_viewport().set_input_as_handled() + return + # Escape — close if open. + if event.is_action_pressed("cancel") and _root != null and _root.visible: + close() + get_viewport().set_input_as_handled() + return + + func _on_backdrop_input(event: InputEvent) -> void: if event is InputEventMouseButton and event.pressed and event.button_index == MOUSE_BUTTON_LEFT: close() diff --git a/scenes/ui/build_drawer.gd b/scenes/ui/build_drawer.gd index 8100c56..bacfa28 100644 --- a/scenes/ui/build_drawer.gd +++ b/scenes/ui/build_drawer.gd @@ -371,6 +371,21 @@ func _on_cancel_pressed() -> void: Audit.log("build_drawer", "tool cancelled") +# ── keyboard input ─────────────────────────────────────────────────────────── + +func _unhandled_input(event: InputEvent) -> void: + # B — toggle the build drawer. + if event.is_action_pressed("open_build"): + toggle() + get_viewport().set_input_as_handled() + return + # Escape — close if open (panel Escape runs before Selection deselect). + if event.is_action_pressed("cancel") and _open: + close() + get_viewport().set_input_as_handled() + return + + # ── helpers — visibility ───────────────────────────────────────────────────── func _set_panel_visible(v: bool) -> void: diff --git a/scenes/ui/load_menu.gd b/scenes/ui/load_menu.gd index 35dd42f..9ae7e9b 100644 --- a/scenes/ui/load_menu.gd +++ b/scenes/ui/load_menu.gd @@ -43,6 +43,19 @@ func _exit_tree() -> void: pass +func _unhandled_input(event: InputEvent) -> void: + # _set_visible drives _panel.visible, not CanvasLayer.visible — use _panel as the gate. + if _panel == null or not _panel.visible: + return + if event.is_action_pressed("cancel"): + # If the version-mismatch sub-dialog is open, dismiss it first. + if _warn_panel != null and _warn_panel.visible: + _on_warn_cancel() + else: + _close() + get_viewport().set_input_as_handled() + + # ── public API ──────────────────────────────────────────────────────────────── func open() -> void: @@ -246,6 +259,10 @@ func _close() -> void: func _set_visible(v: bool) -> void: + # Toggle CanvasLayer.visible so the dim Control (MOUSE_FILTER_STOP) does not + # eat _unhandled_input mouse events for the world below when modal is hidden. + # (The warning sub-dialog visibility is managed separately and lives inside.) + visible = v or (_warn_panel != null and _warn_panel.visible) if _dim != null: _dim.visible = v if _panel != null: diff --git a/scenes/ui/settings_menu.gd b/scenes/ui/settings_menu.gd index f6594cc..91fef51 100644 --- a/scenes/ui/settings_menu.gd +++ b/scenes/ui/settings_menu.gd @@ -227,6 +227,26 @@ func _collect_to_dict() -> Dictionary: # ── interaction ─────────────────────────────────────────────────────────────── +func _unhandled_input(event: InputEvent) -> void: + # Comma — toggle settings menu. Guard: don't open if already in a modal + # (this IS the modal, so just toggle based on current visibility). + if event.is_action_pressed("open_settings"): + if _dim != null and _dim.visible: + _set_visible(false) + Audit.log("settings_menu", "hotkey close") + else: + open() + Audit.log("settings_menu", "hotkey open") + get_viewport().set_input_as_handled() + return + # Escape — close if open (discards edits, same as Cancel button). + if event.is_action_pressed("cancel") and _dim != null and _dim.visible: + Audit.log("settings_menu", "escape: cancelled") + _set_visible(false) + get_viewport().set_input_as_handled() + return + + func _on_save_pressed() -> void: GameState.apply_settings(_collect_to_dict()) Audit.log("settings_menu", "settings saved") @@ -241,6 +261,9 @@ func _on_cancel_pressed() -> void: # ── visibility ──────────────────────────────────────────────────────────────── func _set_visible(v: bool) -> void: + # Toggle CanvasLayer.visible so the dim Control (MOUSE_FILTER_STOP) does not + # eat _unhandled_input mouse events for the world below when modal is hidden. + visible = v if _dim != null: _dim.visible = v if _panel != null: diff --git a/scenes/ui/storyteller_modal.gd b/scenes/ui/storyteller_modal.gd index fa56e98..55bbba3 100644 --- a/scenes/ui/storyteller_modal.gd +++ b/scenes/ui/storyteller_modal.gd @@ -172,6 +172,9 @@ func _on_go_there_pressed() -> void: # ── helpers ────────────────────────────────────────────────────────────────── func _set_visible(v: bool) -> void: + # Toggle CanvasLayer.visible so the dim Control (MOUSE_FILTER_STOP) does not + # eat _unhandled_input mouse events for the world below when modal is hidden. + visible = v if _dim != null: _dim.visible = v if _panel != null: diff --git a/scenes/ui/work_priority_matrix.gd b/scenes/ui/work_priority_matrix.gd index 2ad53c0..d09eb4a 100644 --- a/scenes/ui/work_priority_matrix.gd +++ b/scenes/ui/work_priority_matrix.gd @@ -69,6 +69,11 @@ var _cells: Array = [] func _ready() -> void: layer = 17 _build_ui() + # Hide the whole CanvasLayer when closed so the Backdrop ColorRect (which + # has MOUSE_FILTER_STOP for click-outside-to-close) does not eat mouse + # events in `_unhandled_input` for the world below. Toggling _root.visible + # alone leaves the Backdrop alive and intercepting clicks. + visible = false _root.visible = false Audit.log("work_priority_ui", "WorkPriorityMatrix ready") @@ -78,12 +83,14 @@ func _ready() -> void: ## Open the matrix panel and rebuild the grid from current pawn state. func open() -> void: _rebuild_grid() + visible = true _root.visible = true Audit.log("work_priority_ui", "opened (pawns=%d)" % World.pawns.size()) ## Close the panel. func close() -> void: + visible = false _root.visible = false Audit.log("work_priority_ui", "closed") @@ -222,6 +229,22 @@ func _on_cell_pressed(pawn, category: StringName, btn: Button) -> void: Audit.log("work_priority_ui", "%s: %s → %d" % [pawn.pawn_name, String(category), next]) +func _unhandled_input(event: InputEvent) -> void: + # P — toggle the work priority matrix. + if event.is_action_pressed("open_priorities"): + if _root != null and _root.visible: + close() + else: + open() + get_viewport().set_input_as_handled() + return + # Escape — close if open. + if event.is_action_pressed("cancel") and _root != null and _root.visible: + close() + get_viewport().set_input_as_handled() + return + + func _on_backdrop_input(event: InputEvent) -> void: # Tap on the backdrop (outside the panel) closes the matrix. if event is InputEventMouseButton and event.pressed and event.button_index == MOUSE_BUTTON_LEFT: diff --git a/scenes/world/camera_rig.gd b/scenes/world/camera_rig.gd index 4d44e66..cd4490f 100644 --- a/scenes/world/camera_rig.gd +++ b/scenes/world/camera_rig.gd @@ -29,12 +29,26 @@ func _ready() -> void: zoom = Vector2(target_zoom, target_zoom) +## Pan speed in world pixels per second at zoom 1.0. +## Scales inversely with zoom so on-screen apparent speed feels constant. +const PAN_SPEED_PX_PER_SEC: float = 600.0 + + func _process(delta: float) -> void: # Lerp zoom toward target each render frame. # Plain 0.15 factor is correct at 60 fps; frame-rate independent form used for safety. var t: float = 1.0 - pow(1.0 - 0.15, delta * 60.0) zoom = zoom.lerp(Vector2(target_zoom, target_zoom), t) + # Keyboard pan — WASD / arrow keys. Strength gives an analogue-stick-style + # value (0..1) so held-key is continuous and action-just-pressed is not needed. + var pan_input := Vector2( + Input.get_action_strength("pan_right") - Input.get_action_strength("pan_left"), + Input.get_action_strength("pan_down") - Input.get_action_strength("pan_up"), + ) + if pan_input != Vector2.ZERO: + position += pan_input.normalized() * (PAN_SPEED_PX_PER_SEC / zoom.x) * delta + func _unhandled_input(event: InputEvent) -> void: # --- Pinch-zoom via magnify gesture (trackpad + native touch pinch) --- @@ -42,6 +56,16 @@ func _unhandled_input(event: InputEvent) -> void: target_zoom = clampf(target_zoom * event.factor, MIN_ZOOM, MAX_ZOOM) return + # --- Keyboard zoom (= / + / KP_ADD and - / KP_SUBTRACT) --- + if event.is_action_pressed("zoom_in"): + target_zoom = clampf(target_zoom * 1.1, MIN_ZOOM, MAX_ZOOM) + Audit.log("camera", "zoom_in → %.2f" % target_zoom) + return + if event.is_action_pressed("zoom_out"): + target_zoom = clampf(target_zoom / 1.1, MIN_ZOOM, MAX_ZOOM) + Audit.log("camera", "zoom_out → %.2f" % target_zoom) + return + # --- Scroll-wheel zoom (desktop) --- if event is InputEventMouseButton: if event.button_index == MOUSE_BUTTON_WHEEL_UP and event.pressed: diff --git a/scenes/world/designation.gd b/scenes/world/designation.gd index a7b58d7..5958268 100644 --- a/scenes/world/designation.gd +++ b/scenes/world/designation.gd @@ -159,6 +159,27 @@ func cells() -> Array[Vector2i]: # ── input ──────────────────────────────────────────────────────────────────── +## _input runs before _unhandled_input so Escape / right-click tool-cancel takes +## priority over Selection's deselect and over panel close-handlers. +func _input(event: InputEvent) -> void: + if _tool == TOOL_NONE: + return + + # Escape — cancel the active tool; consume so lower handlers don't also fire. + if event.is_action_pressed("cancel"): + set_active_tool(TOOL_NONE) + get_viewport().set_input_as_handled() + Audit.log("designation", "escape: tool cancelled") + return + + # Right-click — also cancel the active tool (RTS convention). + if event is InputEventMouseButton and event.button_index == MOUSE_BUTTON_RIGHT and event.pressed: + set_active_tool(TOOL_NONE) + get_viewport().set_input_as_handled() + Audit.log("designation", "right-click: tool cancelled") + return + + func _unhandled_input(event: InputEvent) -> void: if _tool == TOOL_NONE or _paint_layer == null: return diff --git a/scenes/world/selection.gd b/scenes/world/selection.gd index ea432e4..ec04c64 100644 --- a/scenes/world/selection.gd +++ b/scenes/world/selection.gd @@ -14,6 +14,7 @@ const CLICK_MAX_DURATION_MS: int = 300 var _pathfinder: Pathfinder = null var _selected_pawn: Pawn = null +var _camera = null # Camera2D (CameraRig) — set via bind_camera(); duck-typed to avoid circular preload # When Designation paint mode is active this flag is raised by Designation so # Selection does not also try to select/move on the same click. @@ -29,13 +30,57 @@ func bind(pathfinder: Pathfinder) -> void: _pathfinder = pathfinder +## Inject the CameraRig so Tab-cycle and center-on-selection can pan to the +## selected pawn's tile. Call from world.gd after selection.bind(). +func bind_camera(rig) -> void: + _camera = rig + + func selected() -> Pawn: return _selected_pawn func _unhandled_input(event: InputEvent) -> void: + # ── Keyboard: Tab → cycle pawns (Shift+Tab reverses) ─────────────────────── + if event.is_action_pressed("pawn_next"): + # Read shift from the event itself (set by the OS on the key event); more + # reliable than Input.is_key_pressed(KEY_SHIFT) which doesn't reflect modifier + # state from synthetic input events (MCP test injections). + var reverse: bool = event is InputEventKey and event.shift_pressed + _cycle_pawn(-1 if reverse else 1) + get_viewport().set_input_as_handled() + return + + # ── Keyboard: C / Home → center camera on selected pawn ───────────────────── + if event.is_action_pressed("center_on_selection"): + if _selected_pawn != null and _camera != null: + _camera.pan_to_tile(_selected_pawn.tile) + Audit.log("selection", "center_on_selection → %s" % _selected_pawn.tile) + get_viewport().set_input_as_handled() + return + + # ── Keyboard: Escape → deselect (lowest-priority; consumed last) ───────────── + # Designation._input handles Escape first; panels handle it in _unhandled_input + # before reaching here. If we still see it and have a selection, consume it. + if event.is_action_pressed("cancel") and _selected_pawn != null: + _deselect() + get_viewport().set_input_as_handled() + Audit.log("selection", "escape: deselected") + return + + # ── Mouse: only handle button events below ─────────────────────────────────── if not (event is InputEventMouseButton): return + + # ── Right-click: cancel designation (if active) or deselect pawn ───────────── + if event.button_index == MOUSE_BUTTON_RIGHT and event.pressed: + # Designation cancellation is handled by Designation._input; if we see + # this right-click, no designation was active. Deselect any selected pawn. + if _selected_pawn != null: + _deselect() + get_viewport().set_input_as_handled() + return + if event.button_index != MOUSE_BUTTON_LEFT: return # Designation paint mode owns input while active; Selection steps aside. @@ -102,3 +147,36 @@ func _select(pawn: Pawn) -> void: pawn.set_selected(true) EventBus.pawn_selected.emit(pawn) Audit.log("selection", "selected %s at %s" % [pawn.pawn_name, pawn.tile]) + + +## Clear the current selection without selecting another pawn. +func _deselect() -> void: + if _selected_pawn == null: + return + _selected_pawn.set_selected(false) + EventBus.pawn_deselected.emit() + Audit.log("selection", "deselected %s" % _selected_pawn.pawn_name) + _selected_pawn = null + + +## Cycle the selection forward (dir=1) or backward (dir=-1) through World.pawns. +## Wraps around. If no pawn currently selected, picks World.pawns[0]. +## Pans the camera to the newly selected pawn's tile. +func _cycle_pawn(dir: int) -> void: + var pawns: Array = World.pawns + if pawns.is_empty(): + return + var next_pawn: Pawn + if _selected_pawn == null: + next_pawn = pawns[0] + else: + var idx: int = pawns.find(_selected_pawn) + if idx == -1: + next_pawn = pawns[0] + else: + idx = posmod(idx + dir, pawns.size()) + next_pawn = pawns[idx] + _select(next_pawn) + if _camera != null: + _camera.pan_to_tile(next_pawn.tile) + Audit.log("selection", "pawn_cycle dir=%d → %s" % [dir, next_pawn.pawn_name]) diff --git a/scenes/world/world.gd b/scenes/world/world.gd index 2795489..a9ed397 100644 --- a/scenes/world/world.gd +++ b/scenes/world/world.gd @@ -122,6 +122,12 @@ func _ready() -> void: pathfinder.setup(MAP_SIZE_TILES) _wire_walls_to_pathfinder() selection.bind(pathfinder) + # Bind the camera so Tab-cycle and center-on-selection can pan to pawns. + var camera_rig := get_node_or_null("CameraRig") + if camera_rig != null: + selection.bind_camera(camera_rig) + else: + Audit.log("world", "selection.bind_camera: CameraRig not found") World.pathfinder = pathfinder # expose to entities (Tree.fell() walkability checks, etc.) # Phase 5 — expose TileMap layer refs on the autoload so entity code