Skip to content

README.md

Latest commit

 

History

History
86 lines (55 loc) · 2.5 KB

README.md

File metadata and controls

86 lines (55 loc) · 2.5 KB

Blazblue Entropy Effect Save Editor

This is a save editor for the amazing ACT game Blazblue Entropy Effect.

I noticed that there's another repository for save editing of this game on GitHub, but it seems struggling with the protobuf format. After I decided to give it a try, luckily it turns out that the protobuf definition is right in the game's JS land. So here's this save editor.

Install

Instead of using a fixed version of node-lz4 libarary, the current repo using the lz4.dll directly copied from the game to ensure consistency. This means you have to run this tool on Windows.

I also include a package.json file for more flexible usage of this repo.

npm install

Config

Edit config.js:

  • saveRoot: real save directory
  • outputDir: unpack output directory

Current default save root is:

%USERPROFILE%\AppData\LocalLow\91Act\BlazblueEntropyEffect\Steam\%STEAM_USER_ID%\Save

Set %STEAM_USER_ID% yourself before running the commands. Either by dirrectly modify config file or inject STEAM_USER_ID env param.

Commands

Unpack slot n:

npm run unpack -- n

This reads <saveRoot>\\n and writes:

  • <outputDir>/save.slot<n>.json

Pack slot n:

npm run pack -- n

This reads:

  • <outputDir>/save.slot<n>.json

And overwrites:

  • <saveRoot>/n

Caution

Any risk from writing back to the real save is the user's responsibility.

Test slot n:

npm run test -- n

This performs:

  1. unpack real save n
  2. repack from a test-only temporary JSON
  3. compare original save binary and repacked binary
  4. compare decoded DataSave bytes
  5. compare roundtrip JSON

The command exits with code 0 only when the repacked binary is identical to the original save.

Notes

  • main.js is now a CLI entrypoint, not an auto-run script with hardcoded one-off paths.
  • The project no longer depends on node-lz4 for save compression or decompression.
  • Updated pbdef.js and model files are already included in the repository state used by the CLI.

Disclaimer

Caution

Code here is mainly from the game (with some modifications to make it work without puerts). I don't own any of this code and copyright all belongs to the game' developer. Also, I'm not responsible for any damage caused by using this repository. It's for fair use only.