Skip to main content

tilemap-parser

Standalone parser/loader for tilemap-editor JSON maps, sprite animations, and a collision detection runtime.

Install

pip install tilemap-parser

Quick start

from tilemap_parser import load_map, TileLayerRenderer, Camera, ParticleField, FOG_PROFILE

game_data = load_map("path/to/map.json")
renderer = TileLayerRenderer(game_data)

camera = Camera(800, 600, mode="centered")
camera.follow(player)

# Persistent fog: fill once, wrap forever — no particle churn
mist = ParticleField(
    area=(0, 0, 800, 600),
    profile=FOG_PROFILE,   # plain data — copy and tweak for your own moods
    color=(200, 50, 80),
    global_alpha=0.5,
)

Features

  • Map parsing — tilemaps, layers, objects, and autotile data from JSON
  • Collision — tile-based (CollisionRunner) and object-to-object (ObjectCollisionManager) with rect, circle, capsule, and polygon shapes
  • Ground tile identity — CollisionResult.ground_tile / ground_tile_id report which tile supports a grounded sprite; custom tile properties are preserved on TileCollisionData.properties
  • Physics — PhysicsWorld with static/kinematic Body solids and one-way platforms
  • Particles — wrapped continuous fields (ParticleField, FOG_PROFILE), burst emitters, alpha fades, and batch rendering (SpriteBatchRenderer)
  • Pathfinding — A* Pathfinder over eroded NavGrids
  • Animation — frame-based AnimationPlayer, plus a Camera with centered/deadzone follow
  • Rendering — chunked TileLayerRenderer and LayerRenderStats

Requirements

  • Python 3.10+
  • pygame-ce>=2.5 (installed automatically)

Metadata

Release files for tilemap-parser 6.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tilemap-parser 6.0.1
File Size Uploaded Provenance Actions
tilemap_parser-6.0.1.tar.gz 165.3 kB Without provenance Details for tilemap_parser-6.0.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for tilemap-parser 6.0.1
File Interpreter ABI Platform Actions
tilemap_parser-6.0.1-py3-none-any.whl Python 3 none any Details for tilemap_parser-6.0.1-py3-none-any.whl

Total release size: 260.5 kB

Release files / tilemap_parser-6.0.1.tar.gz

Download URL tilemap_parser-6.0.1.tar.gz
Size 165.3 kB
Tags Source
SHA-256 checksum
How to use checksums
278106fd3cf3f36373cf3cc626fb02798c4a88cff72ee83a9ea0dbd87913a090
BLAKE2b-256 checksum
How to use checksums
9040773d28e52b4829b53e61a3cb35129d8283c43ded7eba57fddca6764e3f68
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / tilemap_parser-6.0.1-py3-none-any.whl

Download URL tilemap_parser-6.0.1-py3-none-any.whl
Size 95.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
44ceea1cccb5284de8b009125b6d0b31b0a75b0468234cfcdad8968c8bf947cb
BLAKE2b-256 checksum
How to use checksums
e56e8b04d320f0132512bf47caa359540c2f7351022930bf4c2673f6b12d2f02
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Security for tilemap-parser 6.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

6.0.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page