Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/whatisaphone/war
A viewer/editor for Darksiders saves, worlds, and scripts
https://github.com/whatisaphone/war
darksiders modding
Last synced: about 2 months ago
JSON representation
A viewer/editor for Darksiders saves, worlds, and scripts
- Host: GitHub
- URL: https://github.com/whatisaphone/war
- Owner: whatisaphone
- Created: 2019-09-26T17:43:19.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-06-14T16:13:26.000Z (over 1 year ago)
- Last Synced: 2024-10-31T12:13:02.432Z (about 2 months ago)
- Topics: darksiders, modding
- Language: Rust
- Homepage:
- Size: 229 MB
- Stars: 7
- Watchers: 6
- Forks: 2
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# 
war
[](https://gitlab.com/whatisaphone/war/commits/master)
A tool that lets you view/edit [Darksiders] save files and game assets.
[Darksiders]: https://en.wikipedia.org/wiki/Darksiders_(video_game)
>Darksiders Warfinitive Edition - All your save game are belong to us!
You can download the latest version from the [releases] page.
[releases]: https://github.com/whatisaphone/war/releases
## How to use
You have a couple options:
1. [View the worlds/scripts online][browse]. Nothing to download, nothing to install.
[browse]: https://github.com/whatisaphone/war/tree/browse/browse
2. Run `war --help` for the full list of options.
3. Continue reading below for the guided tour.
- [Save editing](#save-editing)
- [Asset extracting](#asset-extracting)
### Save editing
Which edition of the game do you have?
OG
Your saves should be in a path that looks something like this:
C:\Users\\Documents\My Games\Darksiders\\dsauto.dsav
- Run `war dsav decode ` to decode a save from `.dsav` to `.json`.
- The newly-created `.json` will have an unpacked version of your save. You can edit this file.
- Run `war dsav encode ` to encode back to `.dsav`.
- To use the new save, just quit to the main menu and choose "Load Game".
Warmastered
Your saves should be in a path that looks something like this:
C:\Program Files (x86)\Steam\userdata\\462780\remote\autocloud\save\keen_savegame_0_0.sav
The file contains all 10 save slots (including the autosave slot), but this tool only reads/writes the autosave slot.
- Run `war sav decode ` to decode the autosave to `.json`.
- The newly-created `.json` will have an unpacked version of your save. You can edit this file.
- Run `war sav encode ` to write back to the `.sav`. The autosave slot will be overwritten, and the other save slots will be left alone.
- If the game is running, you'll need to exit and restart for it to read the new data. Unfortunately, this edition only reads the save file once when the game first loads.
⚠ **NOTE** (both editions): Darksiders will refuse to load a save if the `SaveGameInfo`'s `UserId` does not match the logged-in Steam user's ID. If you want to use a save on a different account than created it, the `UserId` property must be changed to match.
### Asset extracting
This app can extract the game's various assets to a readable format. It cannot re-pack them into the original format. These command work just as well on files from both OG and Warmastered.
#### Manifest
Most of the game's assets (meshes, textures, audio, etc.) are stored in resource packages (`*.oppc`) which are referenced by the manifest (`media/pc.mnfst`).
To extract these, point the tool at your game directory (either `Darksiders` or `Darksiders Warmastered Edition`).
```sh
war manifest packages unpack
```
The unpacked files will take up about 17GB (for the Warmastered Edition).
#### Worlds
The game's worlds are stored in `/path/to/Darksiders/media/worlds.mnfst`. To extract them, run:
```sh
war worlds decode
```
See the [browse] readme for more info on what exactly these files are.
#### VisScript
The Darksiders devs used a visual editor for some scripts. You can render them to Graphviz files using:
```sh
war worlds visscript draw
```
Take a look at the [browse] branch to see the final results.
#### Scripts
The game's scripts are stored in `/path/to/Darksiders/media/scripts.obsp`. To extract them, run:
```sh
war obsp decode
```
Congratulations, you did it! Now you have several thousand more files on your hard drive. 🎉
## Development
### Install prerequisites
- [Rust]
- [pre-commit]
[Rust]: https://www.rust-lang.org/
[pre-commit]: https://pre-commit.com/
### Install the pre-commit hook
```sh
pre-commit install
```
This installs a Git hook that runs a quick sanity check before every commit.
### Run the app
```sh
cargo run
```
### Run the tests
```sh
cargo test
```