A tool for dumping BPSR global-metadata.dat from memory dump files. Supports both existing dump files and automatic process memory dumping.

• Works with existing dump files - Extract metadata from .dmp files created via Task Manager or other tools
• Auto-detection - Automatically detects and uses BPSR.exe or BPSR_STEAM.exe when running
• Process dumping - Optional Windows process memory dump creation (requires debugging privileges)
• Smart file handling - Reuses existing dump files to avoid expensive re-dumping operations
• Flexible output - Customizable output file paths (defaults to ./global-metadata.dat)
• Verbose logging - Control logging detail with -v and -vv flags

• Python 3.9+ (v3.10+ or latest recommended)
• Windows (for process dumping features; existing dump files work on any platform)

The .DMP file will be generated in Windows temporary folder (a popup of "Go to file" prompt will be shown). Once generated, move the .DMP file to the same directory where dump_global_metadata.py exists for easier access.

Recommended: Create dump file when the game is logged-in.

The tool can automatically create a memory dump from a running process:

python dump_global_metadata.py --process BPSR.exe

Or let it auto-detect the process:

python dump_global_metadata.py

This will automatically find and dump BPSR.exe or BPSR_STEAM.exe if running.

Extract metadata from an existing dump file:

python dump_global_metadata.py <dumpfile> <output.dat>

Extract from existing dump file:

python dump_global_metadata.py BPSR.DMP global-metadata.dat

Auto-detect and dump running process:

python dump_global_metadata.py

Specify process explicitly:

python dump_global_metadata.py --process BPSR_STEAM.exe

Custom dump file location:

python dump_global_metadata.py --process BPSR.exe --dump-out ./my-dump.dmp

Delete dump file after extraction:

python dump_global_metadata.py --process BPSR.exe --delete-dump

Verbose logging:

python dump_global_metadata.py BPSR.DMP global-metadata.dat -v

All options:

python dump_global_metadata.py --process BPSR.exe --dump-out ./dump.dmp --delete-dump -vv

• dumpfile (optional) - Path to an existing .dmp file. If omitted, --process is required or auto-detection will be used.
• outfile (optional) - Output metadata path (default: ./global-metadata.dat)
• --process, -p - Process image name to dump (e.g. BPSR.exe). Requires Windows and debugging privileges.
• --dump-out, -d - Custom dump file path when using --process. Defaults to ./<process>.dmp.
• --delete-dump - Delete the dump file after successful extraction (default: keep it)
• -v, --verbose - Increase logging verbosity. Use -v for INFO level, -vv for DEBUG level.

• @dmlgzs - Analysis and information
• @rushkii - Original implementation
• @JordieB - Refactoring and additional features