RuggeroVisintin / RuggeroVisintin/SparkEngineWebEditor
Tile Map JSON Importer
Nobody has claimed this yet.
- 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
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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