map-expert

Convert Tiled TMX maps to C arrays for the Junk Runner game.

Updated Mar 9, 2026
One-click install
npx skills add https://github.com/MatthieuGagne/gmb-nuke-raider --skill map-expert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: map-expert
Source: https://github.com/MatthieuGagne/gmb-nuke-raider/tree/main/.claude/skills/map-expert
Command: npx skills add https://github.com/MatthieuGagne/gmb-nuke-raider --skill map-expert

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides comprehensive guidance for creating, editing, and converting maps for the Junk Runner game, ensuring seamless integration between design tools and the game engine.

Core Features & Use Cases

  • Map Pipeline Management: Understand the workflow from Tiled authoring to GB hardware rendering.
  • Tool Reference: Detailed usage for Python scripts like tmx_to_c.py and png_to_tiles.py.
  • GB Hardware Deep Dive: Explains VRAM layout, scroll registers, and GBDK APIs for background tilemaps.
  • Use Case: Convert a new track design in Tiled into the C array format required by the game engine, ensuring correct tile indexing and map data.

Quick Start

Use the map-expert skill to convert the Tiled map 'assets/maps/track.tmx' into the C array format for the game.

Frequently Asked Questions about map-expert

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a Tiled TMX map to a C array for Game Boy development?

To convert a Tiled TMX map to a C array, you use a Python asset pipeline script like tmx_to_c.py. This process decodes GIDs and translates your Tiled map data into the correct C array format required by the GBDK game engine.

How does Game Boy background tilemap hardware work with GBDK?

Game Boy background tilemaps use specific VRAM layouts and scroll registers to render maps. The map-expert guidance details these hardware constraints and explains how to manipulate them using GBDK APIs for proper tile rendering.

What is the best way to handle Tiled format pitfalls when converting maps?

Handling Tiled format pitfalls requires understanding GID decoding and the specific TMX structure. The Skill addresses common Tiled format issues directly, ensuring your map data maintains correct tile indexing during the conversion to C arrays.

Can I use Python scripts to convert PNG tiles for a GBDK game?

Yes, you can convert PNG tiles using the png_to_tiles.py script. This tool processes your image assets into the tile format needed for the Game Boy hardware, preparing them for integration with your map data.

Why does my Tiled map show incorrect tile indexing after conversion?

Incorrect tile indexing usually stems from unresolved Tiled format pitfalls or GID decoding errors. The Skill helps you identify these specific TMX format issues and correct the mapping logic in your Python asset pipeline scripts.