||11 hours ago|
|.cargo||2 years ago|
|app||2 months ago|
|drsandroid||8 months ago|
|misc/json-schemas||7 months ago|
|res||6 months ago|
|src||11 hours ago|
|.appveyor.yml||2 months ago|
|.gitignore||1 year ago|
|Cargo.toml||2 months ago|
|LICENSE||7 months ago|
|README.md||2 months ago|
|build.rs||6 months ago|
|rustfmt.toml||2 years ago|
A fully playable re-implementation of Cave Story (Doukutsu Monogatari) engine written in Rust.
Get nightly builds from AppVeyor (recommended for now, has latest fixes and improvements)
Permalinks to latest builds from
macOS note: If you get a
"doukutsu-rs" can't be openedmessage, right-click doukutsu-rs.app and click open.
Get stable/beta builds from GitHub Releases (Includes Android builds)
In order to work doukutsu-rs needs to be paired with supported data files. This repository does not contain any data files.
Supported game editions and data file acquisition guides
doukutsu-rs works out of the box when it's placed in the same directory as the original Doukutsu.exe executable. On the initial
startup, doukutsu-rs will automatically extract the additional resources that are embedded in the vanilla game into the
directory. Until that is done, both doukutsu-rs and the vanilla executable have to exist in the directory.
doukutsu-rs can be used as drop-in replacement for
CaveStory+.exe. No modifications to game files are needed.
Original version (first released in 2011 on Steam) - expand for instructions
Steam release (Win/Mac/Linux)
data folder is in the same place across all platforms.
If you want to use doukutsu-rs as a substitute for Mac version of Cave Story+ (which at moment of writing doesn't work on 10.15+ anymore), do the following:
- Find the doukutsu-rs executable:
- In AppVeyor builds, it's in
- In your own builds, it's in
- In AppVeyor builds, it's in
- Open Steam Library, select
Cave Story+, press the
Managebutton (gear icon) and select
Local Filesand press
- Open the
Cave Story+.appbundle and navigate to
- Rename the
Cave Story+executable to something else or delete it.
- Copy the doukutsu-rs executable and rename it to
- Launch the game from Steam and enjoy!
The archive from Humble Bundle contains the necessary
data folder, in the same folder as
Remastered version (first released in 2017 on Switch)
Note that this version is incompatible with saves from the original version.
Interchanging the save files may result in spawning in wrong locations, softlocks, graphical glitches, or other issues.
data folder (contained in
romfs) from your console using tool such as nxdumptool.
- doukutsu-rs doesn't rely on the original ROM or executable, you just need the data files, go to
RomFS optionsmenu to just extract the files to SD card so you don't need to do any extra steps.
- Ensure you're dumping the files with update included (
Use update/DLCoption), as 1.0 isn't supported.
Same controls as the default for freeware and Cave Story+ keyboard.
To change, edit
doukutsu-rs\data\settings.json within your user directory.
Alt + Enter- Toggle Fullscreen
F2(While paused) - Quick Restart