mirror of
https://github.com/doukutsu-rs/doukutsu-rs
synced 2024-11-17 19:32:43 +00:00
95 lines
4 KiB
Markdown
95 lines
4 KiB
Markdown
# doukutsu-rs
|
|
|
|
A re-implementation of Cave Story (Doukutsu Monogatari) engine written in [Rust](https://www.rust-lang.org/), aiming for behavior accuracy and cleaner code.
|
|
Later plans might involve turning it into a fully-featured modding tool with live debugging and stuff.
|
|
|
|
**The project is still in a very early state and nowhere near being playable. Expect lots of breaking changes and bugs**
|
|
|
|
[Join the Discord server](https://discord.gg/fbRsNNB)
|
|
|
|
#### Data files
|
|
|
|
doukutsu-rs project does not re-distribute any copyrighted files.
|
|
|
|
The engine should work fine with [CSE2-Enhanced](https://github.com/Clownacy/CSE2) or [NXEngine(-evo)](https://github.com/nxengine/nxengine-evo) modified freeware data files and [Cave Story+](https://www.nicalis.com/games/cavestory+) (Nicalis commercial release, loading is supported but note we're not going to reverse engineer it or support it's features) data files.
|
|
|
|
Vanilla Cave Story does not work yet because some important data files are embedded inside executable and we don't have an extractor yet.
|
|
|
|
##### Where to get them?
|
|
|
|
**Freeware**
|
|
|
|
- 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 - Copy `data` folder from installation directory ([guide for Steam](https://steamcommunity.com/sharedfiles/filedetails/?id=760447682)) to the runtime directory.
|
|
- Switch release - While some support is implemented, hacking consoles and extracting cartridge content is a kind of gray legal area so I will leave it to you...
|
|
|
|
#### Roadmap
|
|
|
|
- [ ] Rendering
|
|
- [x] Backdrops
|
|
- [x] Tilemap
|
|
- [x] Player and it's animations
|
|
- [x] Carets
|
|
- [ ] Bullets
|
|
- [x] NPCs
|
|
- [x] Text
|
|
- [ ] HUD
|
|
- [ ] Text scripts (TSC)
|
|
- [x] Initial implementation
|
|
- [x] Execution of basic subset of opcodes and game conversations
|
|
- [ ] Full implementation of opcodes
|
|
- [ ] Shift-JIS encoding support
|
|
- [ ] Audio
|
|
- [x] Organya BGM playback
|
|
- [x] Text script bindings
|
|
- [ ] CS+ style .ogg BGM playback
|
|
- [ ] PixTone SFX
|
|
- [ ] NPCs/entities
|
|
- [x] Initial implementation
|
|
- [ ] Miscellaneous entities
|
|
- [ ] First Cave
|
|
- [ ] Mimiga Village
|
|
- [ ] Egg Corridor
|
|
- [ ] Weapons
|
|
- [ ] Initial implementation
|
|
- [ ] Polar Star
|
|
- [ ] Modding enhancements and built-in tools
|
|
- [x] Debugger
|
|
- [ ] Level editor
|
|
- [ ] Texture auto-reload mode for spriters
|
|
- [ ] Optional enhanced graphics effects
|
|
|
|
*(tbd)*
|
|
|
|
#### Mandatory screenshots
|
|
|
|
**Freeware data files:**
|
|
|
|
|
|
|
|
**Cave Story+ data files:**
|
|
|
|
|
|
|
|
#### why rust, it's a hipster language lol
|
|
|
|
The project is a result of me wanting to build something in a new programming language for memes.
|
|
|
|
I had an idea of writing my own CS engine long time before and I would've very likely picked C++17/20 and SDL2, but after
|
|
all I've picked Rust instead because it seemed quite interesting for me.
|
|
|
|
Would 90% of end-users running this thing care about the programming language software was written in? After all who tf cares if the performance is the same (and maybe a slightly better), but you also get a lot of various benefits?
|
|
|
|
#### Credits
|
|
|
|
- Studio Pixel for Cave Story
|
|
- [Cave Story Tribute Site](https://cavestory.org) - for LOTS of useful resources related to the game.
|
|
- [Clownacy for CSE2](https://github.com/Clownacy/CSE2) - some game logic reference / mutual help in reverse engineering bitfields and other shit.
|
|
- [CSMC](https://discord.gg/xRsWpz6) - a helpful Cave Story modding community
|
|
- [LunarLambda](https://gitdab.com/LunarLambda/organism) - for reimplementing Organya in Rust, which is used by us as `.org` playback engine.
|
|
- [NXEngine](https://github.com/nxengine/nxengine-evo) - an another OSS rewrite of Cave Story engine I took some inspiration from.
|