tilemap-parser
standalone map parser + pygame collision runtime for game developers
Python >= 3.10 · pygame-ce · version v5.2.0
WHAT YOU GET
Everything hangs off one spine: load data, build a world, resolve movement through the runner. The rooms below are the whole engine.
Load and query tilemaps, layers, objects and autotiles from tilemap-editor JSON.
Slide, platformer and RPG movement modes resolved against tile polygons.
A PhysicsWorld: tiles + solid Body objects, kinematic crates you push around.
Sprite-vs-sprite lane: spatial-grid, mixed shapes, layer filtering.
TileLayerRenderer culls to the viewport, chunk-by-chunk.
Centered/deadzone follow, lerp, screen-shake, bounds clamp.
Frame-based AnimationPlayer over tilemap-editor animation JSON.
ParticleSystem with shapes, color transitions, alpha fade, batch rendering.
NavGrid, Pathfinder and PathFollower for RPG-style AI.
Capsule collision against every shape, and CollisionHit.resolve() helpers.
WHERE TO START
- Installation: two pip commands and you're running.
- Quick Start: the smallest playable program.
- Physics & Bodies: collision, explained without the fog of war. Includes the sliding-box walkthrough.
- The Pipeline: map → world → runner → player → crate → screen, one script.
- Examples: nine working demos, from pushable crates to RPG pathfinding.
Author maps and collision with the companion editor: tilemap-editor.