Document architecture checkpoint and restore original task callback order

This commit is contained in:
UnixNight committed 2026-10-25 12:56:17 -04:00
1 parent 69d0187a21
commit 531883aaac
45 files changed
+2935 -43

No files matched your search

+22 -10
View File
@@ -10,7 +10,7 @@ var lab = GamLevel.Load(AssetPath.Resolve(root, "gam/level1b.gam"));
var counter = 1;
var tasks = new TaskStates(original.Tasks);
var director = new SceneDirector(lab, tasks, (_, _) => 5);
var interactions = new SceneInteractions(director, tasks, original, lab.Code);
var interactions = new SceneInteractions(director, tasks, original);
director.Begin(lab.FindStart()!);
interactions.Reset();
director.Skip();
@@ -25,7 +25,19 @@ var help = -1;
var selected = -1;
var events = new List<string>();
interactions.CheckpointCaptured += p => { checkpoint = p; events.Add("checkpoint"); };
tasks.Assigned += (name, state) => { if (name == "SCENE" && state == 50) events.Add("task50"); };
interactions.ObjectiveChanged += objective =>
{
if (objective != 2) return;
Check(tasks.Get("SCENE") == 35, "Objective callback observes old task records before assignment");
events.Add("objective2");
};
tasks.Assigned += (name, state) =>
{
if (name != "SCENE" || state != 50) return;
Check(interactions.CurrentObjective == 2 && tasks.Get(name) == 50,
"Entity assignment observers see the selected objective and new task records");
events.Add("task50");
};
interactions.PracticeRequested += page => { help = page; events.Add("help"); };
interactions.Inventory.GadgetSelected += gadget => { selected = gadget; events.Add("gadget"); };
interactions.Collected += (_, points) => events.Add("score" + points);
@@ -33,10 +45,10 @@ interactions.Update(shrinkray.Position);
Check(tasks.Get("SCENE") == 50 && interactions.Score == 50, "Shrinkray grants50 and original task35->50");
Check(interactions.Inventory.State(0, 3) == 1 && selected == 3 && help == 0, "Shrinkray inventory/help/gadget side effects");
Check(checkpoint == shrinkray.Position && !shrinkray.Visible && !shrinkray.Active, "Capture current root before hiding acquired shrinkray");
Check(events.SequenceEqual(new[] { "checkpoint", "task50", "help", "gadget", "score50" }), "Recovered special hook ordering");
Check(events.SequenceEqual(new[] { "checkpoint", "objective2", "task50", "help", "gadget", "score50" }), "Recovered special hook ordering");
Check(interactions.Snapshot().ItemStates[301] == 1 && interactions.CurrentObjective == 2, "Acquired state and objective2 persist");
interactions.Update(shrinkray.Position);
Check(interactions.Score == 50 && events.Count == 5, "Repeated overlap cannot recollect");
Check(interactions.Score == 50 && events.Count == 6, "Repeated overlap cannot recollect");
Console.WriteLine("PASS source intro/explanation/shrinkray state, inventory and event ordering");
var carl = director.FindActor("C3DCARL")!;
@@ -69,7 +81,7 @@ Check(decoded.InventoryStates[3] == 1 && decoded.ItemStates[301] == 1 && decoded
Check(decoded.StoredVector == original.StoredVector, "Pickup42AF00 does not overwrite the separate saved transition root");
var restoredTasks = new TaskStates(decoded.Tasks);
var restoredDirector = new SceneDirector(lab, restoredTasks, (_, _) => 5);
var restored = new SceneInteractions(restoredDirector, restoredTasks, decoded, lab.Code);
var restored = new SceneInteractions(restoredDirector, restoredTasks, decoded);
restoredDirector.Begin(lab.FindStart()!); restored.Reset(); restoredDirector.Skip();
Check(!restoredDirector.FindActor("shrinkray")!.Active && restored.Inventory.State(0, 3) == 1, "Resume retains collected shrinkray/inventory");
restored.Update(restoredDirector.FindActor("shrinkray")!.Position);
@@ -82,7 +94,7 @@ foreach (var state in new[] { 30, 36, 50 })
{
var boundaryTasks = new TaskStates(original.Tasks.Select(t => t.Name == "SCENE" ? t with { State = state } : t));
var boundaryDirector = new SceneDirector(lab, boundaryTasks, (_, _) => 1);
var boundary = new SceneInteractions(boundaryDirector, boundaryTasks, original, lab.Code);
var boundary = new SceneInteractions(boundaryDirector, boundaryTasks, original);
boundary.Update(boundaryDirector.FindActor("shrinkray")!.Position);
Check(boundaryTasks.Get("SCENE") == state && boundary.Inventory.State(0, 3) == 0 && boundary.Score == 50,
"Shrinkray special effect exact task35 gate, ordinary score remains");
@@ -100,7 +112,7 @@ foreach (var talkState in new[] { -1, -2, 50, 49 })
("TalkState2", -2), ("TalkTrigger2", "fallback"));
var testTasks = new TaskStates([new("SCENE", 50)]);
var testDirector = new SceneDirector(new("TEST", [body, friend, camera0, camera1]), testTasks, (_, _) => 5);
var test = new SceneInteractions(testDirector, testTasks, original, "TEST");
var test = new SceneInteractions(testDirector, testTasks, original);
test.Update(Vector3.Zero);
Check(testDirector.CurrentTag == (talkState is -2 or 50 ? "first" : "fallback"), "First existing match/wildcard; -1 disabled, missing target skipped");
Check(testTasks.Get("SCENE") == 60 && test.Score == 100, "Selected trigger alone invokes Carl callback");
@@ -109,7 +121,7 @@ var noneFriend = Entity("3CAR", "friend", ("AIState", 6), ("TargetName", "jim"),
("TalkState0", 49), ("TalkTrigger0", "first"));
var noTasks = new TaskStates([new("SCENE", 50)]);
var noDirector = new SceneDirector(new("TEST", [body, noneFriend, camera0]), noTasks, (_, _) => 5);
var noTalk = new SceneInteractions(noDirector, noTasks, original, "TEST");
var noTalk = new SceneInteractions(noDirector, noTasks, original);
noTalk.Update(Vector3.Zero);
Check(noTasks.Get("SCENE") == 50 && noTalk.Score == 0 && noDirector.FindActor("friend")!.AIstate == 0,
"No matching talk target leaves state0 without award/task mutation");
@@ -121,13 +133,13 @@ foreach (var distance in new[] { 160f, 159.5f })
("TalkState0", 50), ("TalkTrigger0", "first"));
var edgeTasks = new TaskStates([new("SCENE", 50)]);
var edgeDirector = new SceneDirector(new("TEST", [body, friend, camera0]), edgeTasks, (_, _) => 5);
var edge = new SceneInteractions(edgeDirector, edgeTasks, original, "TEST");
var edge = new SceneInteractions(edgeDirector, edgeTasks, original);
edge.Update(new(distance, 0, 0));
Check(edge.Score == (distance < 160 ? 100 : 0), "Strict original sum-radius Carl contact boundary");
}
var waiting = new SceneDirector(lab, new TaskStates(original.Tasks), (_, _) => 5);
waiting.Begin(lab.FindStart()!);
var locked = new SceneInteractions(waiting, new TaskStates(original.Tasks), original, lab.Code);
var locked = new SceneInteractions(waiting, new TaskStates(original.Tasks), original);
locked.Update(waiting.FindActor("shrinkray")!.Position);
Check(locked.Score == 0 && locked.Snapshot().ItemStates[301] == 0, "Noncontrolled intro cannot collect pickups");
Console.WriteLine("PASS strict recovered Carl radius boundary and active-player control gate");