Library for reading save files from Dolls Nest
Find a file
2025-03-02 18:22:43 -05:00
paramacro Begin documenting properties, move them to the top-level module 2025-03-02 17:16:11 -05:00
src Remove leftover and unused binrw debug printing 2025-03-02 18:22:43 -05:00
tests Reorganize the entire project 2025-03-02 17:03:20 -05:00
.gitignore Add initial files 2025-02-19 19:34:13 -05:00
Cargo.lock Start adding GUI 2025-03-02 18:16:43 -05:00
Cargo.toml Start adding GUI 2025-03-02 18:16:43 -05:00
LICENSE Add initial files 2025-02-19 19:34:13 -05:00
README.md Update progress of the parser in the README 2025-02-25 19:56:38 -05:00

Ireko

Library for reading save files from Dolls Nest. Only the demo is supported because that's what is available at the time of writing.

The parser is almost now complete (save for a few structs like DateTime), and write support is in progress.

Usage

Pass the .sav file you want to read as an argument. Not all .sav files are known to work, such as Level.sav and Player.sav.

$ ireko DollsNestDemo/Saved/SaveGames/AR0XJGFWA6HNIQ1AAUJ9UR828/Persistent.sav
Ok(
    TaggedSerialization {
        size_in_bytes: 135908,
        objs: [
            TaggedObject {
                size_in_bytes: 135904,
                entries: [
                    Entry {
                        name: "SavedDataVersion",
                        type: Some(
                            Int(
                                IntProperty {
                                    integer_size: 4,
                                    value: 0,
                                },
                            ),
                        ),
                    },
...

Technical Details

Dolls Nest uses the EasyMultiSave plugin, which saves using the .sav file extension. The save data is zlib-compressed, and decompressing them reveals a very similar tagged structure to GVAS. See more information in this blog post.

Credits & Thank You

  • uesave-rs for figuring out the basics of the EasyMultiSave format.

License

GPLv3

This project is licensed under the GNU General Public License 3.