Maps - UQcsse3200/2026-studio-1 GitHub Wiki

The Map System provides the spatial foundation for levels: a grid of typed tiles loaded from structured JSON files, the collision derived from that tile data, and the shared components other systems use to read map and spawn information.

Pages

Formatting

• Map Format | Guide for the "New" Map Formatting System

Levels

• Level 1: Out of the Underworld | Greek catacombs and the river Styx: regions, tile set, actors, and the intended route.
• Level 2: Climb Mount Olympus | the ascent from the foothills to the palace: bands, tile set, actors, and the intended route.

Tile-Based Level Map

• Tile-Based Level Map | overview: the format, tile types, and layers.
• Tile-Based Level Map: Technical Reference | classes, API, file format, and diagrams.

Reusable Map Components

• Reusable Map Components | shared TileType/CollisionType, the MapLoader interface, and spawn-point data structures.

Collision Layer

• Collision Layer | turning tile data into Box2D colliders, and hazard-tile damage.
• One-Way Cloud Platforms | Level 2 platforms that can be crossed from below and landed on from above.

Integration

• Maps Migration Guide | what changed when the game moved from ForestGameArea to LevelGameArea, and how it affects other teams.
• Progression Mini-Map | Vertical HUD indicator showing player progress across Levels.

Contributing a page

Adding a map-related page? Create your wiki page, then add a bullet to the matching section above so it's discoverable. Keep page names in Title-Case-With-Hyphens so the links resolve.