https://github.com/dere3046/rogue_save_editor_unlocktool
A save editor for the game **Streets of Rogue** to read and modify `GameUnlocks.dat` files.
https://github.com/dere3046/rogue_save_editor_unlocktool
game mono saveeditor streetsofrogue unity unlocktool
Last synced: 11 days ago
JSON representation
A save editor for the game **Streets of Rogue** to read and modify `GameUnlocks.dat` files.
- Host: GitHub
- URL: https://github.com/dere3046/rogue_save_editor_unlocktool
- Owner: Dere3046
- License: mit
- Created: 2026-03-04T05:35:04.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-24T14:55:19.000Z (3 months ago)
- Last Synced: 2026-03-25T15:40:24.523Z (3 months ago)
- Topics: game, mono, saveeditor, streetsofrogue, unity, unlocktool
- Language: C#
- Homepage:
- Size: 32.8 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Rogue_Save_Editor_UnlockTool
A save editor for the game **Streets of Rogue** to read and modify `GameUnlocks.dat` files.
[中文版](./README_zh.md)
## Features
- Export binary save file to human-readable JSON format
- Repack modified JSON back to game-recognized binary format
- Create new save files from scratch
- Unlock all items/agents/traits with a single command
- Modify in-game statistics (nuggets, wins, deaths, etc.)
## Requirements
### Runtime Requirements
- **Operating System**: Windows 10 version 1607+ (x64) or Windows 11 (x64)
- **.NET Runtime**: Not required for standalone build (included in executable)
- **Game DLLs**: Required only for building (not for running standalone build)
### System Compatibility
| System | Supported |
|--------|-----------|
| Windows 11 | ✅ Yes |
| Windows 10 (1607+) | ✅ Yes |
| Windows 10 (1507-1605) | ❌ No |
| Windows 8.1 | ❌ No |
| Windows 7 | ❌ No |
> **Note**: The minimum Windows version is 1607 (build 10.0.14393.0) due to .NET 8.0 requirements.
## Build
### Prerequisites
- .NET 8.0 SDK
- Game DLL files in `win_x64/lib/`:
- `Assembly-CSharp.dll`
- `Assembly-CSharp-firstpass.dll`
### Build Commands
```bash
cd win_x64
# Debug build
dotnet build
# Release build
dotnet build -c Release
# Publish standalone executable (single .exe file)
dotnet publish -c Release -r win-x64 \
--self-contained true \
-p:PublishSingleFile=true \
-p:IncludeNativeLibrariesForSelfExtract=true \
-o publish_standalone
```
### Output
| Build Type | Command | Output | Size |
|------------|---------|--------|------|
| Debug | `dotnet build` | `bin/Debug/` | ~30 KB (requires .NET) |
| Release | `dotnet build -c Release` | `bin/Release/` | ~30 KB (requires .NET) |
| Standalone | `dotnet publish ...` | `publish_standalone/` | ~74 MB (no dependencies) |
## Usage
### Commands
```bash
# Show help
UnlockToolConsole.exe
# Load save and export to JSON
UnlockToolConsole.exe load GameUnlocks.dat > output.json
# Import JSON to create new save
UnlockToolConsole.exe import input.json GameUnlocks_new.dat
# Export save to JSON file
UnlockToolConsole.exe json GameUnlocks.dat output.json
# Create new empty save
UnlockToolConsole.exe create new.dat
# Unlock specific item
UnlockToolConsole.exe unlock GameUnlocks.dat RobotPlayer Agent
# Unlock everything
UnlockToolConsole.exe unlockall GameUnlocks.dat
# Lock specific item
UnlockToolConsole.exe lock GameUnlocks.dat RobotPlayer Agent
# Modify statistics
UnlockToolConsole.exe stats GameUnlocks.dat nuggets 99999
UnlockToolConsole.exe stats GameUnlocks.dat wins 100
# List unlocks (optionally filter by type)
UnlockToolConsole.exe list GameUnlocks.dat
UnlockToolConsole.exe list GameUnlocks.dat Agent
```
### Command Aliases
| Full Command | Alias |
|-------------|-------|
| `load` | `l`, `read` |
| `save` | `s`, `write` |
| `unlock` | `u` |
| `unlockall` | `ua`, `all` |
| `lock` | `lk` |
| `json` | `j`, `export` |
| `import` | `i` |
| `create` | `c`, `new` |
| `list` | - |
| `stats` | - |
### Unlock Types
- `Agent` - Characters (Cop, Guard, Thief, RobotPlayer, etc.)
- `Trait` - Traits (Strong, Fast, Tough, etc.)
- `Item` - Items (Pistol, Shotgun, Medkit, etc.)
- `Floor` - Floors (Floor2, Floor3, Floor4, Floor5)
- `Challenge` - Challenges (Sandbox, InfiniteAmmo, etc.)
- `Extra` - Extra unlocks/achievements
- `BigQuest` - Big Quests
- `Ability` - Abilities
- `Loadout` - Loadouts
### Examples
```bash
# Export save to JSON, edit, then import back
UnlockToolConsole.exe json GameUnlocks.dat save.json
# ... edit save.json ...
UnlockToolConsole.exe import save.json GameUnlocks_modified.dat
# Create a new save with all unlocks
UnlockToolConsole.exe create full.dat
UnlockToolConsole.exe unlockall full.dat
# Modify existing save to have 99999 nuggets
UnlockToolConsole.exe stats GameUnlocks.dat nuggets 99999
# Unlock a specific character
UnlockToolConsole.exe unlock GameUnlocks.dat Vampire Agent
# View all unlocked agents
UnlockToolConsole.exe list GameUnlocks.dat Agent
```
## Project Structure
```
Rogue_Save_Editor_UnlockTool/
├── win_x64/ # Source code
│ ├── Program.cs # Main entry point
│ ├── GameUnlocksUtility.cs # Save file utilities
│ ├── SaveDataDto.cs # DTO classes for JSON
│ ├── UnlockToolConsole.csproj # Project file
│ ├── lib/ # Game DLLs (required for build)
│ │ ├── Assembly-CSharp.dll
│ │ └── Assembly-CSharp-firstpass.dll
│ └── data/ # Sample save file
│ └── GameUnlocks.dat
├── README.md # This file
└── README_zh.md # Chinese documentation
```
## Disclaimer
This tool is provided for educational and research purposes only. Modifying game save files may lead to corruption or unexpected behavior. Always back up your original files before use. The author assumes no responsibility for any data loss or game issues.