This article needs some TLC. Read at your own risk.

Cave Story

The original Cave Story (a.k.a. Doukutsu Monogatari) was developed by Daisuke “Pixel” Amaya and was released in 2004.

This system scrapes metadata for the “cavestory” group and loads the cavestory set from the currently selected theme, if available.

Grouped with the “ports” group of systems.

No Cave Story emulator in Batocera needs a BIOS file to run.

Place your Cave Story game files in /userdata/roms/cavestory.

Download the game from the following URL and uncompress it in this folder:

It is recommended to use the English version. Other versions may freeze the system.

RetroArch (formerly SSNES), is a ubiquitous frontend that can run multiple “cores”, which are essentially the emulators themselves. The most common cores use the libretro API, so that's why cores run in RetroArch in Batocera are referred to as “libretro: (core name)”. RetroArch aims to unify the feature set of all libretro cores and offer a universal, familiar interface independent of platform.

RetroArch configuration

RetroArch offers a Quick Menu accessed by pressing [HOTKEY] + South button (B SNES) which can be used to alter various things like RetroArch and core options, and controller mapping. Most RetroArch related settings can be altered from Batocera's EmulationStation.

Standardized features available to all libretro cores: cavestory.videomode, cavestory.ratio, cavestory.smooth, cavestory.shaders, cavestory.pixel_perfect, cavestory.decoration, cavestory.game_translation

ES setting name batocera.conf_key Description ⇒ ES option key_value
Settings that apply to all cores of this emulator
GRAPHICS API cavestory.gfxbackend Choose which graphics API library to use. Vulkan is better, when supported.
⇒ OpenGL opengl, Vulkan vulkan.
AUDIO LATENCY cavestory.audio_latency In milliseconds. Can reduce crackling/cutting out.
⇒ 256 256, 192 192, 128 128, 64 64, 32 32, 16 16, 8 8.
THREADED VIDEO cavestory.video_threaded Improves performance at the cost of latency and more video stuttering.
⇒ On true, Off false.

libretro: nxengine

libretro: nxengine configuration

Here are the default Cave Story's controls shown on a Batocera Retropad:

For further troubleshooting, refer to the generic support pages.

  • systems/cavestory.txt
  • Last modified: 16 months ago
  • by atari