Add resource node persistence

Scripts/setup_ground_zero_demo_map.py

@@ -864,6 +864,10 @@ def spawn_demo_actor(spec, height_values, materials, safe_spawn_location_xy=None
         raise RuntimeError(f"Could not spawn {spec['label']}")
 
     set_actor_label(actor, spec["label"])
+    try:
+        actor.set_editor_property("persistence_node_id", spec["label"])
+    except Exception:
+        pass
     material_key = material_key_for_actor_label(spec["label"])
     if material_key:
         apply_material_to_actor_meshes(actor, materials[material_key])

Scripts/verify_ground_zero_resources.py

@@ -65,6 +65,10 @@ def main():
             if actor.get_editor_property("remaining_harvests") <= 0:
                 failures.append(f"{label} has no remaining harvests")
 
+            persistence_node_id = str(actor.get_editor_property("persistence_node_id"))
+            if persistence_node_id != label:
+                failures.append(f"{label} persistence node id expected {label}, got {persistence_node_id}")
+
     if failures:
         raise RuntimeError("Ground Zero resource verification failed: " + "; ".join(failures))
 

Scripts/verify_resource_node_persistence.py

@@ -0,0 +1,74 @@
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[1]
+
+EXPECTED = {
+    ROOT / "Source" / "AgrarianGame" / "AgrarianSaveGame.h": [
+        "struct FAgrarianSavedResourceNode",
+        "FName ResourceNodeId = NAME_None;",
+        "int32 RemainingHarvests = 0;",
+        "TArray<FAgrarianSavedResourceNode> ResourceNodes;",
+    ],
+    ROOT / "Source" / "AgrarianGame" / "AgrarianResourceNode.h": [
+        "FName PersistenceNodeId = NAME_None;",
+        "FName GetResourcePersistenceId() const;",
+        "FAgrarianSavedResourceNode CaptureResourceSaveState() const;",
+        "void ApplyResourceSaveState(const FAgrarianSavedResourceNode& SavedNode);",
+    ],
+    ROOT / "Source" / "AgrarianGame" / "AgrarianResourceNode.cpp": [
+        "AAgrarianResourceNode::GetResourcePersistenceId",
+        "PersistenceNodeId != NAME_None ? PersistenceNodeId : GetFName()",
+        "SavedNode.RemainingHarvests = RemainingHarvests;",
+        "RemainingHarvests = FMath::Clamp",
+        "ScheduleRespawnIfNeeded();",
+    ],
+    ROOT / "Source" / "AgrarianGame" / "AgrarianPersistenceSubsystem.h": [
+        "int32 CaptureResourceNodes(UAgrarianSaveGame* SaveGame) const;",
+        "int32 RestoreResourceNodes(const UAgrarianSaveGame* SaveGame) const;",
+        "void FindResourceNodes(TArray<AAgrarianResourceNode*>& OutResourceNodes) const;",
+    ],
+    ROOT / "Source" / "AgrarianGame" / "AgrarianPersistenceSubsystem.cpp": [
+        "SaveGame->ResourceNodes.Reset();",
+        "SaveGame->ResourceNodes.Add(SavedNode);",
+        "RestoreResourceNodes(SaveGame);",
+        "TActorIterator<AAgrarianResourceNode>",
+        "ResourceNode->ApplyResourceSaveState(*SavedNode);",
+    ],
+    ROOT / "Scripts" / "setup_ground_zero_demo_map.py": [
+        'actor.set_editor_property("persistence_node_id", spec["label"])',
+    ],
+    ROOT / "Scripts" / "verify_ground_zero_resources.py": [
+        'actor.get_editor_property("persistence_node_id")',
+        "persistence node id expected",
+    ],
+    ROOT / "Docs" / "TechnicalDesignDocument.md": [
+        "Resource node persistence is map/tile state",
+        "captures only resource nodes that exist in the",
+    ],
+    ROOT / "Docs" / "Terrain" / "GroundZeroResourcePass.md": [
+        "Ground Zero resource actors receive stable `PersistenceNodeId` values",
+        "resource nodes that exist in the loaded world",
+    ],
+    ROOT / "AGRARIAN_DEVELOPMENT_ROADMAP.md": [
+        "[x] Add resource node persistence.",
+    ],
+}
+
+
+def main() -> None:
+    missing = []
+    for path, snippets in EXPECTED.items():
+        text = path.read_text(encoding="utf-8")
+        for snippet in snippets:
+            if snippet not in text:
+                missing.append(f"{path.relative_to(ROOT)}: {snippet}")
+
+    if missing:
+        raise RuntimeError("Resource node persistence verification failed: " + "; ".join(missing))
+
+    print("PASS: resource node persistence captures loaded map/tile nodes by stable id and restores depletion state.")
+
+
+if __name__ == "__main__":
+    main()