Tile Picking & Interaction

SkillMonitoring & ops

Use when converting a mouse/touch position into the correct isometric tile for selection, highlighting, and placement.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Tile Picking & Interaction skill

What this skill tells your AI

The instructions your AI receives, as published by 0xheycat/isometric-game-skills in skills/tile-picking-interaction/SKILL.md and read by ahel’s review.

Overview

Picking is screen->grid with the camera inverse applied first. This skill turns a pointer position into the exact tile under it, with a highlight and hit-test that respects camera pan/zoom.

When to Use

  • Clicking selects the wrong tile.
  • You need hover highlight or click-to-place.
  • Picking ignores camera pan/zoom.

Process

  1. Take the pointer position in screen space.
  2. Apply the inverse camera transform (see camera-pan-zoom-controls).
  3. Apply screen->grid from isometric-grid-math and round to a tile.
  4. Clamp the result to map bounds and check walkable if needed.
  5. Draw a highlight on the picked tile for feedback.
  6. On click, dispatch the tile coord to the gameplay handler.
  7. Test picking at multiple zoom levels and pan offsets.
const world = screenToWorld(pointer, cam);
const tile = worldToGrid(world, W, H); // then round

Rationalizations (Stop Lying to Yourself)

ExcuseReality
"I will skip the camera inverse"Then picking breaks the moment you pan/zoom. Always invert.
"No need to highlight"Players need feedback on what they will click. Highlight.

Red Flags - STOP if you catch yourself:

  • Picking that ignores camera pan/zoom.
  • No rounding so edge tiles mis-select.
  • No visual highlight feedback.

Verification

You are NOT done until every box is checked:

  • Picked tile is correct at any pan and zoom.
  • Hover highlight matches the actual selected tile.
  • Clicks dispatch the right grid coordinate.

Signals

GitHub stars
21
Forks
3
Last commit
Aug 2026
Advanced
Item type
skill
Key
tile-picking-interaction
Source
github.com/0xheycat/isometric-game-skills