emulator: Gearboy
type: libretro
core_classification: official_port
source: "https://github.com/drhelius/Gearboy"
upstream: "https://github.com/drhelius/Gearboy"
profiled_date: "2026-03-23"
core_version: "3.4.1"
display_name: "Nintendo - Game Boy / Color (Gearboy)"
cores:
  - gearboy
systems:
  - nintendo-gb
  - nintendo-gbc

notes: |
  Gearboy is a Game Boy / Game Boy Color emulator by drhelius (Ignacio Sanchez).
  The buildbot builds from drhelius/Gearboy (upstream), not from libretro/Gearboy
  (abandoned fork frozen at v2.6.0 from 2018).
  Bootrom loading is gated behind core options (disabled by default).
  Without bootroms, the core HLE-skips the boot animation.

files:
  - name: dmg_boot.bin
    description: Game Boy DMG bootrom
    size: 256
    required: false
    hle_fallback: true
    validation: [size]
    source_ref: "libretro.cpp:208,211 Memory.cpp:601-606,699-738"

  - name: cgb_boot.bin
    description: Game Boy Color bootrom
    size: 2304
    required: false
    hle_fallback: true
    validation: [size]
    source_ref: "libretro.cpp:209,212 Memory.cpp:608-611,699-738"