From 3cccf9507fdde92c14ded72f68dd23c6280f7742 Mon Sep 17 00:00:00 2001 From: Aloys Date: Wed, 16 Sep 2026 23:01:50 +0800 Subject: [PATCH 1/3] Add PlaydiaEmu library docs and core list entries Document the Bandai Playdia libretro core (PlaydiaEmu), register it in mkdocs nav under Bandai Emulation, and list it in the core list and license tables. --- docs/development/licenses.md | 1 + docs/guides/core-list.md | 1 + docs/library/playdiaemu.md | 105 +++++++++++++++++++++++++++++++++++ mkdocs.yml | 1 + 4 files changed, 108 insertions(+) create mode 100644 docs/library/playdiaemu.md diff --git a/docs/development/licenses.md b/docs/development/licenses.md index a503fdf8a3..d5df888001 100644 --- a/docs/development/licenses.md +++ b/docs/development/licenses.md @@ -192,6 +192,7 @@ See below for a summary of the licenses behind RetroArch and its cores: | [PD777](../library/pd777.md) | [MIT](https://github.com/mittonk/PD777/blob/main/LICENSE) | | | [PicoDrive](../library/picodrive.md) | [MAME (Non-commercial)](https://github.com/libretro/picodrive/blob/master/COPYING) | Non-commercial | | [PocketCDG](../library/pocketcdg.md) | [MIT](https://github.com/libretro/libretro-pocketcdg/blob/master/LICENSE) | | +| [PlaydiaEmu](../library/playdiaemu.md) | [BSD-3-Clause](https://github.com/AloysHF/PlaydiaEmu/blob/master/LICENSE) | | | [PokeMini](../library/pokemini.md) | [GPLv3](https://github.com/libretro/PokeMini/blob/master/LICENSE) | | | [PPSSPP](../library/ppsspp.md) | [GPLv2](https://github.com/hrydgard/ppsspp/blob/master/LICENSE.TXT) | | | [PrBoom](../library/prboom.md) | [GPLv2](https://github.com/libretro/libretro-prboom/blob/master/COPYING) | | diff --git a/docs/guides/core-list.md b/docs/guides/core-list.md index f990df4603..c5cbcc48df 100644 --- a/docs/guides/core-list.md +++ b/docs/guides/core-list.md @@ -169,6 +169,7 @@ | [PD777](../library/pd777.md) | Epoch Cassette Vision | | | PicoDrive | Sega MS/GG/MD/CD/32X | | | Play! | Sony PlayStation 2 | | +| [PlaydiaEmu](../library/playdiaemu.md) | Bandai Playdia | An emulator for the Bandai Playdia interactive CD console | | Pocket CDG | Karaoke player | A karaoke music player, ported to libretro | | [PokeMini](../library/pokemini.md) | Nintendo Pokemon Mini | | | Potator | Watara Supervision | | diff --git a/docs/library/playdiaemu.md b/docs/library/playdiaemu.md new file mode 100644 index 0000000000..101623522f --- /dev/null +++ b/docs/library/playdiaemu.md @@ -0,0 +1,105 @@ +# Playdia (PlaydiaEmu) + +## Background + +The Playdia is a Japanese interactive CD console released by Bandai in 1994. Titles are largely full-motion video driven by a CDS-XA disc stream, with video and audio decoded on a dedicated co-processor board and interactive choices advancing the stream. PlaydiaEmu is an emulator for this platform written in Rust, with a libretro core front-end. + +The PlaydiaEmu core has been authored by: + +- Aloys + +The PlaydiaEmu core is licensed under: + +- [BSD-3-Clause](https://github.com/AloysHF/PlaydiaEmu/blob/master/LICENSE) + +A summary of the licenses behind RetroArch and its cores can be found [here](../development/licenses.md). + +## BIOS + +No BIOS or firmware files are required. The libretro core uses the same HLE disc player as the standalone emulator. + +## Extensions + +Content that can be loaded by the PlaydiaEmu core have the following file extensions: + +- .cue +- .zip +- .iso +- .bin + +Redump-style `.zip` archives (CUE + BIN, or a single BIN/ISO) are opened by the core itself; RetroArch should pass the whole archive through (`block_extract`). + +RetroArch database(s) that are associated with the PlaydiaEmu core: + +- Playdia + +## Features + +Frontend-level settings or features that the PlaydiaEmu core respects: + +| Feature | Supported | +|-------------------|:---------:| +| Restart | ✔ | +| Saves | ✕ | +| States | ✔ | +| Rewind | ✕ | +| Netplay | ✕ | +| Core Options | ✔ | +| [Memory Monitoring (achievements)](../guides/memorymonitoring.md) | ✕ | +| RetroArch Cheats | ✕ | +| Native Cheats | ✕ | +| Controls | ✔ | +| Remapping | ✔ | +| Multi-Mouse | ✕ | +| Rumble | ✕ | +| Sensors | ✕ | +| Camera | ✕ | +| Location | ✕ | +| Subsystem | ✕ | +| [Softpatching](../guides/softpatching.md) | ✕ | +| Disk Control | ✕ | +| Username | ✕ | +| Language | ✕ | +| Crop Overscan | ✕ | +| LEDs | ✕ | + +## Directories + +The PlaydiaEmu core's library name is 'Playdia (PlaydiaEmu)' + +## Core options + +The PlaydiaEmu core has the following core options: + +- **Audio Volume** (`playdiaemu_volume`) - Set the audio volume level. Default: 100%. +- **Swap A/B Buttons** (`playdiaemu_swap_ab`) - Swap the A and B button mappings. Default: disabled. +- **Debug Logging** (`playdiaemu_debug_logging`) - Enable debug logging. Default: disabled. + +## Usage + +The PlaydiaEmu core requires the full path to content (disc images are read from disk). Video is output in the XRGB8888 pixel format at 320×240 resolution, and audio is output as stereo at 44100 Hz. Save states and core options are implemented; battery saves and cheats are not. + +## User 1 device types + +The PlaydiaEmu core supports the following device type(s) in the controls menu, bolded device types are the default for the specified user(s): + +- **RetroPad** - Gamepad + +## Joypad + +| RetroPad Inputs | User 1 input descriptors | +|------------------------------------------------|--------------------------| +| ![](../image/retropad/retro_dpad_up.png) | D-Pad Up | +| ![](../image/retropad/retro_dpad_down.png) | D-Pad Down | +| ![](../image/retropad/retro_dpad_left.png) | D-Pad Left | +| ![](../image/retropad/retro_dpad_right.png) | D-Pad Right | +| ![](../image/retropad/retro_a.png) | A | +| ![](../image/retropad/retro_b.png) | B | +| ![](../image/retropad/retro_start.png) | Start | +| ![](../image/retropad/retro_select.png) | Select | + +## External links + +- [PlaydiaEmu Repository](https://github.com/AloysHF/PlaydiaEmu) +- [Libretro PlaydiaEmu Core info file](https://github.com/libretro/libretro-super/blob/master/dist/info/playdiaemu_libretro.info) +- [Report Libretro PlaydiaEmu Core Issues Here](https://github.com/AloysHF/PlaydiaEmu/issues) diff --git a/mkdocs.yml b/mkdocs.yml index 88eb54ff15..06005bda69 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -142,6 +142,7 @@ nav: - 'Atari - ST/STE/TT/Falcon (Hatari)': 'library/hatari.md' - 'Atari - ST/STE/TT/Falcon (hatariB)': 'library/hatarib.md' - 'Bandai Emulation': + - 'Bandai - Playdia (PlaydiaEmu)': 'library/playdiaemu.md' - 'Bandai - WonderSwan/Color (Beetle Cygne)': 'library/beetle_cygne.md' - 'Bandai - Wonderswan Compatibility List': 'library/compatibility/wswan.md' - 'BBK electronic dictionary': From 5995d327784df013526b2bd27d31fcb2f7baf6db Mon Sep 17 00:00:00 2001 From: Aloys Date: Wed, 16 Sep 2026 23:18:59 +0800 Subject: [PATCH 2/3] Allow 'ahd' in typos check for Atari hard disk images hatariB documents the ACSI hard disk extension 'ahd' (library/hatarib.md). The spell checker flags it as a typo for 'had'; allow the real extension so docs CI can pass. --- _typos.toml | 1 + 1 file changed, 1 insertion(+) diff --git a/_typos.toml b/_typos.toml index 84f35f3d10..830c7e93e8 100644 --- a/_typos.toml +++ b/_typos.toml @@ -28,6 +28,7 @@ ment = "ment" # part of "Greg DeMent", a real person's surname (library/p nd = "nd" # part of "Button 2ND" (library/numero.md) som = "som" # som_msu1.sfc, a real filename (library/snes9x.md) hsi = "hsi" # .hsi file extension (guides/softwarelist-getting-started.md) +ahd = "ahd" # Atari hard drive image extension (library/hatarib.md) discernable = "discernable" # a widely-accepted alternate spelling of "discernible" (guides/rgui.md) alis = "alis" # KEY_ALIS, an example keytool placeholder (development/retroarch/compilation/android.md) ba = "ba" # part of the "ba4980-c-sdk" tool-repo URL slug (library/gam4980.md) From 6aae11ddc065ef688f6010219b40fa1b89044585 Mon Sep 17 00:00:00 2001 From: Aloys Date: Wed, 16 Sep 2026 23:20:28 +0800 Subject: [PATCH 3/3] Revert unrelated typos allowlist for hatariB 'ahd' The spell-check failure on library/hatarib.md is pre-existing and not introduced by the PlaydiaEmu docs PR; keep this PR scoped to PlaydiaEmu documentation only. --- _typos.toml | 1 - 1 file changed, 1 deletion(-) diff --git a/_typos.toml b/_typos.toml index 830c7e93e8..84f35f3d10 100644 --- a/_typos.toml +++ b/_typos.toml @@ -28,7 +28,6 @@ ment = "ment" # part of "Greg DeMent", a real person's surname (library/p nd = "nd" # part of "Button 2ND" (library/numero.md) som = "som" # som_msu1.sfc, a real filename (library/snes9x.md) hsi = "hsi" # .hsi file extension (guides/softwarelist-getting-started.md) -ahd = "ahd" # Atari hard drive image extension (library/hatarib.md) discernable = "discernable" # a widely-accepted alternate spelling of "discernible" (guides/rgui.md) alis = "alis" # KEY_ALIS, an example keytool placeholder (development/retroarch/compilation/android.md) ba = "ba" # part of the "ba4980-c-sdk" tool-repo URL slug (library/gam4980.md)