Bjornabe.Vrbe.Core 1.4.2.24225481

Bjornabe.Vrbe.Core

A save file editor library for Space Engineers 2 that allows you to inspect, query, and modify save data programmatically.

Quick Start

using Vrbe.Core;

// Initialize (once at startup)
Vrbe.Initialize();

// Load a save
var save = SaveFile.Load(@"C:\Users\You\AppData\Roaming\SpaceEngineers2\AppData\SaveGames\MySave");

// Find and modify the GameMode component
var gameMode = save.FindComponent("GameModeSessionComponent");
gameMode.SetValue("CreativeGlobal", true);

// Save to a new file
save.Save(@"C:\...\MySave\sessioncomponents-modded.vrb");

Features

• Load Save Files - Open save folders or individual .vrb files
• Query Components - Find components by name, predicate, or search term
• JSONPath Support - Query and modify nested data with powerful JSONPath expressions
• Read Values - Type-safe value access with GetValue<T>() and TryGetValue<T>()
• Modify Data - Change any property with SetValue() or bulk modify with SetAll()
• Save Changes - Write back to valid .vrb files

API Overview

// Loading
var save = SaveFile.Load(path);
SaveFile.TryLoad(path, out var save, out var error);

// Querying
var component = save.FindComponent("GameModeSessionComponent");
var components = save.FindComponents(c => c.HasData);
var results = save.Query("CreativeGlobal");

// Reading
bool value = component.GetValue<bool>("CreativeGlobal");
component.TryGetValue<int>("SomeInt", out var intValue);
string json = component.ToJson();

// Modifying
component.SetValue("CreativeGlobal", true);

// Saving
save.Save("output.vrb");

JSONPath Support

Query and modify deeply nested data using JSONPath expressions:

var perPlayer = save.FindComponent("PerPlayerDataSessionComponent");

// Select all GPS marker names
foreach (var name in perPlayer.Select("$..GPSMarkers[*].Name"))
{
    Console.WriteLine(name);
}

// Count hidden markers
int hiddenCount = perPlayer.Count("$..GPSMarkers[?(@.Hidden==true)]");

// Unhide all markers at once
int modified = perPlayer.SetAll("$..GPSMarkers[*].Hidden", false);
Console.WriteLine($"Unhid {modified} markers");

JSONPath Syntax

Reference: RFC 9535 - JSONPath

Requirements

• Windows 10/11 (64-bit)
• .NET 9.0
• Space Engineers 2 installed (via Steam)

Dependencies

• Bjornabe.Vrb.Core - VRB serialization library
• JsonPath.Net - JSONPath query support (RFC 9535)

Documentation

Full documentation: GitHub Repository

License

MIT License - See repository for details.

Disclaimer

This is an unofficial community tool. Always backup your save files before editing.