gbcore

A basic GB/GBC emulator made for educational purposes, just to learn about the system! It executes whole instructions and scanlines rather than being cycle-accurate.

• 🧠 CPU, 🖥️ PPU, 🔊 APU
• 🌈 GBC features: WRAM/VRAM banks, palettes, tile attributes, priority rules, double-speed mode, VRAM DMA
• 🎮 Input support: keyboard and gamepad
• ⏲️ Timer support
• 🗜️ Mappers: NoMBC, MBC1, MBC2, MBC3, MBC5
• 📷 Save states
• 🐏 Save files

• Accurate timing
• Accurate initial state
• Serial
• IR port
• STOP instruction
• MBC3's RTC
• MBC5's rumble
• ...and more! ✨

npm install --save gbcore

// configure video and audio:
const onFrame = (frameBuffer) => {
  // write `frameBuffer` (a Uint32Array) to screen...
};
const onSample = (sample) => {
  // write `sample` (a number) to audio buffer...
};

// create an instance:
const gb = new Emulator(onFrame, onSample);

// load a game:
gb.load(rom); // rom = Uint8Array

// run at 60 fps, or as fast as you can:
{
  gb.setButton(1, "BUTTON_A", true); // player = 1, button = A, pressed = true
  gb.setButton(1, "BUTTON_DOWN", false); // player = 1, button = DOWN, pressed = false
  // ...set the rest of the buttons
  gb.frame();
}

// save / restore states:
const saveState = gb.getSaveState();
gb.setSaveState(saveState);

👀 Have a look at the demo implementation for more details.

You can inspect the emulator state by using the global window.gb object.

Also, if you add ?debug to the URL and use a gamepad, shoulder buttons will behave as follows:

2--4
1--3

1: Enter debug mode
2: Exit debug mode
3: Hold to run frame
4: Hold to run scanline

• Pan Docs
• Dan Docs