ludic/docs/language/tiled/tiled-collision_kind.md
Orkuncakilkaya 0cb57774d7
All checks were successful
bootstrap / cfree-fixpoint (push) Successful in 20s
ci / build-and-test (push) Successful in 1m51s
commit-lint / conventional-commits (push) Successful in 3s
docs / build-and-deploy (push) Successful in 28s
feat(stdlib): Tiled P2 — collision normalisation into the Solids feed (#70)
Normalise three collision sources into the byte tilemap esys_move / Grid.* /
Path.* read, in the design's priority order (§3.5):

- per-tile <objectgroup> hitboxes (Tiled.tile_shapes) — the precise source;
- the solid/oneway/trigger bool property convention (Tiled.collision_kind);
- the designated collision layer — any non-zero GID solid (Tiled.project),
  the fallback source, applied automatically on load.

Tiled.collide drives collision from a visual layer's per-tile metadata alone
(a tile with no collision metadata stays passable). tmap_collision_kind
classifies a GID (0 none / 1 solid / 2 one-way / 3 trigger) from its metadata;
the projection adds the collision-layer fallback.

Proven by library/tiled_p2.ludic (14 assertions): kind classification for each
source, the property convention and collision-layer fallback producing an
identical Solids feed, a per-tile-<objectgroup> floor blocking an esys_move
mover, and A* over a loaded map matching the hand-authored baseline. x test:
93 passed.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-09-01 14:50:27 +03:00

685 B


id: tiled-collision_kind name: Tiled.collision_kind category: tiled kind: namespace-method tokens: Tiled.collision_kind sig: Tiled.collision_kind(map, gid: int) -> int tip: Classify a GID's collision from its tile metadata. order: 15 ns: Tiled member: collision_kind

Returns the collision kind a GID resolves to from its tile metadata, in the design's priority order (per-tile <objectgroup> hitboxes, then the property convention): 0 none, 1 solid, 2 one-way, 3 trigger. The collision-layer fallback (any non-zero GID solid) is applied by Tiled.project, not here.