skills.rest
MatthieuGagne
MatthieuGagneCOMMUNITY
Explore all skills by this author →
GitHub

emulicious-debug

Debug GBDK-2020 Game Boy Color games with Emulicious and VS Code.

Updated Mar 9, 2026
Search Tags:#vscode#debugging#emulator#game boy#gbdk-2020#emulicious
One-click install
npx skills add https://github.com/MatthieuGagne/gmb-nuke-raider --skill emulicious-debug
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: emulicious-debug
Source: https://github.com/MatthieuGagne/gmb-nuke-raider/tree/main/.claude/skills/emulicious-debug
Command: npx skills add https://github.com/MatthieuGagne/gmb-nuke-raider --skill emulicious-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides comprehensive debugging capabilities for Game Boy Color (GBC) games developed with GBDK-2020, enabling developers to identify and fix runtime issues efficiently.

Core Features & Use Cases

  • In-ROM Logging: Use EMU_printf to send debug messages directly to the Emulicious console.
  • VS Code Integration: Set up a step-through debugger with breakpoints, variable inspection, and execution control.
  • Emulicious UI Tools: Leverage memory editors, tile viewers, sprite viewers, and more for deep inspection of game state.
  • ROM Usage Analysis: Utilize romusage to understand memory and ROM space allocation.
  • Use Case: When your game crashes unexpectedly or exhibits visual glitches, use this Skill to pinpoint the exact line of code causing the issue, inspect variable values, and visualize memory or sprite states.

Quick Start

Launch the game in Emulicious by running java -jar /home/mathdaman/.local/share/emulicious/Emulicious.jar build/junk-runner.gb.

Frequently Asked Questions about emulicious-debug

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

FAQPage Schema
How do I debug a GBDK-2020 Game Boy Color game in VS Code?▼

Debug GBDK-2020 games in VS Code by integrating the Emulicious emulator with the VS Code debugger extension, enabling step-through source-level debugging, breakpoints, and variable inspection.

What is the best way to troubleshoot visual glitches and runtime crashes in Game Boy Color homebrew?▼

To troubleshoot Game Boy Color visual glitches and crashes, use Emulicious UI tools like memory editors, tile viewers, and sprite viewers to inspect live game state and pinpoint the exact code causing unexpected behavior.

Can I use in-ROM logging to trace execution in Emulicious?▼

Yes, you can use in-ROM logging in Emulicious by implementing the EMU_printf function to send debug messages directly to the Emulicious console during game execution.

Do I need the Emulicious emulator and VS Code extension to debug GBDK-2020 games?▼

Yes, source-level debugging for GBDK-2020 requires both the Emulicious emulator and the VS Code debugger extension to analyze live state and enable step-through execution control.

How do I analyze ROM space allocation for a Game Boy Color ROM?▼

Analyze Game Boy Color ROM space allocation by utilizing the romusage tool, which helps you understand memory and ROM space distribution within your compiled game build.

Related Skills

Explore More Software Engineering Skills→
MatthieuGagneMatthieuGagne

gb-memory-validator

Validates Game Boy Color ROM, WRAM, VRAM and OAM memory usage after build.

Community
Intermediate
wonton-web-workswonton-web-works
1

mg-debug

Coordinate QA, development, and security roles through a structured debugging workflow.

Official
Advanced
MatthieuGagneMatthieuGagne

build

Compile, clean, and test the Junk Runner Game Boy Color project with GBDK-2020.

Community
Intermediate
drheliusdrhelius
1.2k

gearboy-debugging

Debug Game Boy games via Gearboy MCP server with execution control.

Community
Advanced