map-builder

Convert Tiled maps and Aseprite tilesets into C code for Junk Runner.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the process of creating and integrating new game maps into the Junk Runner project, from initial design to in-game implementation.

Core Features & Use Cases

  • Map Design: Guides users through designing game maps using Tiled.
  • Asset Pipeline: Details the conversion of Tiled maps and Aseprite tilesets into C code.
  • Integration: Explains how to wire generated C files into the game's codebase.
  • Use Case: A new developer needs to add a new race track to Junk Runner. They can follow this Skill's steps to design the track in Tiled, convert it to C data, and integrate it into the game's build.

Quick Start

Use the map-builder skill to create a new map named 'desert-track' following the Tiled to C pipeline.

Frequently Asked Questions about map-builder

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

FAQPage Schema
How do I convert Tiled map files to C code for GBDK game development?

To convert Tiled maps to C code for GBDK, use a Python-based conversion pipeline that transforms TMX files and Aseprite tilesets into C data structures, which you then wire into your game's build process.

What layer naming conventions are required when designing game maps in Tiled for C conversion?

Designing game maps in Tiled for C conversion requires adherence to specific layer naming conventions and object group requirements within Tiled, ensuring the Python pipeline correctly parses and translates the TMX file into valid C data.

Can I use Aseprite tilesets with Tiled to generate C data for a GBDK project?

Yes, you can use Aseprite tilesets with Tiled to generate C data for a GBDK project by running them through a Python-based asset pipeline that handles both tile set generation and the subsequent TMX to C conversion.

What is the best way to integrate new game maps into a C programming build process?

The best way to integrate new game maps into a C programming build process is to design the map in Tiled, convert the TMX file to C data using a Python script, and wire the generated C files directly into the game's codebase.

Do I need Python to convert TMX files to C code for game development?

Yes, you need Python to convert TMX files to C code for game development, as the asset pipeline relies on a Python-based conversion script to translate Tiled map layouts and tilesets into functional C data structures.