Skip to content

The sprite walks behind the Dock, where it cannot be seen or grabbed #176

Closed

Description

@omesser

Related: #145 (the Dock's true bounds, which named this limitation), #5 (Perch: walking the edge, falling off), #153 (chase, which can also drive the sprite into the Dock).

What happens

Walking along the display floor beside the Dock, the sprite keeps going into the Dock's horizontal range and ends up behind the Dock island, where it is hard to see and hard to grab.

Why

#145 gave the Dock true bounds and made it a Perch, and dropped the floor beside it to the display's real bottom edge — so the floor now runs under the Dock island. Nothing stops horizontal travel there: the Engine treats windows and the Dock as surfaces to stand on, never as obstacles to walk into. #145's own PR named this as the known limitation it was leaving behind; this is that follow-up.

What it should do instead

The Dock's near side is a wall. On reaching it the sprite should either turn and walk back, or climb it — climb is already the Animation the Engine asks for when scaling a display edge, and the Dock's side is the same shape of problem. Climbing onto the Dock's top then continues onto a surface the sprite already knows how to stand on, which makes it the more attractive of the two.

Whichever is chosen, it must not fight the walk the way the edge clamp did in #141: the walk should stop or turn at the boundary rather than being pushed back into it every tick.

Acceptance

  • A walk that reaches the Dock's side does not pass behind the island.
  • The sprite stays reachable: it never comes to rest anywhere the user cannot see or grab it.
  • Whatever the choice — turn or climb — no stutter at the boundary, pinned by an Engine test that walks into the Dock and asserts the sprite neither enters the Dock's x-range at floor level nor oscillates.
  • A Dock that is hidden, or on a side edge, is unaffected: those are already modelled as absent.

Activity

  1. added
    bugSomething isn't working
    ready-for-agentFully specified, ready for an AFK agent
    on Sep 1, 2026
  2. omesser commented on Sep 2, 2026

    @omesser
    OwnerAuthor

    Shipped on main via #181.

    Dock side is now a wall: a walk (or a fall behind the Dock) climbs onto the Dock top as a Perch instead of ending up behind the island. Acceptance from this issue is met (no floor-level travel through the Dock's x-range, no #141-style stutter, hidden/side Docks unchanged).

  3. added this to the V1 milestone on Sep 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingready-for-agentFully specified, ready for an AFK agent

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions