Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Vampire Survivors Save Editor

A local, schema-free editor for Vampire Survivors SaveData.

Instead of hard-coding a small list of known values, the editor recursively reads the JSON save structure. That means new fields added by future game updates will appear automatically.

Unofficial community tool. Not affiliated with poncle or Vampire Survivors.

Features

  • Edit every JSON value in the save:
    • objects
    • arrays
    • strings
    • integers
    • decimal numbers
    • booleans
    • null values
  • Search keys, values, types, and JSON paths.
  • Replace an entire nested object or array as JSON.
  • Add keys to objects.
  • Append items to arrays.
  • Rename object keys.
  • Delete values or complete nested sections.
  • Full raw JSON editor for advanced users.
  • Automatic timestamped backup before overwriting a save.
  • Automatic SHA-256 checksum regeneration.
  • Verifies the exact file checksum after writing.
  • Rejects duplicate JSON keys instead of silently losing data.
  • No network access and no save uploads.
  • Standard-library Python only at runtime.

The checksum field is generated data. The program displays it, but regenerates it automatically whenever the file is saved.

Steam save location

A common Windows Steam location is:

<Steam folder>\userdata\<Steam user ID>\1794680\remote\SaveData

Close Vampire Survivors before editing. Steam Cloud can potentially restore a different copy of a local save.

Running from source

Python 3.10+:

py save_editor.py

No runtime packages are required.

Run tests

py -m unittest discover -s tests -v

Build a Windows EXE

Install PyInstaller:

py -m pip install --upgrade pyinstaller

Build:

py -m PyInstaller --onefile --windowed --name VampireSurvivorsSaveEditor ^
  --icon assets\app_icon.ico ^
  --add-data "assets\app_icon.ico;assets" ^
  --add-data "assets\app_icon.png;assets" save_editor.py

Your standalone executable will be created at:

dist\VampireSurvivorsSaveEditor.exe

How editing works

Tree Editor

The Tree Editor recursively displays the entire save. Double-click a node to replace its value with any valid JSON value.

Examples:

123
4.5
true
"some text"
["one", 2, false]
{"SomeSetting": true, "Amount": 500}

Raw JSON

The Raw JSON tab gives access to the complete save object. Changes are validated before they can be applied.

When the file is saved, the editor serializes the JSON in a consistent format and regenerates the checksum.

Backups

Before overwriting an existing file, the editor creates a timestamped backup beside it:

SaveData.backup-20260912-143500

To restore it:

  1. Close Vampire Survivors.
  2. Move/rename the edited SaveData.
  3. Rename the desired backup to exactly SaveData.

Checksum

The current save has a root checksum field.

When saving, the editor:

  1. sets checksum to an empty string;
  2. serializes the complete save;
  3. hashes those exact UTF-8 bytes with SHA-256;
  4. stores the digest in checksum;
  5. writes the file;
  6. reads it back and verifies the checksum.

Existing saves are validated against their exact raw text rather than being reserialized first.

GitHub Releases

For normal users, publish the compiled Windows executable under Releases so they do not need Python installed.

Suggested release asset:

VampireSurvivorsSaveEditor.exe

License

MIT.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages