The planner ingests live factory state directly from your Satisfactory .sav file. Parsing happens in-process via a forked copy of SatisfactorySaveNet; the parsed actor graph is then projected into game-agnostic ERP.Domain entities by Satisfactory.Save.

The fork is the source of truth until upstream catches up; see ADR-0014.

GitHub Packages auth always requires a token (even for public packages). The build picks it up from $GITHUB_TOKEN; nuget.config is wired to the fork's feed with packageSourceMapping so the right source is used per package.

# Populate the submodule (it's not on the build path by default)
git submodule update --init --checkout vendor/SatisfactorySaveNet

cd vendor/SatisfactorySaveNet
# Make changes, run the fork's tests:
DOTNET_ROLL_FORWARD=LatestMajor dotnet test SatisfactorySaveNet.Tests/SatisfactorySaveNet.Tests.csproj -c Release

Every push to the fork's main triggers a continuous publish — the new version is available on GitHub Packages within ~1m of the merge. Bump the app's PackageReference in src/Satisfactory/Save/Satisfactory.Save.csproj once it lands.

Satisfactory.Save wraps the parser into domain entities:

• SaveFileReader.Read(savePath) — entry point. Returns LiveFactoryState (metadata + lists of resource nodes, miners, buildings, belts, pipelines, generators, warnings).
• BuildingIdentifiers — type-path → game-agnostic BuildingId, MinerTier, BeltTier, PipelineTier, GeneratorKind.
• PropertyExtensions — typed accessors over the fork's RawProperty (TryGetFloat, TryGetObjectPath, TryGetString, TryGetInt, TryGetArrayStructValues).
• KnownResourceNodes / KnownFlora — embedded JSON lookups for resource node identity and purity (the save doesn't tell us which iron node we're parsing — coordinates do).

Pipes carry their route in mSplineData (Array<Struct<FSplinePointData>>). Until the fork landed the v1.2 Array<Struct> deep-parse, the planner only had each pipe's origin and had to render them as points. Now SaveFileReader.ExtractPipePolyline walks the spline data and Pipeline.Polyline carries the full LineString, matching how conveyor belts already worked via FGConveyorChainActor.

Pipes without spline data (legacy saves, isolated actors) keep Polyline = null and fall back to point-only rendering.

• 401 Unauthorized from GitHub Packages during restore — $GITHUB_TOKEN is missing or lacks read:packages. Run gh auth refresh -h github.com -s read:packages and re-export.
• "Unsupported body version: " — the parser ran but the save body isn't BodyV8. v1.2 saves should always be BodyV8; older saves are not supported.
• Empty belt polylines — FGConveyorChainActor's ExtraData diverged from the synthesized v1.2 shape; the fork falls back gracefully but you'll see point-only rendering. See fork PR #7.
• Unknown actor warnings — mod-added actors not in the fork's class registry. Safe to ignore unless they're load-bearing for your factory.