{
  "commit": "d38cd580364b2c788e633b9e51c15e1668f726c0",
  "count": 1,
  "generated_at": "2026-11-03T13:36:34Z",
  "items": [
    {
      "id": "gambatte",
      "profile": {
        "core_classification": "community_fork",
        "core_version": "v0.5.0",
        "cores": [
          "gambatte"
        ],
        "display_name": "Nintendo - Game Boy / Color (Gambatte)",
        "emulator": "Gambatte",
        "files": [
          {
            "description": "Original Game Boy (DMG-01) boot ROM",
            "hle_fallback": true,
            "min_size": 256,
            "name": "gb_bios.bin",
            "note": "Mapped at 0x0000-0x00FF, swapped out when register 0xFF50 is written.",
            "required": false,
            "source_ref": "source libgambatte/libretro/libretro.cpp:1426-1486 (get_bootloader_from_file), source libgambatte/libretro/libretro.cpp:1734-1742, source libgambatte/src/bootloader.cpp:30-65 (load)",
            "system": "nintendo-gb",
            "validation": [
              "size"
            ]
          },
          {
            "description": "Game Boy Color (CGB-001) boot ROM",
            "hle_fallback": true,
            "min_size": 2304,
            "name": "gbc_bios.bin",
            "note": "Mapped at 0x0000-0x08FF with cartridge data preserved at 0x0100-0x01FF. Also used for GBA mode with a patch at 0xF2. Presence required for FORCE_CGB flag when hw mode is GBC or GBA.",
            "required": false,
            "source_ref": "source libgambatte/libretro/libretro.cpp:1426-1486 (get_bootloader_from_file), source libgambatte/libretro/libretro.cpp:1734-1742, source libgambatte/src/bootloader.cpp:30-65 (load)",
            "system": "nintendo-gbc",
            "validation": [
              "size"
            ]
          },
          {
            "description": "Custom DMG colour palette",
            "name": "default.pal",
            "note": "Read only when GB Colorization is custom and no palette named after the ROM file or the header title exists.",
            "path": "palettes/default.pal",
            "required": false,
            "source_ref": "source libgambatte/libretro/libretro.cpp:2012-2091, source libgambatte/libretro/libretro.cpp:2521-2522, source libgambatte/libretro/libretro.cpp:2582-2583",
            "system": "nintendo-gb",
            "unsourceable": "user-created palette, the core and its repository distribute none"
          }
        ],
        "notes": "Accuracy-focused GB/GBC emulator. No BIOS required for normal operation:\nthe built-in HLE boot sequence skips the Nintendo logo animation.\n\nCore option gambatte_gb_bootloader (default: enabled) enables loading\nofficial boot ROMs from the system directory for the real startup animation.\nIf missing, emulation works without them.\n\nBoot ROM selection by hardware mode:\n- DMG: gb_bios.bin (256 bytes)\n- CGB or GBA: gbc_bios.bin (2304 bytes)\n\nIn GBA mode the core patches the CGB boot ROM at 0xF2 to fake GBA\ndetection (ld b,0x01), enabling GBA-enhanced features in compatible\nGBC games.\n\nThe upstream standalone supports SGB boot ROM loading, but the libretro\nport does not implement this.\n\nWith GB Colorization set to \"custom\", a DMG game reads the first of\npalettes/<rom name>.pal, palettes/<header title>.pal and\npalettes/default.pal under the system directory. Each line sets one of\nthe twelve background and sprite colours as Background0= to Sprite%2023=\nwith a 24-bit RGB value. Colours the file leaves out keep their previous\nvalue (libgambatte/libretro/libretro.cpp:2012-2191,\nlibgambatte/libretro/libretro.cpp:2521-2522,\nlibgambatte/libretro/libretro.cpp:2582-2583).\n",
        "profiled_date": "2026-03-23",
        "source": "https://github.com/libretro/gambatte-libretro",
        "source_commit": "7809bb68ee96c3e6c74e9d9c4c8bb09aa7c6801d",
        "systems": [
          "nintendo-gb",
          "nintendo-gbc"
        ],
        "type": "libretro",
        "upstream": "https://github.com/sinamas/gambatte",
        "version_basis": {
          "kind": "file",
          "path": "libgambatte/libretro/libretro.cpp",
          "pattern": "library_version\\s*=\\s*\"(v[0-9.]+)\"\\s*GIT_VERSION"
        }
      }
    }
  ],
  "kind": "emulators",
  "schema_version": 1
}