SaveState.Runtime
0.1.0
dotnet add package SaveState.Runtime --version 0.1.0
NuGet\Install-Package SaveState.Runtime -Version 0.1.0
<PackageReference Include="SaveState.Runtime" Version="0.1.0" />
<PackageVersion Include="SaveState.Runtime" Version="0.1.0" />
<PackageReference Include="SaveState.Runtime" />
paket add SaveState.Runtime --version 0.1.0
#r "nuget: SaveState.Runtime, 0.1.0"
#:package SaveState.Runtime@0.1.0
#addin nuget:?package=SaveState.Runtime&version=0.1.0
#tool nuget:?package=SaveState.Runtime&version=0.1.0
SaveState.Runtime
The load/write runtime of SaveState.
dotnet add package SaveState.Runtime
What is in it
SaveFileSession<TFile>- the reader/writer of one file:Load(),Save(),EnsureCreated(),Exists(),Delete(), andSerializeSnapshot()/WriteSnapshot(json)for hosts that want to move only the disk write off the game thread.Load()returns aLoadResult(Missing/Loaded/Repaired/Failed).- Stores:
FileSystemStore(atomic write, file-name validation) andInMemoryStore(tests). SaveJson- the JSON policy (explicitnulls and defaults, so "missing key" can only mean an old file).SaveGate- "may this process write saves right now?" (keep editors, tools and tests off real save files).- Migrations:
ISaveMigration,FieldMigration(old field → new field + conversion) andJsonUpgrade.
using SaveState;
var session = new SaveFileSession<ProfileSaveFile>(
new FileSystemStore(saveDirectory),
new SaveRegistry().Add(playerProfile),
logger);
session.EnsureCreated(); // first launch: write a complete default file
LoadResult result = session.Load(); // Missing | Loaded | Repaired | Failed
playerProfile.State.Coins += 50;
session.Save();
A missing section is repaired (a default instance is written into the file on the next save, and your state is
never set to null), and a file that cannot be parsed is never overwritten - that is the point of the four
status values.
Documentation
MIT licensed.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- SaveState.Shared (>= 0.1.0)
- System.Text.Json (>= 8.0.5)
-
net10.0
- SaveState.Shared (>= 0.1.0)
NuGet packages (3)
Showing the top 3 NuGet packages that depend on SaveState.Runtime:
| Package | Downloads |
|---|---|
|
SaveState.Godot
Godot 4 adapter for SaveState: user:// save store, Godot output logger, and a runtime-process gate for auto-saving. |
|
|
SaveState.DependencyInjection
Microsoft.Extensions.DependencyInjection integration for SaveState. |
|
|
SaveState.Policy
Project-agnostic state + save/load framework: incremental source generator for strongly typed save files, with lenient loading (missing sections are repaired, never null) and explicit write points. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.1.0 | 182 | 9/29/2026 |
| 0.1.0-alpha.1 | 68 | 9/29/2026 |