RuggeroVisintin / RuggeroVisintin/SparkEngineWebEditor

Tile Map JSON Importer

Open
#382 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
TypeScript
Stars
2
Forks
0
PR merge metrics
No merged PRs in 30d

Description

AS A Game Developer
I WANT TO import a Tiled map JSON file
SO THAT I can use specific 2D map editors to build level environments for my game

✅ Acceptance Criteria

  • Tile Layer Ingestion: The engine successfully reads grid dimensions, tile sizes, and populates the scene's native tilemap structure using the map's JSON data array.

  • Tileset & Texture Resolution: The importer correctly resolves relative image paths from the JSON and binds the atlas texture to the internal renderer.

  • Entity Spawning: objectgroup layers are parsed, instantiating engine Entities (e.g., player spawn, enemies, triggers) at their corresponding X, Y positions.

  • Graceful Fallbacks: Unsupported Tiled features (e.g., tile rotation flags, image layers, hexagonal grids) do not crash the engine and emit clear console warnings instead.

  • Property Mapping: Custom key-value properties defined in Tiled are passed to instantiated scene entities upon creation.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No file or test entry point is named. Start by locating the TypeScript tilemap, scene-loading, and entity-creation entry points, then map the Tiled JSON requirements to those systems. Done means all listed acceptance criteria are met, including warnings for unsupported features.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
game-dev
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.