Bjornabe.Vrb.Core 1.4.3.24759379

Bjornabe.Vrb.Core

A .NET library for serializing and deserializing Space Engineers 2 binary save files (.vrb) to and from JSON.

This library enables modders and tool developers to programmatically read, modify, and write SE2 save data with full compatibility with the game's binary format.

Prerequisites

• OS: Windows 10/11 (64-bit)
• Runtime: .NET 9.0
• Game: Space Engineers 2 installed via Steam (assemblies are loaded at runtime)

Game Version Compatibility

1.4.3.24759379 targets VS2.4 (assembly version 2.4.0.77, Steam build 24759379). The previous release, 1.4.2.24225481, targets VS2.3 – Drive, Automate & Detonate (2.3.0.2798, Steam build 24225481).

The fourth component of the package version is the Steam build id of the game the release was built and tested against. Because the library binds to the game's own assemblies at runtime, a Space Engineers 2 update can break conversion until a matching release ships.

VS2.4 required no code changes: every type and member the library reflects on still resolves unchanged, so 1.4.3 differs from 1.4.2 only in being re-tested against the newer build.

Installation

dotnet add package Bjornabe.Vrb.Core

Usage

using Vrb.Core;

// 1. Initialize (once at startup)
// Optionally pass a custom game path; otherwise it auto-discovers SE2 via Steam
Vrb.Initialize();

// 2. Convert VRB to JSON
var json = Vrb.Service!.DeserializeVrb("savegame.vrb", TargetType.SaveGame);

// 3. Convert JSON to VRB
Vrb.Service.SerializeJsonToVrb(json, "savegame_modified.vrb", TargetType.SaveGame);

Supported File Types

Custom Game Path

If the game is not installed via Steam or you need to specify a custom path:

Vrb.Initialize(@"C:\Games\SpaceEngineers2\Game2");

Compression Options

When writing VRB files, you can specify the compression method:

Vrb.Service.SerializeJsonToVrb(json, "output.vrb", TargetType.SaveGame, CompressionMethod.Brotli);

Available compression methods: None, ZLib, Brotli (default matches game behavior).

How It Works

The library uses Space Engineers 2's own serialization assemblies loaded at runtime, ensuring perfect compatibility with the game's binary format. This means:

• No reverse-engineered formats that could break with game updates
• Full support for all data types the game uses
• Lossless round-trip conversion (VRB → JSON → VRB)

JSON Output Format

The JSON output includes engine-compatible metadata:

{
  "$Bundles": {
    "Game2": "2.4.0.77",
    "VRage": "2.4.0.77"
  },
  "$Type": "VRage:Keen.VRage.Core.Game.Systems.EntityBundle",
  "$Value": {
    "Roots": 210,
    "Entities": [0, 1, 2],
    "Builders": [...]
  }
}

Additional Resources

• Full Documentation & CLI Tool
• Report Issues

Disclaimer

This is an unofficial community tool, not affiliated with or endorsed by Keen Software House. Always backup your save files before editing. Use at your own risk.