Neo Geo CD
Overview
The Neo Geo CD application is an emulator for the Neo Geo CD game console.
Adding Games (Feed Editor)
Due to large Disc image sizes, adding Neo Geo CD-based games in the Feed Editor must be done manually (versus using auto-detection).
Important
The Neo Geo CD application only supports the .CHD disc file format (.ISO, .BIN, and .CUE are not supported).
See the Disc and Archive-based Items section for the list of steps required to add a Neo Geo CD game in the Feed Editor.
Important
Both the iOS Safari and Xbox Series X|S Edge browsers limit the amount of memory that can be consumed by a particular web application (such as webЯcade).
The current limit is around 450 megabytes. Therefore, loading larger disc sizes may fail.
To increase the likelihood of a game with a larger disc size loading, you can optionally choose to launch the game using a standalone-based link (versus launching the game within the webЯcade player or editor). See the Standalone section of this documentation for further information (On Xbox, you would most likely want to bookmark the direct link. On iOS, you would most likely want to add the game to the home screen).
BIOS File
In addition to Neo Geo CD Disc images, one of the following BIOS files must be specified globally within the feed (See the Feed Properties Dialog and Neo Geo CD Feed Properties sections).
| File | Hash (MD5) | Description |
|---|---|---|
neocd_z.rom |
11526d58d4c524daef7d5d677dc6b004 | Recommended |
neocd_f.rom |
8834880c33164ccbe6476b559f3e37de | |
neocd_t.rom |
de3cf45d227ad44645b22aa83b49f450 | |
neocd_st.rom |
f6325a33c6d63ea4b9162a3fa8c32727 | |
front-sp1.bin |
5c2366f25ff92d71788468ca492ebeca | |
top-sp1.bin |
122aee210324c72e8a11116e6ef9c0d0 | |
neocd.bin |
f39572af7584cb5b3f70ae8cc848aba2 |
Controls
The emulator supports up to two controllers. The keyboard and gamepad mappings are listed in the tables below.
Keyboard
Keyboard controls are listed below.
| Name | Keys |
Comments |
|---|---|---|
| Move |     |
|
| Button A |  |
|
| Button B |  |
|
| Button C |  |
|
| Button D |  |
|
| Start |  |
|
| Select |  |
The Right Shift Key. |
| Show Pause Screen |  |
Gamepad
Gamepad mappings are listed below.
| Name | Gamepad |
Comments |
|---|---|---|
| Move |  or  |
|
| Button A |  |
|
| Button B |  |
|
| Button C |  |
|
| Button D |  |
|
| Start |  |
Not available for Xbox and not recommended for iOS (see alternate) Press the Menu (Start) Button. |
| Start (Alternate) |
 and  |
Hold down the Right Trigger and click (press down) on the Right Thumbstick. |
| Select |  |
Not available for Xbox and not recommended for iOS (see alternate) Press the View (Back) Button. |
| Select (Alternate) |
and  |
Hold down the Right Trigger and click (press down) on the Left Thumbstick. |
| Show Pause Screen |  and |
Not available for Xbox and not recommended for iOS (see alternate 3 or 4) Hold down the Left Trigger and press the Menu (Start) Button. |
| Show Pause Screen (Alternate) |
and |
Not available for Xbox and not recommended for iOS (see alternate 3 or 4) Hold down the Left Trigger and press the View (Back) Button. |
| Show Pause Screen (Alternate 2) |
and |
Not available for Xbox and not recommended for iOS (see alternate 3 or 4) Hold down the X Button and press the View (Back) Button. |
| Show Pause Screen (Alternate 3) |
and |
Hold down the Left Trigger and click (press down) on the Left Thumbstick. |
| Show Pause Screen (Alternate 4) |
and |
Hold down the Left Trigger and click (press down) on the Right Thumbstick. |
Internal Save Memory
The Neo Geo CD application supports persisting the console's internal save memory into the browser's local storage or optionally to cloud-based storage. The contents will be persisted to storage whenever the pause screen is displayed (or the game is exited). Therefore, the menu should be displayed periodically for games that support saving to memory to ensure the state is properly persisted.
Feed
This section details how Neo Geo CD application instances can be added to feeds.
Type
The type name for the Neo Geo CD application is retro-neocd.
Note
The alias neogeocd also currently maps to this application. In the future, the neogeocd alias may be mapped to another Neo Geo CD application (different emulator implementation) if it is determined to be a more appropriate default.
Feed Properties
The table below contains global Neo Geo CD feed properties. These properties must be specified in the props object of the feed's Feed Object.
| Property | Type | Required | Details |
|---|---|---|---|
| neogeocd_bios | URL | Yes | URL to a valid Neo Geo CD BIOS file. See the BIOS File section for additional information. |
Item Properties
The table below contains the properties that are specific to the Neo Geo CD application. These properties are specified in the props object of a feed item.
| Property | Type | Required | Details |
|---|---|---|---|
| uid | String | Yes | A unique identifier for the particular game (must be unique across all Neo Geo CD games). This identifier is primarily used to associate persistent state with the game. |
| discs | Array of URLs | Yes | Array of URLs to one or more (for multi-disc games) Neo Geo CD game discs. The Neo Geo CD application only supports the |
| skipCdLoading | Boolean | No | Whether to automatically fast forward CD loading sequences (enabled by default). |
| cdSpeedHack | Boolean | No | Modifies the CD-ROM BIOS to perform faster (enabled by default). |
| region | Numeric | No | Sets the region of the console. (defaults to "United States")
|
| zoomLevel | Numeric | No | A numeric value indicating how much the display image should be zoomed in (0-40). This property is typically used to hide the black borders that are present on some Neo Geo CD games. |
Example
The following is an example of a complete feed that consists of a single Neo Geo CD application instance (type value of neogeocd). The discs property value contains a URL that points to a Neo Geo CD game disc image. The uid property value contains a unique identifier for this specific game (must be unique across all Neo Geo CD games).
It is also worth noting that the Neo Geo CD BIOS location (neogeocd_bios) is specified globally within the Feed Object's props object.
{
"title": "Neo Geo CD",
"props": {
"neogeocd_bios": "https://<host>/neocd_z.rom"
},
"categories": [
{
"title": "Neo Geo CD Games",
"items": [
{
"title": "Some Game",
"type": "neogeocd",
"props": {
"uid": "cd945bde-c1b0-4fa5-9ad5-e05767b8e86e",
"discs": [
"https://<host>/somegame.chd"
]
}
}
]
}
]
}