1
0
Fork 0
mirror of https://github.com/doukutsu-rs/doukutsu-rs synced 2024-11-18 03:32:44 +00:00
doukutsu-rs/README.md
2021-03-23 15:25:40 +01:00

56 lines
3 KiB
Markdown

# doukutsu-rs
![Release](https://github.com/doukutsu-rs/doukutsu-rs/workflows/Release/badge.svg)
[Download latest Nightly builds](https://github.com/doukutsu-rs/doukutsu-rs/actions) (Requires being logged in to GitHub)
A re-implementation of Cave Story (Doukutsu Monogatari) engine written in [Rust](https://www.rust-lang.org/).
**The project is still incomplete and not fully playable yet.** [Click here to see the current status of the project](https://github.com/doukutsu-rs/doukutsu-rs/issues/10).
[Join the Discord server](https://discord.gg/fbRsNNB)
#### Data files
This repository does not contain any copyrighted files.
For better user experience, pre-built binaries are distributed with slightly modified freeware game files.
*doukutsu-rs* should work fine with pre-extracted and tweaked data files from [this repository](https://github.com/doukutsu-rs/game-data), [NXEngine(-evo)](https://github.com/nxengine/nxengine-evo) extracted freeware data files and [Cave Story+](https://www.nicalis.com/games/cavestory+) data files.
Vanilla Cave Story does not work yet because some important data files have been embedded inside the executable. and we don't have a loader/extractor implemented yet.
##### Where to get them?
**Freeware**
- https://github.com/doukutsu-rs/game-data - Freeware game data distributed with CI builds, based on those two below.
- ~~https://github.com/Clownacy/CSE2/archive/enhanced.zip - copy `game_english/data` from archive to the runtime directory (place you run the executable from, usually project root)~~
- https://github.com/nxengine/nxengine-evo/releases/download/v2.6.4/NXEngine-v2.6.4-Win32.zip - copy `NXEngine-evo-2.6.4-xxx/data` from the archive to runtime directory
**Cave Story+**
- PC release (Steam) - (Tested only with Steam version, both Windows and Linux builds) Copy `data` folder from installation directory ([guide for Steam](https://steamcommunity.com/sharedfiles/filedetails/?id=760447682)) to the runtime directory.
- PC release (EGS) - (Untested, but the game is essentially the same as Steam release) Same thing as with Steam version.
- Switch release - (Tested once, no guarantee to work) You need a hacked Switch and physical release. Google should help you.
#### Mandatory screenshots
**Freeware data files:**
![Japanese Freeware](https://i.imgur.com/eZ0V5rK.png)
**Cave Story+ data files:**
![CS+ with enhanced graphics](https://i.imgur.com/YaPAs70.png)
#### Credits
- Studio Pixel/Nicalis for Cave Story
- [ggez](https://github.com/ggez/ggez) - we took few bits from it while moving away to SDL2.
- [@ClayHanson_](https://twitter.com/ClayHanson_) - for letting us use his .pxchar skin format from Cave Story Multiplayer mod.
- [Cave Story Tribute Site](https://cavestory.org) - has lots of useful resources related to the game.
- [CSE2](https://github.com/Clownacy/CSE2) - widescreen fixes, mutual help in various things.
- [LunarLambda for organism](https://gitdab.com/LunarLambda/organism) - which is being used by us as `.org` playback engine.
- [@uselesscalcium](https://twitter.com/uselesscalcium) - Android port icon artwork