{
  "commit": "d38cd580364b2c788e633b9e51c15e1668f726c0",
  "count": 1,
  "generated_at": "2026-11-03T13:36:34Z",
  "items": [
    {
      "id": "geargrafx",
      "profile": {
        "core_classification": "official_port",
        "core_version": "1.8.5-10-g7c447b0",
        "cores": [
          "geargrafx"
        ],
        "display_name": "NEC - PC Engine / SuperGrafx / CD (Geargrafx)",
        "emulator": "Geargrafx",
        "files": [
          {
            "crc32": [
              "6d9a73ef",
              "0ecea1f3",
              "2b5b75fe"
            ],
            "description": "Super CD-ROM System Card 3.0",
            "name": "syscard3.pce",
            "note": "Loaded for the default option value System Card 3 and for Force Game Express. game_db.h accepts three images under this name: Japan (CRC32 6D9A73EF), the Japan NuFont Hack (CRC32 0ECEA1F3, syscard3.pce patched with xlateFont-JPN.ips from dshadoff/SYSCARD_Translatefont) and USA (CRC32 2B5B75FE).\n",
            "required": true,
            "size": [
              262144,
              262656
            ],
            "source_ref": "platforms/libretro/libretro.cpp:766, platforms/libretro/libretro.cpp:778-783, platforms/libretro/libretro.cpp:788-798, src/media.cpp:740-783, src/defines.h:53, src/game_db.h:51-52, src/game_db.h:54",
            "system": "nec-pc-engine-cd",
            "validation": [
              "size"
            ]
          },
          {
            "crc32": [
              "52520bc6",
              "283b74e0",
              "ff2a5ec3"
            ],
            "description": "CD-ROM System Card 2.0 / 2.1",
            "name": "syscard2.pce",
            "note": "Loaded when geargrafx_cdrom_bios is System Card 2. game_db.h accepts v2.0 Japan (CRC32 52520BC6), v2.1 Japan (CRC32 283B74E0) and USA (CRC32 FF2A5EC3).\n",
            "required": false,
            "size": [
              262144,
              262656
            ],
            "source_ref": "platforms/libretro/libretro.cpp:765, platforms/libretro/libretro.cpp:775-776, src/media.cpp:740-783, src/defines.h:53, src/game_db.h:49-50, src/game_db.h:53",
            "system": "nec-pc-engine-cd",
            "validation": [
              "size"
            ]
          },
          {
            "crc32": "3F9F95A4",
            "description": "CD-ROM System Card 1.0 (Japan)",
            "name": "syscard1.pce",
            "note": "Loaded when geargrafx_cdrom_bios is System Card 1.",
            "required": false,
            "size": [
              262144,
              262656
            ],
            "source_ref": "platforms/libretro/libretro.cpp:764, platforms/libretro/libretro.cpp:772-773, src/media.cpp:740-783, src/defines.h:53, src/game_db.h:48",
            "system": "nec-pc-engine-cd",
            "validation": [
              "size"
            ]
          },
          {
            "crc32": [
              "51a12d90",
              "16aaf05a"
            ],
            "description": "Games Express CD Card",
            "name": "gexpress.pce",
            "note": "Always attempted after the System Card, used for discs flagged GG_GAMEDB_GAME_EXPRESS in game_db.h, for MMI images whose card is Games Express, or when the option is Force Game Express. game_db.h accepts the Blue Version (CRC32 51A12D90) and the Green Version (CRC32 16AAF05A). Both CRCs are of 32768-byte images: the 16384-byte Green dump (CRC32 20E0A364) is rejected on size and matches 16AAF05A once zero-padded to 32768 bytes.\n",
            "required": false,
            "size": [
              32768,
              33280
            ],
            "source_ref": "platforms/libretro/libretro.cpp:767, platforms/libretro/libretro.cpp:800-801, src/media.cpp:740-783, src/media.cpp:915-917, src/media.cpp:929-933, src/media.cpp:1087-1091, src/defines.h:54, src/game_db.h:55-56",
            "system": "nec-pc-engine-cd",
            "validation": [
              "size"
            ]
          },
          {
            "crc32": "A8CB694C",
            "description": "LaserActive NEC PAC-N1 v1.02 (Japan)",
            "name": "pac-n1.bin",
            "note": "Japanese PAC firmware, read for MMI content when geargrafx_laseractive_region is Auto or Japan. The Japanese slot accepts the PAC-N1 and PCE-LP1 images under either file name.\n",
            "region": [
              "japan"
            ],
            "required": true,
            "size": [
              524288,
              524800
            ],
            "source_ref": "platforms/libretro/libretro.cpp:514, platforms/libretro/libretro.cpp:528-529, platforms/libretro/libretro.cpp:832-836, platforms/libretro/libretro.cpp:551-566, src/media.cpp:648-710, src/defines.h:55",
            "system": "laseractive",
            "validation": [
              "size"
            ]
          },
          {
            "crc32": "76116A02",
            "description": "LaserActive NEC PCE-LP1 v1.02 (Japan)",
            "name": "pce-lp1.bin",
            "note": "Read only when pac-n1.bin did not load.",
            "region": [
              "japan"
            ],
            "required": false,
            "size": [
              524288,
              524800
            ],
            "source_ref": "platforms/libretro/libretro.cpp:837-841, src/media.cpp:648-710, src/defines.h:55",
            "system": "laseractive",
            "validation": [
              "size"
            ]
          },
          {
            "crc32": "01223DD5",
            "description": "LaserActive NEC PAC-N10 v1.02 (US)",
            "name": "pac-n10.bin",
            "note": "US PAC firmware, read for MMI content when geargrafx_laseractive_region is Auto or US.\n",
            "region": [
              "north-america"
            ],
            "required": true,
            "size": [
              524288,
              524800
            ],
            "source_ref": "platforms/libretro/libretro.cpp:514, platforms/libretro/libretro.cpp:528-529, platforms/libretro/libretro.cpp:844-848, platforms/libretro/libretro.cpp:551-566, src/media.cpp:648-710, src/defines.h:55",
            "system": "laseractive",
            "validation": [
              "size"
            ]
          }
        ],
        "notes": "Geargrafx is a PC Engine / TurboGrafx-16 / SuperGrafx / CD-ROM emulator by\nIgnacio Sanchez (drhelius). HuCard games run without any external file.\n\nCD-ROM content (cue, chd, mmi) needs a System Card image from the frontend\nsystem directory. load_bios() in platforms/libretro/libretro.cpp:761-802\npicks the file name from the core option geargrafx_cdrom_bios\n(platforms/libretro/libretro.cpp:1645-1668): System Card 1 loads\nsyscard1.pce, System Card 2 loads syscard2.pce, System Card 3 (the default)\nand Force Game Express load syscard3.pce. The older values Auto and Game\nExpress are still accepted and map to the same. The path is\n\"{system_directory}/{name}\" (platforms/libretro/libretro.cpp:788). When the\ncard is missing the core posts \"CD-ROM BIOS not found\" and continues\n(platforms/libretro/libretro.cpp:789-798). gexpress.pce is then always\nattempted from the same directory (platforms/libretro/libretro.cpp:800-801).\nload_bios() runs from retro_load_game() for CD content only\n(platforms/libretro/libretro.cpp:525-526) and again on retro_reset() when a\nCD is loaded (platforms/libretro/libretro.cpp:362-363). With the libretro\nVFS the file goes through load_bios_file() into LoadBiosFromBuffer(),\notherwise through Media::LoadBios() (platforms/libretro/libretro.cpp:724-759,\nsrc/media.cpp:526-569).\n\nMedia::LoadBiosData() (src/media.cpp:740-783) strips a 512-byte header when\nthe size is the expected size plus 512, then rejects any image whose size\nis not GG_BIOS_SYSCARD_SIZE (0x40000) or GG_BIOS_GAME_EXPRESS_SIZE (0x8000)\n(src/defines.h:53-54). CRC32 is computed over the accepted image.\nGatherBIOSInfoFromDB() (src/media.cpp:1121-1155) looks the CRC up in\nk_game_database entries flagged GG_GAMEDB_BIOS_SYSCARD or\nGG_GAMEDB_BIOS_GAME_EXPRESS (src/game_db.h:48-56). An unknown CRC marks the\nimage \"Unknown\" and invalid but it is still used.\n\nFor CD content the ROM banks map onto the System Card buffer, or onto the\nGame Express buffer when the disc is a Game Express title\n(src/media.cpp:1188-1197). A Game Express disc is detected by its CRC in\ngame_db.h (GG_GAMEDB_GAME_EXPRESS, src/media.cpp:1087-1091), named by the\ncard field of an MMI image (src/media.cpp:915-917) or forced by the option\n(src/media.cpp:929-933). With no card loaded the buffer is zeros and the CD\ndoes not boot. Arcade Card titles are also detected from game_db.h and run\non the selected System Card.\n\nMMI content is a LaserActive LD-ROM2 image. retro_load_game() also calls\nload_pac_bios() for it (platforms/libretro/libretro.cpp:528-529), which\nreads the NEC PAC firmware from the system directory according to the core\noption geargrafx_laseractive_region (platforms/libretro/libretro.cpp:1680-1691):\nJapan loads pac-n1.bin and falls back to pce-lp1.bin, US loads pac-n10.bin,\nAuto (the default) loads both regions\n(platforms/libretro/libretro.cpp:827-849). Media::LoadPacBiosData()\n(src/media.cpp:648-710) accepts 0x80000 bytes (GG_BIOS_LASERACTIVE_SIZE,\nsrc/defines.h:55), with or without a 512-byte header, and compares the\nCRC32 with the values hardcoded for the region. An unknown CRC is logged\nand the image is still used. SelectPacBios() (src/media.cpp:712-738) follows\nthe option, then the regionCode of the MMI image, then whichever region is\nloaded. An MMI image that names no card maps the PAC firmware\n(src/media.cpp:1188-1197), and one that names a card uses the System Card or\nGame Express buffer. retro_load_game() fails when the firmware the MMI\nimage needs is not loaded (platforms/libretro/libretro.cpp:551-566).\n\nBackup RAM is exposed through RETRO_MEMORY_SAVE_RAM\n(platforms/libretro/libretro.cpp:650-658) and saved by the frontend. A\nconnected Memory Base 128 is persisted by the core itself as\ngeargrafx_mb128.sav in the frontend save directory\n(platforms/libretro/libretro.cpp:851-931). Both are state the core writes,\nnot files a user obtains.\n",
        "profiled_date": "2026-10-04",
        "source": "https://github.com/drhelius/Geargrafx",
        "source_commit": "7c447b0bd46b6085abdf1d685b49480f4a295c17",
        "systems": [
          "nec-pc-engine",
          "nec-supergrafx",
          "nec-pc-engine-cd",
          "laseractive"
        ],
        "type": "libretro",
        "upstream": "https://github.com/drhelius/Geargrafx",
        "valid_bios_crc32": {
          "game_express": [
            {
              "crc32": "51A12D90",
              "name": "Games Express CD Card Blue Version (J)"
            },
            {
              "crc32": "16AAF05A",
              "name": "Games Express CD Card Green Version (J)"
            }
          ],
          "laseractive_japan": [
            {
              "crc32": "A8CB694C",
              "name": "PAC-N1 v1.02"
            },
            {
              "crc32": "76116A02",
              "name": "PCE-LP1 v1.02"
            }
          ],
          "laseractive_us": [
            {
              "crc32": "01223DD5",
              "name": "PAC-N10 v1.02"
            }
          ],
          "syscard": [
            {
              "crc32": "3F9F95A4",
              "name": "CD-ROM System Card 1.0 (J)"
            },
            {
              "crc32": "52520BC6",
              "name": "CD-ROM System Card 2.0 (J)"
            },
            {
              "crc32": "283B74E0",
              "name": "CD-ROM System Card 2.1 (J)"
            },
            {
              "crc32": "6D9A73EF",
              "name": "Super CD-ROM System 3.0 (J)"
            },
            {
              "crc32": "0ECEA1F3",
              "name": "Super CD-ROM System 3.0 (J) NuFont Hack"
            },
            {
              "crc32": "FF2A5EC3",
              "name": "TurboGrafx CD System Card 2.0 (USA)"
            },
            {
              "crc32": "2B5B75FE",
              "name": "TurboGrafx CD Super System 3.0 (USA)"
            }
          ]
        },
        "version_basis": {
          "distance": 10,
          "kind": "tag",
          "tag": "1.8.5"
        }
      }
    }
  ],
  "kind": "emulators",
  "schema_version": 1
}
