Skip to content

PC Engine CD (TurboGrafx-CD)

Overview

The PC Engine CD (TurboGrafx-CD) application is an emulator for the CD-ROM accessory for the PC Engine.

Adding Games (Feed Editor)

Due to large Disc image sizes, adding PC Engine CD-based games in the Feed Editor must be done manually (versus using auto-detection).

Important

The PC Engine 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 PC Engine 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 PC Engine CD Disc images, the following BIOS file must be specified globally within the feed (See the Feed Properties Dialog and PC Engine CD Feed Properties sections).

File Hash (MD5)
syscard3.pce '38179df8f4ac870017db21ebcbf53114'

Controls

The emulator supports up to four controllers. The keyboard and gamepad mappings are listed in the tables below.

Keyboard

Keyboard support is only available for controller one.

Name
Keys
Comments
Move
I or A Key only available in 2-button mode.
II or S Key only available in 2-button mode.
III Only in 6-button mode.
IV Only in 6-button mode.
V Only in 6-button mode.
VI Only in 6-button mode.
Run
Select The Right Shift Key.
Show Pause Screen

Gamepad

Gamepad support is available for both controllers.

Name
Gamepad
Comments
Move  or 
I or X Button only available in 2-button mode.
II or Y Button only available in 2-button mode.
III Only in 6-button mode.
IV Only in 6-button mode.
V Only in 6-button mode.
VI Only in 6-button mode.
Run Not available for Xbox and not recommended for iOS (see alternate)

Press the Menu (Start) Button.
Run
(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 PC Engine CD application supports persisting the CD accessory'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 PC Engine CD application instances can be added to feeds.

Type

The type name for the PC Engine CD application is retro-pce-fast.

Note

The alias pcecd also currently maps to this application. In the future, the pcecd alias may be mapped to another PC Engine CD application (different emulator implementation) if it is determined to be a more appropriate default.

Feed Properties

The table below contains global PC Engine CD feed properties. These properties must be specified in the props object of the feed's Feed Object.

Property Type Required Details
pcecd_bios URL Yes

URL to a valid PCE CD BIOS file.

See the BIOS File section for additional information.

Item Properties

The table below contains the properties that are specific to the PC Engine 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 PC Engine 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) PC Engine CD game discs.

The PC Engine CD application only supports the .CHD disc file format (.ISO, .BIN, and .CUE are not supported).

pad6button Boolean No Whether to use 6-button control pads (2 button is the default).
mapRunSelect Boolean No Whether to map RUN and SELECT to standard buttons.
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 PC Engine CD games.

Example

The following is an example of a complete feed that consists of a single PC Engine CD application instance (type value of pcecd). The discs property value contains a URL that points to a PC Engine CD game disc image. The uid property value contains a unique identifier for this specific game (must be unique across all PC Engine CD games).

It is also worth noting that the PC Engine CD BIOS location (pcecd_bios) is specified globally within the Feed Object's props object.

{
  "title": "PC Engine CD",
  "props": {
    "pcecd_bios": "https://<host>/syscard3.pce"
  },
  "categories": [
    {
      "title": "PC Engine CD Games",
      "items": [
        {
          "title": "Some Game",
          "type": "pcecd",
          "props": {
            "uid": "7e636438-6520-4673-81ed-36835faccb2f",
            "discs": [
                "https://<host>/somegame.chd"
            ]
          }
        }
      ]
    }
  ]
}

References

Back to top