rom-banking

Diagnose ROM bank overflow and assign memory banks for Junk Runner assets.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses critical issues in Junk Runner's ROM memory management, preventing blank screen crashes caused by incorrect bank assignments and optimizing asset placement.

Core Features & Use Cases

  • Diagnose ROM Banking Issues: Identify and fix blank screen crashes related to bank overflow or incorrect memory mapping.
  • Optimize Asset Placement: Ensure critical game code and data reside in the correct memory banks for stable execution.
  • Use Case: If your Junk Runner game crashes with a blank screen shortly after booting, this Skill provides the tools and knowledge to diagnose and resolve the underlying ROM banking conflict.

Quick Start

Use the rom-banking skill to check the bank 1 usage in build/nuke-raider.gb.

Frequently Asked Questions about rom-banking

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

FAQPage Schema
Why does my Game Boy game crash with a blank screen at low FPS?

A blank screen crash at low FPS is typically caused by ROM bank overflow or incorrect memory mapping in your game engine. Diagnosing the issue requires analyzing romusage output and map files to verify bank percentages and symbol locations for critical game code.

How do I optimize ROM memory banking for a GBDK game project?

To optimize ROM memory banking, you must ensure critical game code, portraits, and tile data reside in the correct memory banks. This involves analyzing map files to verify symbol locations and adjusting bank assignments to prevent overflow during game state transitions.

What is the best way to diagnose memory bank overflow in a Game Boy ROM?

The best way to diagnose memory bank overflow is to analyze romusage output and map files. This process verifies bank percentages and symbol locations, ensuring assets and game states are correctly assigned to their respective memory banks for stable execution.

How do I fix incorrect memory bank assignments causing game crashes?

Fixing incorrect memory bank assignments involves analyzing your build output to identify overflowed banks. You must then reallocate game states, portraits, and tile data to the correct memory banks to ensure stable execution and prevent blank screen crashes.

Can I use romusage output to verify ROM bank percentages for asset placement?

Yes, romusage output is essential for verifying ROM bank percentages and symbol locations. Analyzing this output alongside map files allows you to confirm that asset placement and game code reside in the correct memory banks without exceeding capacity.

What are the limitations of managing ROM memory banking for complex game states?

The primary limitation in ROM memory banking is bank capacity overflow, which occurs when game states, portraits, and tile data exceed allocated memory banks. Without analyzing map files to verify symbol locations, incorrect assignments will cause blank screen crashes.