doukutsu-rs

doukutsu-rs is a fully playable re-implementation of the Cave Story (Doukutsu Monogatari) engine, written in Rust. This project recreates the beloved classic, allowing players to experience it with the added benefits of modern development practices and cross-platform support.

doukutsu-rs doukutsu-rs

Key Features

Complete Engine Re-Implementation

doukutsu-rs offers a full re-implementation of the original Cave Story engine, enabling fans of the game to enjoy a faithful recreation with enhanced performance and compatibility.

Cross-Platform Builds

The project supports multiple platforms, including Windows (64-bit and 32-bit), macOS (Intel and Apple M1), Linux (64-bit), and Android (armv7/arm64/x86). This ensures that players can experience Cave Story on their preferred device.

Modern Rust Codebase

Built with Rust, doukutsu-rs leverages the language's safety and performance features to provide a robust and reliable game engine. The codebase is designed to be idiomatic and maintainable, welcoming contributions from the Rust community.

Installation and Downloads

For the latest builds, it is recommended to use the nightly versions, which include the latest fixes and improvements. Download the appropriate build for your platform from the links below:

Stable and beta builds are also available on the GitHub Releases page.

Data Files

To run doukutsu-rs, you need to pair it with supported data files. The repository does not include these files due to licensing restrictions. doukutsu-rs works well with freeware data files, NXEngine(-evo), or data from a supported copy of Cave Story+.

Setting Up Data Files on Android

  1. Launch the Files app.
  2. Navigate to doukutsu-rs game data.
  3. Copy your game data files to the folder.

Alternatively, you can use the Material Files app to set up the data files on your Android device.

Supported Game Editions

doukutsu-rs supports various editions of the game, including the original freeware version and Cave Story+. For detailed setup instructions for different versions, refer to the documentation in the repository.

Controls

The controls for doukutsu-rs are similar to those in the original Cave Story and Cave Story+:

P1P2
Movement← ↑ ↓ →, L . /
JumpZB
ShootXN
Cycle WeaponA and SG and H
Inventory / Skip cutsceneQT
MapWY
StrafeLShiftRShift

Additional controls include:

  • Alt + Enter: Toggle Fullscreen
  • F2 (While paused): Quick Restart

Community and Contributions

Join the Discord server to connect with the doukutsu-rs community. Contributions to the project are welcome, and detailed instructions for building and contributing can be found in the repository.


doukutsu-rs brings the magic of Cave Story to modern systems with the power of Rust. Whether you're a longtime fan or a new player, this project offers a compelling way to experience the classic game.

Similar Projects