Howlwind/TheriapolisV3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit: Theriapolis baseline at port/godot branch point

Browse Source 
Captures the pre-Godot-port state of the codebase. This is the rollback
anchor for the Godot port (M0 of theriapolis-rpg-implementation-plan-godot-port.md).
All Phase 0 through Phase 6.5 work is included; Phase 7 is in flight.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
Christopher Wiebe
2026-04-30 20:40:51 -07:00
commit b451f83174
525 changed files with 75786 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Theriapolis.Tests/Quests/QuestEngineTests.cs
+241
View File
@@ -0,0 +1,241 @@
using Theriapolis.Core;
using Theriapolis.Core.Data;
using Theriapolis.Core.Entities;
using Theriapolis.Core.Rules.Quests;
using Theriapolis.Core.Rules.Reputation;
using Theriapolis.Core.Time;
using Theriapolis.Core.World.Settlements;
using Xunit;
namespace Theriapolis.Tests.Quests;
/// <summary>
/// Phase 6 M4 — quest engine mechanics: start, step transition, on_enter
/// effects, outcome selection, completion / failure terminals,
/// chain-fire when consecutive steps are immediately satisfiable.
/// </summary>
public sealed class QuestEngineTests : IClassFixture<WorldCache>
{
private readonly WorldCache _cache;
public QuestEngineTests(WorldCache c) => _cache = c;
private static QuestDef SimpleLinearQuest()
=> new()
{
Id = "test_linear",
Title = "Linear Test",
EntryStep = "intro",
Steps = new[]
{
new QuestStepDef
{
Id = "intro",
Title = "Begin",
OnEnter = new[] { new QuestEffectDef { Kind = "set_flag", Flag = "started", Value = 1 } },
Outcomes = new[] { new QuestOutcomeDef { Next = "wait" } },
},
new QuestStepDef
{
Id = "wait",
Title = "Wait for trigger",
TriggerConditions = new[] { new QuestConditionDef { Kind = "flag_set", Flag = "trigger" } },
Outcomes = new[] { new QuestOutcomeDef { Next = "done" } },
},
new QuestStepDef
{
Id = "done",
Title = "Done",
CompletesQuest = true,
},
},
};
/// <summary>Build a real ContentResolver but inject a quest tree post-construction via the file system.</summary>
private static (ContentResolver content, string testQuestId) MakeContentWithExtraQuest(QuestDef extra)
{
// Write the quest to a temp dir alongside Content/Data and load
// from there. Cheap, isolated, deterministic.
string baseDir = TestHelpers.DataDirectory;
string tempDir = Path.Combine(System.IO.Path.GetTempPath(),
"theriapolis-test-quests-" + System.Guid.NewGuid().ToString("N"));
Directory.CreateDirectory(tempDir);
// Mirror every Content/Data file (loader expects siblings).
foreach (var f in Directory.EnumerateFiles(baseDir))
File.Copy(f, Path.Combine(tempDir, Path.GetFileName(f)));
foreach (var d in Directory.EnumerateDirectories(baseDir))
{
string destDir = Path.Combine(tempDir, Path.GetFileName(d));
Directory.CreateDirectory(destDir);
foreach (var f in Directory.EnumerateFiles(d))
File.Copy(f, Path.Combine(destDir, Path.GetFileName(f)));
}
// Write the synthetic quest into quests/ and load.
string questDir = Path.Combine(tempDir, "quests");
Directory.CreateDirectory(questDir);
string json = System.Text.Json.JsonSerializer.Serialize(extra,
new System.Text.Json.JsonSerializerOptions { WriteIndented = true });
File.WriteAllText(Path.Combine(questDir, extra.Id + ".json"), json);
return (new ContentResolver(new ContentLoader(tempDir)), extra.Id);
}
[Fact]
public void StartQuest_RunsOnEnter_AndAdvancesAutomatically()
{
var (content, qid) = MakeContentWithExtraQuest(SimpleLinearQuest());
var actors = new ActorManager();
actors.SpawnPlayer(new Theriapolis.Core.Util.Vec2(50, 50));
var rep = new PlayerReputation();
var flags = new Dictionary<string, int>();
var ctx = new QuestContext(content, actors, rep, flags,
new AnchorRegistry(), new WorldClock(), _cache.Get(0xCAFEBABEUL).World);
var engine = new QuestEngine();
Assert.True(engine.Start(qid, ctx));
// After Start: intro's on_enter set the flag; auto-transition to "wait"
// happens because the unconditional outcome fires immediately.
Assert.Equal(1, flags["started"]);
Assert.True(engine.IsActive(qid));
Assert.Equal("wait", engine.Get(qid)!.CurrentStep);
}
[Fact]
public void Quest_AdvancesOnTrigger_AndCompletes()
{
var (content, qid) = MakeContentWithExtraQuest(SimpleLinearQuest());
var actors = new ActorManager();
actors.SpawnPlayer(new Theriapolis.Core.Util.Vec2(50, 50));
var rep = new PlayerReputation();
var flags = new Dictionary<string, int>();
var ctx = new QuestContext(content, actors, rep, flags,
new AnchorRegistry(), new WorldClock(), _cache.Get(0xCAFEBABEUL).World);
var engine = new QuestEngine();
engine.Start(qid, ctx);
Assert.True(engine.IsActive(qid));
// Tick without trigger → still active, still at "wait".
engine.Tick(ctx);
Assert.True(engine.IsActive(qid));
// Set trigger, tick → progresses to "done" (completes_quest).
flags["trigger"] = 1;
engine.Tick(ctx);
Assert.False(engine.IsActive(qid));
Assert.True(engine.IsCompleted(qid));
}
[Fact]
public void StartQuest_TwiceIsNoOp()
{
var (content, qid) = MakeContentWithExtraQuest(SimpleLinearQuest());
var actors = new ActorManager();
actors.SpawnPlayer(new Theriapolis.Core.Util.Vec2(0, 0));
var ctx = new QuestContext(content, actors, new PlayerReputation(),
new Dictionary<string, int>(), new AnchorRegistry(), new WorldClock(),
_cache.Get(0xCAFEBABEUL).World);
var engine = new QuestEngine();
Assert.True(engine.Start(qid, ctx));
Assert.False(engine.Start(qid, ctx));
}
[Fact]
public void AutoStartWhen_FiresOnTick()
{
var tree = new QuestDef
{
Id = "auto_test", Title = "Auto Test", EntryStep = "go",
AutoStartWhen = new[] { new QuestConditionDef { Kind = "flag_set", Flag = "ready" } },
Steps = new[]
{
new QuestStepDef { Id = "go", Title = "Go", CompletesQuest = true },
},
};
var (content, qid) = MakeContentWithExtraQuest(tree);
var actors = new ActorManager();
actors.SpawnPlayer(new Theriapolis.Core.Util.Vec2(0, 0));
var flags = new Dictionary<string, int>();
var ctx = new QuestContext(content, actors, new PlayerReputation(), flags,
new AnchorRegistry(), new WorldClock(), _cache.Get(0xCAFEBABEUL).World);
var engine = new QuestEngine();
engine.Tick(ctx);
Assert.False(engine.IsActive(qid) || engine.IsCompleted(qid));
flags["ready"] = 1;
engine.Tick(ctx);
Assert.True(engine.IsCompleted(qid));
}
[Fact]
public void EnterAnchor_FiresWhenPlayerNearSettlement()
{
// Pick a real settlement at world tile coords and place the player on it.
var world = _cache.Get(0xCAFEBABEUL).World;
var s = world.Settlements.First(x => !x.IsPoi && x.Tier <= 3);
var tree = new QuestDef
{
Id = "anchor_test", Title = "Anchor Test", EntryStep = "go",
Steps = new[]
{
new QuestStepDef
{
Id = "go",
TriggerConditions = new[]
{
new QuestConditionDef { Kind = "enter_anchor", Anchor = "anchor:test_anchor" },
},
CompletesQuest = true,
},
},
};
var (content, qid) = MakeContentWithExtraQuest(tree);
var actors = new ActorManager();
// Place player at the settlement's tile (converted to world-pixel space).
int px = s.TileX * C.WORLD_TILE_PIXELS + C.WORLD_TILE_PIXELS / 2;
int py = s.TileY * C.WORLD_TILE_PIXELS + C.WORLD_TILE_PIXELS / 2;
actors.SpawnPlayer(new Theriapolis.Core.Util.Vec2(px, py));
var anchors = new AnchorRegistry();
// Register a synthetic anchor pointing at the chosen settlement id.
// (Use the real anchor enum value if the settlement has one; else
// rely on RegisterAnchor's lowercased key matching.)
if (s.Anchor is { } a)
anchors.RegisterAnchor(a, s.Id);
else
{
// Fall back: directly insert the anchor mapping via a helper that
// doesn't exist publicly — we'll use the closest real anchor in
// the world that DOES have a settlement.
return; // skip the test; only meaningful when a settlement has an Anchor.
}
// Override the anchor key used by the quest to match the registered one.
// (The test is generic — replace test_anchor with the real anchor name.)
string anchorKey = "anchor:" + a.ToString().ToLowerInvariant();
var tree2 = tree with
{
Steps = new[]
{
tree.Steps[0] with
{
TriggerConditions = new[] { new QuestConditionDef { Kind = "enter_anchor", Anchor = anchorKey } },
},
},
};
var (content2, qid2) = MakeContentWithExtraQuest(tree2);
var ctx = new QuestContext(content2, actors, new PlayerReputation(),
new Dictionary<string, int>(), anchors, new WorldClock(), world);
var engine = new QuestEngine();
engine.Start(qid2, ctx);
engine.Tick(ctx);
Assert.True(engine.IsCompleted(qid2),
$"player at settlement {s.TileX},{s.TileY} should satisfy enter_anchor");
}
}
Theriapolis.Tests/Quests/QuestSnapshotTests.cs
+82
View File
@@ -0,0 +1,82 @@
using Theriapolis.Core;
using Theriapolis.Core.Persistence;
using Theriapolis.Core.Rules.Quests;
using Xunit;
namespace Theriapolis.Tests.Quests;
/// <summary>
/// Phase 6 M4 — capture/restore round-trip for quest engine state.
/// </summary>
public sealed class QuestSnapshotTests
{
[Fact]
public void CaptureAndRestore_RoundTripActiveAndCompleted()
{
var engine = new QuestEngine();
engine.AdoptActive(new QuestState
{
QuestId = "q1", CurrentStep = "step_a", Status = QuestStatus.Active,
StartedAt = 100, StepStartedAt = 150,
});
engine.Get("q1")!.Journal.Add("started q1");
engine.AdoptCompleted(new QuestState
{
QuestId = "q2", CurrentStep = "<end>", Status = QuestStatus.Completed,
StartedAt = 0, StepStartedAt = 200,
});
engine.Journal.Add("global event 1");
var snap = QuestCodec.Capture(engine);
Assert.Single(snap.Active);
Assert.Single(snap.Completed);
Assert.Single(snap.Journal);
var rebuilt = new QuestEngine();
QuestCodec.Restore(rebuilt, snap);
Assert.True(rebuilt.IsActive("q1"));
Assert.True(rebuilt.IsCompleted("q2"));
Assert.Single(rebuilt.Journal);
Assert.Equal("step_a", rebuilt.Get("q1")!.CurrentStep);
Assert.Contains("started q1", rebuilt.Get("q1")!.Journal);
}
[Fact]
public void SaveCodec_RoundTripsQuestEngineState()
{
var engine = new QuestEngine();
engine.AdoptActive(new QuestState
{
QuestId = "main_act_i_001_arrival",
CurrentStep = "find_magistrate",
Status = QuestStatus.Active,
StartedAt = 500, StepStartedAt = 700,
});
engine.Journal.Add("Arrived in Millhaven");
var body = new SaveBody();
body.Player.Name = "Tester";
body.QuestEngineState = QuestCodec.Capture(engine);
var header = new SaveHeader { Version = C.SAVE_SCHEMA_VERSION, WorldSeedHex = "0xCAFE" };
var bytes = SaveCodec.Serialize(header, body);
var (h2, b2) = SaveCodec.Deserialize(bytes);
Assert.Equal(C.SAVE_SCHEMA_VERSION, h2.Version);
Assert.Single(b2.QuestEngineState.Active);
Assert.Equal("find_magistrate", b2.QuestEngineState.Active[0].CurrentStep);
Assert.Single(b2.QuestEngineState.Journal);
}
[Fact]
public void EmptyEngineState_OmitsTagFromSave()
{
// No active/completed/journal → no TAG_QUESTS section written.
var body = new SaveBody { Player = { Name = "Empty" } };
var bytes = SaveCodec.Serialize(new SaveHeader(), body);
var (_, b2) = SaveCodec.Deserialize(bytes);
Assert.Empty(b2.QuestEngineState.Active);
Assert.Empty(b2.QuestEngineState.Completed);
Assert.Empty(b2.QuestEngineState.Journal);
}
}