/* This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at https://mozilla.org/MPL/2.0/. */ using System; using System.Buffers; using System.Collections.Generic; using System.IO; using System.Linq; using CultMath; using GameCult.Caching; using GameCult.Caching.MessagePack; using MessagePack; using Xunit; using static CultMath.math; using float2 = CultMath.float2; using float3 = CultMath.float3; // Scenarios S2 (docs/scenarios-cut.md, R): every new run is a scenario. The fixture is RunStartTests': a scratch copy // of the shipped catalog, the authored settings and a cast galaxy at a fixed seed. public sealed partial class RunStartTests { // A test's own scenario: a script given inline, staged into the fixture's arena or launched whole. private sealed class Scripted : Scenario { private readonly bool _ambient; private readonly Action _stage; private readonly uint _seed; private readonly Func _generate; public Scripted(bool ambient, Action stage, uint seed = GalaxySeed, Func generate = null) { _ambient = ambient; _stage = stage; _seed = seed; _generate = generate ?? (stage => stage.Cast(TestCasts.Wide)); } public override string Name => "Scripted"; public override string Id => "test-scripted"; public override string Brief => "A test's own scenario."; public override uint Seed => _seed; public override bool Ambient => _ambient; public override Galaxy Generate(GalaxyStage stage) => _generate(stage); public override void Stage(ScenarioStage stage) => _stage(stage); } private static IEnumerable EveryScenario => Scenarios.Modes.Concat(Scenarios.Development).Concat(Scenarios.Tests); // The galaxy inputs the menu hands to RunStart, read from the authored settings. private GalaxyStage Inputs(Func clock = null) { var authored = AuthoredSettings.Load(FindRepoRoot()); return new GalaxyStage( authored.Read("SectorGenerationSettings"), authored.Read("SectorBackgroundSettings"), authored.Read("CastBackgroundSettings"), _cache, _ => { }, null, clock); } // What MainMenu.Launch and StartGame do with a scenario: its galaxy, its arena, then staging. beforeStaging stands in // for whatever the game runs between the arena and staging. private (Galaxy galaxy, Zone arena, RunStart.Staged staged, List failures) Launch(Scenario scenario, GalaxyStage inputs = null, Action beforeStaging = null) { var galaxy = RunStart.Generate(scenario, inputs ?? Inputs()); var arena = new Zone(_items, _planetSettings, RunStart.GenerateArena(_items, _zoneSettings, _planetSettings, galaxy, scenario), galaxy.Entrance, galaxy); beforeStaging?.Invoke(); var failures = new List(); var staged = RunStart.Stage(_items, arena, scenario, _startingHull, failures); return (galaxy, arena, staged, failures); } private RunStart.Staged Stage(Zone zone, Scenario scenario) { var failures = new List(); var staged = RunStart.Stage(_items, zone, scenario, _startingHull, failures); Assert.True(failures.Count == 0, string.Join("; ", failures)); Assert.NotNull(staged); return staged; } // Staging that must fail: it returns null and admits nothing. Returns the failures. private List Refused(Zone zone, Scenario scenario) { var entities = zone.Entities.ToList(); var agents = zone.Agents.ToList(); var failures = new List(); Assert.Null(RunStart.Stage(_items, zone, scenario, _startingHull, failures)); SafeAssert.Unchanged(zone, entities, agents); return failures; } // The rot test: every scenario New Game lists generates its galaxy and stages against the live catalog and the // authored settings with no failure. A script naming a design the catalog lost fails here, by name. [Fact] public void EveryScenarioStages() { Assert.Equal(EveryScenario.Count(), EveryScenario.Select(scenario => scenario.Name).Distinct().Count()); foreach (var scenario in EveryScenario) { var (_, arena, staged, failures) = Launch(scenario, Inputs(() => GalaxySeed)); Assert.True(failures.Count == 0, $"{scenario.Name}: {string.Join("; ", failures)}"); Assert.True(staged.Player.IsPlayerShip, $"{scenario.Name}: the player is not flagged"); SafeAssert.In(arena, staged.Player, $"{scenario.Name}: the player is admitted"); foreach (var entity in staged.Entities) SafeAssert.In(arena, entity, $"{scenario.Name}: {entity.Name} is admitted"); Assert.False(string.IsNullOrWhiteSpace(scenario.Brief), $"{scenario.Name} has no brief"); } } // A run starts with the gameplay settings' starting credits unless its scenario sets another amount. [Fact] public void StagedCreditsAreTheSettingsUnlessTheScenarioSets() { var plain = Stage(Arena(true), new Scripted(true, stage => stage.Player(stage.Bare("Djinni"), float2(0, 0)))); Assert.Equal(_items.GameplaySettings.StartingCredits, plain.Credits); var poor = Stage(Arena(true), new Scripted(true, stage => { stage.Credits = 1234; stage.Player(stage.Bare("Djinni"), float2(0, 0)); })); Assert.Equal(1234, poor.Credits); } // The two game modes are what New Game did: the demo a cast galaxy at half influence and a starting-hull ship at the // entrance's origin; the main galaxy a main galaxy at full influence and a starting-hull ship there. Both arenas // keep their generated ships. [Fact] public void ModesMatchOldNewGame() { Assert.Equal("Longinus", _startingHull); var demo = Launch(new DemoTerminus(), Inputs(() => GalaxySeed)); Assert.Empty(demo.failures); Assert.Equal(.5f, demo.galaxy.InfluenceScale); Assert.Equal(_startingHull, demo.staged.Player.HullData.Name); Assert.Equal(float3.zero, demo.staged.Player.Position); Assert.Empty(demo.staged.Entities); Assert.Contains(demo.arena.Pack.Entities, entity => entity is ShipPack { IsPlayerShip: false }); var main = Launch(new MainGalaxy(), Inputs(() => GalaxySeed)); Assert.Empty(main.failures); Assert.Equal(1f, main.galaxy.InfluenceScale); Assert.Equal(_startingHull, main.staged.Player.HullData.Name); Assert.Equal(float3.zero, main.staged.Player.Position); Assert.Empty(main.staged.Entities); Assert.Contains(main.arena.Pack.Entities, entity => entity is ShipPack { IsPlayerShip: false }); } // Everything a galaxy's layout fixes: each zone's name, position, owner, factions and links, the homes, the // entrance, the exit and the background. private static string Layout(Galaxy galaxy) => string.Join(";", galaxy.Zones.Select(zone => $"{zone.Name}@{zone.Position}:{zone.Owner?.Name}:[{string.Join(",", zone.Factions.Select(faction => faction.Name))}]" + $":[{string.Join(",", zone.AdjacentZones.Select(adjacent => Array.IndexOf(galaxy.Zones, adjacent)).OrderBy(i => i))}]")) + $" homes {string.Join(",", galaxy.HomeZones.Select(home => $"{home.Key.Name}={Array.IndexOf(galaxy.Zones, home.Value)}").OrderBy(home => home))}" + $" entrance {Array.IndexOf(galaxy.Zones, galaxy.Entrance)} exit {Array.IndexOf(galaxy.Zones, galaxy.Exit)} noise {galaxy.Background.NoisePosition}"; // An arena's bodies and every entity in it, down to each item's design, maker, workmanship and role fills. private string Layout(ZonePack arena) => $"{arena.Radius} {arena.Mass} planets [{string.Join(",", arena.Planets.Select(planet => _cache.Get(planet)).Select(body => $"{body.GetType().Name}:{body.Mass}"))}]" + $" orbits [{string.Join(",", arena.Orbits.Select(orbit => _cache.Get(orbit).Distance))}]" + $" entities [{string.Join(",", arena.Entities.Select(Gear))}]"; // What a launch staged: the player and everything placed, each where it is and with exactly what it carries. private string Fits(RunStart.Staged staged) => string.Join(" | ", staged.Entities.Prepend(staged.Player).Select(entity => $"{entity.Name}@{entity.Position}:{Gear(EntitySerializer.Pack(entity))}")); private string Gear(EntityPack pack) => $"{pack.GetType().Name}{(pack is ShipPack ship ? "@" + ship.Position : "")}:{string.Join("/", EntitySerializer.Items(pack).Select(Item))}"; private string Item(ItemInstance item) { var name = _items.GetData(item)?.Name; if (!(item is CraftedItemInstance crafted)) return name; var lot = _items.GetLot(crafted); return $"{name}<{(lot.Origin as Attributed)?.Faction.Key.Value}>~{lot.Quality}" + string.Concat((lot.Roles ?? new List()).Select(fill => $"/{fill.Role}={fill.Quality}")); } // A fixed seed fixes the galaxy, its background, its arena and every fit, each item's maker and workmanship // included, launch after launch in one session, whatever ran in between. Seed zero takes the clock, so two launches // at two clock readings are two galaxies. [Fact] public void SeedRules() { foreach (var scenario in Scenarios.Tests) { Assert.NotEqual(0u, scenario.Seed); var first = Launch(scenario); Launch(new MainGalaxy(), Inputs(() => 4242)); _items.Random = new CultMath.Random(0xC0FFEE); // play draws from the run's item random var second = Launch(scenario, beforeStaging: () => _items.Random = new CultMath.Random(0xBADC0DE)); Assert.True(first.failures.Count == 0, $"{scenario.Name}: {string.Join("; ", first.failures)}"); Assert.Equal(Layout(first.galaxy), Layout(second.galaxy)); Assert.Equal(Layout(first.arena.Pack), Layout(second.arena.Pack)); Assert.Equal(Fits(first.staged), Fits(second.staged)); } var clock = new Queue(new[] { 1000u, 2000u }); var inputs = Inputs(() => clock.Dequeue()); var everyLaunchNew = new Scripted(true, _ => { }, seed: 0, generate: galaxy => galaxy.Main()); var a = RunStart.Generate(everyLaunchNew, inputs); Assert.Equal(1000u, inputs.Seed); var b = RunStart.Generate(everyLaunchNew, inputs); Assert.Equal(2000u, inputs.Seed); Assert.NotEqual(Layout(a), Layout(b)); } // Generating a galaxy writes nothing a later one reads: a cast galaxy leaves the catalog's faction influence as authored. [Fact] public void AGalaxyLeavesTheCatalogsFactionsAsAuthored() { var authored = _cache.GetAll().ToDictionary(faction => faction, faction => faction.InfluenceDistance); RunStart.Generate(new DemoTerminus(), Inputs()); RunStart.Generate(new MainGalaxy(), Inputs()); Assert.All(authored, pair => Assert.Equal(pair.Value, pair.Key.InfluenceDistance)); } // Every zone is linked into one graph. These seeds left zones with no link at all (the vendored float-precision // convex-hull triangulation dropped them), so the constructor threw KeyNotFoundException placing homes (prelude) // or the entrance (main). Each galaxy's links are a subset of its zone positions' Delaunay edges, and the // triangulation agrees with a brute-force empty-circumcircle oracle. [Theory] [InlineData(103u, true)] [InlineData(134u, true)] [InlineData(137u, true)] [InlineData(173u, true)] [InlineData(227u, true)] [InlineData(285u, true)] [InlineData(34u, false)] public void EveryZoneIsLinked(uint seed, bool prelude) { var galaxy = RunStart.Generate(new Scripted(true, _ => { }, seed, stage => prelude ? stage.Cast(TestCasts.Wide) : stage.Main()), Inputs()); Assert.All(galaxy.Zones, zone => Assert.Equal(galaxy.Zones.Length, zone.Distance.Count)); var positions = galaxy.Zones.Select(zone => zone.Position).ToArray(); var edges = Delaunay.Edges(positions); Assert.Equal(BruteForceDelaunay(positions), edges); var delaunay = new HashSet<(int, int)>(edges); for (var i = 0; i < galaxy.Zones.Length; i++) foreach (var adjacent in galaxy.Zones[i].AdjacentZones) { var j = Array.IndexOf(galaxy.Zones, adjacent); Assert.Contains((Math.Min(i, j), Math.Max(i, j)), delaunay); } } // Every triangle whose circumcircle holds no other point, as sorted edges. private static List<(int a, int b)> BruteForceDelaunay(float2[] points) { var edges = new SortedSet<(int a, int b)>(); for (var i = 0; i < points.Length; i++) for (var j = i + 1; j < points.Length; j++) for (var k = j + 1; k < points.Length; k++) { double ax = points[i].x, ay = points[i].y, bx = points[j].x, by = points[j].y, cx = points[k].x, cy = points[k].y; var d = 2 * (ax * (by - cy) + bx * (cy - ay) + cx * (ay - by)); if (d == 0) continue; double a2 = ax * ax + ay * ay, b2 = bx * bx + by * by, c2 = cx * cx + cy * cy; var ux = (a2 * (by - cy) + b2 * (cy - ay) + c2 * (ay - by)) / d; var uy = (a2 * (cx - bx) + b2 * (ax - cx) + c2 * (bx - ax)) / d; var r2 = (ax - ux) * (ax - ux) + (ay - uy) * (ay - uy); var empty = true; for (var m = 0; m < points.Length && empty; m++) if (m != i && m != j && m != k) { double dx = points[m].x - ux, dy = points[m].y - uy; empty = dx * dx + dy * dy >= r2; } if (!empty) continue; edges.Add((i, j)); edges.Add((j, k)); edges.Add((i, k)); } return edges.ToList(); } // A scenario naming one unknown design admits nothing, not even the parts that built, and names the design. [Fact] public void StagingIsAllOrNothing() { var failures = Refused(Arena(true), new Scripted(true, stage => { stage.Player(stage.Bare("Djinni"), float2(0, 0)); stage.Place(stage.Generated("Longinus"), float2(300, 0), stance: ScenarioStance.Hostile, piloted: true); stage.Place(stage.Fit("Longinus", ("No Such Gun", int2(1, 8), ItemRotation.None)), float2(-300, 0)); })); Assert.Contains("No Such Gun", Assert.Single(failures)); } // A pilot's patrol circuit is its own draw (zone seed, agent id), not the item stream's: two arenas that differ only // in items minted before the pilot is admitted give it the same circuit. Kills: the circuit drawn from ItemManager.Random. [Fact] public void APilotsPatrolCircuitDoesNotRideTheItemStream() { Zone Arena(int itemsMintedFirst) { var (_, arena, _, failures) = Launch(new Scripted(false, stage => { stage.Player(stage.Bare("Djinni"), float2(0, 0)); for (var i = 0; i < itemsMintedFirst; i++) stage.Place(stage.Generated("Longinus"), float2(900 + 40 * i, 0)); stage.Place(stage.Generated("Longinus"), float2(300, 0), stance: ScenarioStance.Hostile, piloted: true); })); Assert.True(failures.Count == 0, string.Join("; ", failures)); return arena; } CultRecordKey[] Circuit(Zone arena) => ((PatrolOrbitsTask) Assert.Single(arena.Agents).Task).Circuit; // The orbit keys are fresh per galaxy, so a circuit is compared by the place of each orbit among its zone's. int[] Places(Zone arena) => Circuit(arena).Select(key => arena.Orbits.Keys.ToList().IndexOf(key)).ToArray(); var plain = Arena(0); var disturbed = Arena(3); Assert.True(plain.Orbits.Count > 4, "the zone has orbits to choose a circuit among"); Assert.Equal(4, Places(plain).Length); Assert.Equal(Places(plain), Places(disturbed)); } // Each pilot's circuit is keyed by its own id: three pilots admitted into one zone do not all patrol the same orbits. // Kills: the circuit keyed by a constant. [Fact] public void EachPilotsPatrolCircuitIsItsOwn() { var (_, arena, _, failures) = Launch(new Scripted(false, stage => { stage.Player(stage.Bare("Djinni"), float2(0, 0)); for (var i = 0; i < 3; i++) stage.Place(stage.Generated("Longinus"), float2(300 + 40 * i, 0), stance: ScenarioStance.Hostile, piloted: true); })); Assert.True(failures.Count == 0, string.Join("; ", failures)); var circuits = arena.Agents.Select(agent => string.Join(",", ((PatrolOrbitsTask) agent.Task).Circuit.Select(key => arena.Orbits.Keys.ToList().IndexOf(key)))).ToArray(); Assert.Equal(3, circuits.Length); Assert.True(circuits.Distinct().Count() > 1, "every pilot patrols the same orbits: " + string.Join(" | ", circuits)); } // A fit that states its quality mints every lot it builds at it, assembly and role fills alike; the same fit without one // draws them from the item stream, so some lot comes out otherwise. A scenario's checks rest on the first. [Fact] public void StagedFitMintsAtItsQuality() { (string design, int2 cell, ItemRotation rotation)[] slots = { ("Cockpit 2x2", int2(2, 6), ItemRotation.None), ("Compact Reactor", int2(2, 4), ItemRotation.None), ("Large Drive", int2(1, 0), ItemRotation.Reversed), ("Radiator", int2(2, 2), ItemRotation.CounterClockwise) }; var staged = Stage(Arena(true), new Scripted(true, stage => { stage.Player(stage.Bare("Djinni"), float2(0, 0)); stage.Place(stage.Fit("Longinus", .6f, slots), float2(300, 0)); stage.Place(stage.Fit("Longinus", slots), float2(-300, 0)); })); IEnumerable Lots(Entity entity) => EntitySerializer.Items(EntitySerializer.Pack(entity)).OfType().Select(_items.GetLot).Prepend(_items.GetLot(entity.Hull)); var stated = Lots(staged.Entities[0]).ToArray(); var drawn = Lots(staged.Entities[1]).ToArray(); Assert.True(stated.Length > slots.Length); Assert.All(stated, lot => { Assert.Equal(.6f, lot.Quality, 3); Assert.All(lot.Roles ?? new List(), fill => Assert.Equal(.6f, fill.Quality, 3)); }); Assert.Contains(drawn, lot => Math.Abs(lot.Quality - .6f) > .001f); } // A stance holds both ways between an entity and the player. A piloted entity has exactly one agent; an unpiloted // one has none, and nothing steers it. (It is not frozen: the zone's gravity still moves it, as it moves any ship, // so the rule is observed on its steering inputs.) [Fact] public void StanceAndPilot() { var zone = Arena(true); var staged = Stage(zone, new Scripted(true, stage => { stage.Player(stage.Bare("Djinni"), float2(0, 0)); stage.Place(stage.Generated("Longinus"), float2(300, 0), stance: ScenarioStance.Hostile, piloted: true); stage.Place(stage.Bare("Longinus"), float2(-300, 0), stance: ScenarioStance.Neutral, piloted: false); })); var player = staged.Player; var hostile = staged.Entities[0]; var neutral = staged.Entities[1]; Assert.True(player.IsHostileTo(hostile) && hostile.IsHostileTo(player), "hostile both ways"); Assert.False(player.IsHostileTo(neutral) || neutral.IsHostileTo(player), "neutral both ways"); // Admission activates: the live hostility each side tracks (what targeting and grudges read) agrees. Assert.True(player.EntityHostility[hostile] && hostile.EntityHostility[player]); Assert.False(player.EntityHostility[neutral] || neutral.EntityHostility[player]); Assert.Equal(1, AgentsOf(zone, hostile)); Assert.Equal(0, AgentsOf(zone, neutral)); Assert.Equal(0, AgentsOf(zone, player)); var look = neutral.Aim; for (var tick = 0; tick < 50; tick++) { zone.Update(.1f); Assert.Equal(float2.zero, ((Ship) neutral).MovementDirection); Assert.Equal(look, neutral.Aim); } Assert.Equal(0, AgentsOf(zone, neutral)); } // A summon places into a running zone through the stage's admission (ruling ifl-ships-in-demo-as-tactical-view): after a run // has started and stepped, a hostile piloted generated ship that approaches the player is a member with one agent, hostile // both ways, and its pilot knows the player by the sensors' own path. Kills: a summon that skips the stance, the pilot or // the knowledge seed. [Fact] public void ASummonJoinsARunningZone() { var zone = Arena(true); var player = Stage(zone, new Scripted(true, stage => stage.Player(stage.Bare("Djinni"), float2(0, 0)))).Player; for (var tick = 0; tick < 20; tick++) zone.Update(.1f); var failures = new List(); var summoned = ZoneStage.Summon(_items, zone, player, stage => { var placed = stage.Place(stage.Generated("Longinus"), float2(400, 0), stance: ScenarioStance.Hostile, piloted: true); stage.Approach(placed, player); }, failures); Assert.True(failures.Count == 0, string.Join("; ", failures)); var raider = Assert.Single(summoned); SafeAssert.In(zone, raider, "the summoned ship is admitted"); Assert.Equal(1, AgentsOf(zone, raider)); Assert.True(player.IsHostileTo(raider) && raider.IsHostileTo(player), "hostile both ways"); Assert.Equal((_items.GameplaySettings.TargetDetectionInfoThreshold + 1f) / 2f, raider.EntityInfoGathered[player]); for (var tick = 0; tick < 20; tick++) zone.Update(.1f); Assert.True(player.EntityHostility[raider] && raider.EntityHostility[player], "the live hostility agrees"); Assert.Equal(1, AgentsOf(zone, raider)); } // A summon naming a design the catalog lacks admits nothing, and names it. Kills: admitting before the failure check. [Fact] public void ARefusedSummonAdmitsNothing() { var zone = Arena(true); var player = Stage(zone, new Scripted(true, stage => stage.Player(stage.Bare("Djinni"), float2(0, 0)))).Player; var entities = zone.Entities.ToList(); var agents = zone.Agents.ToList(); var failures = new List(); var summoned = ZoneStage.Summon(_items, zone, player, stage => { stage.Place(stage.Generated("Longinus"), float2(400, 0), stance: ScenarioStance.Hostile, piloted: true); stage.Place(stage.Bare("No Such Hull"), float2(-400, 0)); }, failures); Assert.Null(summoned); Assert.Contains(failures, failure => failure.Contains("No Such Hull")); SafeAssert.Unchanged(zone, entities, agents); } // A summon needs the player to be in the zone it summons into: with the player docked it refuses, names why and admits nothing. // Kills: dropping the membership check, which would write stance onto a non-member. [Fact] public void ASummonNeedsThePlayerInTheZone() { var zone = Arena(true); var player = Stage(zone, new Scripted(true, stage => stage.Player(stage.Bare("Djinni"), float2(0, 0)))).Player; Assert.True(zone.Remove(player)); var entities = zone.Entities.ToList(); var agents = zone.Agents.ToList(); var failures = new List(); var summoned = ZoneStage.Summon(_items, zone, player, stage => stage.Place(stage.Bare("Longinus"), float2(400, 0), stance: ScenarioStance.Hostile), failures); Assert.Null(summoned); Assert.Equal(new[] { "summon: the player is not in this zone" }, failures); SafeAssert.Unchanged(zone, entities, agents); } // A refused summon leaves the item stream and the lot ledger (which a run save persists) where they were, so a refusal is neither // a draw nor a mint. Kills: a summon that keeps the draws or the lots of the fits it built before refusing. [Fact] public void ARefusedSummonLeavesTheItemStream() { var zone = Arena(true); var player = Stage(zone, new Scripted(true, stage => stage.Player(stage.Bare("Djinni"), float2(0, 0)))).Player; var before = _items.Random; var nextLot = _items.Lots.NextLot; var lots = _items.Lots.Lots.Keys.ToList(); var failures = new List(); Assert.Null(ZoneStage.Summon(_items, zone, player, stage => { stage.Place(stage.Generated("Longinus"), float2(400, 0)); stage.Place(stage.Bare("No Such Hull"), float2(-400, 0)); }, failures)); var after = _items.Random; Assert.Equal(before.NextUInt(), after.NextUInt()); Assert.Equal(nextLot, _items.Lots.NextLot); Assert.Equal(lots.OrderBy(id => id), _items.Lots.Lots.Keys.OrderBy(id => id)); } // The anchor of a summon is the player's ship, not any ship in the zone. Kills: a summon that takes any zone member as the player. [Fact] public void ASummonNeedsThePlayersShipAsItsAnchor() { var zone = Arena(true); var player = Stage(zone, new Scripted(true, stage => stage.Player(stage.Bare("Djinni"), float2(0, 0)))).Player; var other = zone.Entities.OfType().First(ship => !ship.IsPlayerShip); var entities = zone.Entities.ToList(); var agents = zone.Agents.ToList(); var failures = new List(); Assert.Null(ZoneStage.Summon(_items, zone, other, stage => stage.Place(stage.Bare("Longinus"), float2(400, 0), stance: ScenarioStance.Hostile), failures)); Assert.Equal(new[] { "summon: the anchor is not the player's ship" }, failures); SafeAssert.Unchanged(zone, entities, agents); } // A faction's boss is the zone generator's to place (boss-hulls-exclusive): a preset naming the loadout Loadouts.BossOf // returns is refused, through a summon as through a run start. Kills: a Preset that places any catalog loadout. [Fact] public void APresetCannotPlaceAFactionsBoss() { var zone = Arena(true); var player = Stage(zone, new Scripted(true, stage => stage.Player(stage.Bare("Djinni"), float2(0, 0)))).Player; var boss = _cache.GetAll().Select(faction => Loadouts.BossOf(_cache, faction, out _)).First(loadout => loadout != null); var entities = zone.Entities.ToList(); var agents = zone.Agents.ToList(); var failures = new List(); Assert.Null(ZoneStage.Summon(_items, zone, player, stage => stage.Place(stage.Preset(boss.Name), float2(400, 0), stance: ScenarioStance.Hostile, piloted: true), failures)); Assert.Contains(failures, failure => failure.Contains(boss.Name) && failure.Contains("boss")); SafeAssert.Unchanged(zone, entities, agents); var started = Refused(Arena(true), new Scripted(true, stage => { stage.Player(stage.Bare("Djinni"), float2(0, 0)); stage.Place(stage.Preset(boss.Name), float2(400, 0)); })); Assert.Contains(started, failure => failure.Contains("boss")); } // A stance lasts the sitting: the player docking and undocking leaves it standing both ways. It goes with an entity // gone for good: once an entity is destroyed, the player holds no stance toward it. [Fact] public void AStanceSurvivesDockingButNotDestruction() { var zone = Arena(true); var staged = Stage(zone, new Scripted(true, stage => { stage.Player(stage.Bare("Djinni"), float2(0, 0)); stage.Place(stage.Bare("Longinus"), float2(300, 0), stance: ScenarioStance.Hostile); stage.Place(stage.Bare("Longinus"), float2(-300, 0), stance: ScenarioStance.Hostile); })); var player = staged.Player; var hostile = staged.Entities[0]; var doomed = staged.Entities[1]; var station = zone.Entities.First(entity => entity is OrbitalEntity && entity.DockingBays.Count > 0); Assert.NotNull(station.TryDock(player)); SafeAssert.NotIn(zone, player, "a docked ship is out of the zone"); Assert.True(station.TryUndock(player)); Assert.True(player.IsHostileTo(hostile) && hostile.IsHostileTo(player), "the stance was lost over docking"); Assert.True(player.EntityHostility[hostile] && hostile.EntityHostility[player], "the live hostility was lost over docking"); // Bare fits carry no faction, so without its stance the derived rule is not hostile Assert.True(player.Faction == null && doomed.Faction == null, "the fixture's ships are factionless"); Assert.True(player.IsHostileTo(doomed)); doomed.Hull.Durability = 0; doomed.HullDamage.OnNext(1); SafeAssert.NotIn(zone, doomed, "a destroyed entity leaves the zone"); Assert.False(player.IsHostileTo(doomed), "the stance toward a destroyed entity outlived it"); } // Undocking admits the ship unpiloted: back in the zone, active (its live hostility is tracked), with no agent. [Fact] public void UndockingAdmitsWithNoAgent() { var zone = Arena(true); var player = Stage(zone, new Scripted(false, stage => stage.Player(stage.Generated(stage.StartingHull), float2(0, 0)))).Player; var station = zone.Entities.First(entity => entity is OrbitalEntity && entity.DockingBays.Count > 0); var agents = zone.Agents.Count; Assert.NotNull(station.TryDock(player)); SafeAssert.NotIn(zone, player, "a docked ship is out of the zone"); Assert.True(station.TryUndock(player)); SafeAssert.In(zone, player, "an undocked ship is back in the zone"); Assert.Equal(agents, zone.Agents.Count); Assert.Equal(0, AgentsOf(zone, player)); Assert.True(player.EntityHostility.ContainsKey(station), "an undocked ship is active"); } // Ambient false keeps the stations and drops every generated ship and turret; ambient keeps them. The arena is the // galaxy's entrance pack. The entrance holds a story station, placed as the narrative would place one, so a story // station's own turrets are dropped too. [Fact] public void AQuietArenaHasNoGeneratedShipOrTurretButKeepsItsStations() { (int ships, int turrets, int stations) Census(ZonePack pack) => ( pack.Entities.OfType().Count(), pack.Entities.OfType().Count(e => ((HullData) _cache.Get(e.Hull.Data)).HullType == HullType.Turret), pack.Entities.OfType().Count(e => ((HullData) _cache.Get(e.Hull.Data)).HullType == HullType.Station)); _galaxy.Entrance.Locations.Add(new LocationStory { Zone = _galaxy.Entrance, Name = "story", Type = LocationType.Station, Faction = _protagonist, Turrets = 2 }); var ambient = Census(RunStart.GenerateArena(_items, _zoneSettings, _planetSettings, _galaxy, new Scripted(true, _ => { }))); var quietPack = RunStart.GenerateArena(_items, _zoneSettings, _planetSettings, _galaxy, new Scripted(false, _ => { })); var quiet = Census(quietPack); Assert.Same(quietPack, _galaxy.Entrance.PackedContents); Assert.True(ambient.ships > 0 && ambient.turrets > 0, $"an ambient arena generated {ambient}"); Assert.Equal(0, quiet.ships); Assert.Equal(0, quiet.turrets); Assert.True(quiet.stations > 0); Assert.Equal(ambient.stations, quiet.stations); Assert.Contains(quietPack.Entities.OfType(), station => station.Story == 0); } // A scenario's player is its fit (here a catalog preset), at the scripted place and heading, carrying its cargo. [Fact] public void AScenarioPlayerIsItsFitAtItsPlaceWithItsCargo() { var generator = new LoadoutGenerator(ref _items.Random, _items, null, null, null, 2); var preset = Loadouts.Capture(_items, (Ship) EntitySerializer.Unpack(_items, null, generator.GenerateShipLoadout(hull => hull.Name == "Djinni")), "test djinni"); _cache.Upsert(preset); // Two one-cell designs a manufacturer makes, by name, so the cargo is ordinary branded stock var cargo = _cache.GetAll() .Where(design => design.Shape.Coordinates.Length == 1) .Where(design => _cache.GetAll().Any(p => p.Design.Key.Equals(_cache.RefOf(design).Key))) .OrderBy(design => design.Name, StringComparer.Ordinal) .Take(2) .ToList(); Assert.Equal(2, cargo.Count); var zone = Arena(true); var player = Stage(zone, new Scripted(true, stage => stage.Cargo(stage.Player(stage.Preset("test djinni"), float2(120, -40), float2(3, 4)), cargo.Select(design => design.Name).ToArray()))).Player; Assert.Equal("Djinni", player.HullData.Name); SafeAssert.In(zone, player, "the player is admitted"); Assert.Equal(float3(120, 0, -40), player.Position); Assert.True(length(player.Direction - float2(.6f, .8f)) < 1e-5f, $"heading {player.Direction}"); Assert.Equal( preset.Slots.Select(slot => (slot.Position, slot.Design.Key)).OrderBy(s => s.ToString()), player.Equipment.Concat(player.CargoBays).Concat(player.DockingBays) .Where(item => item != player.EquippedHull) .Select(item => (item.Position, _cache.RefOf(_items.GetData(item.EquippableItem)).Key)) .OrderBy(s => s.ToString())); Assert.Equal(cargo.Select(design => _cache.RefOf(design).Key.Value).OrderBy(k => k), player.CargoBays.First().Cargo.Keys.Select(item => item.Data.Key.Value).OrderBy(k => k)); } // A turret hull stages as an orbital entity with no orbit, which stays where it is put. [Fact] public void ATurretStagesAsAStationaryOrbitalEntity() { var zone = Arena(true); var staged = Stage(zone, new Scripted(true, stage => { stage.Player(stage.Bare("Djinni"), float2(0, 0)); stage.Place(stage.Bare(TurretHull().Name), float2(200, 50), stance: ScenarioStance.Hostile); })); var turret = Assert.IsType(staged.Entities[0]); Assert.False(turret.OrbitData.IsSet()); SafeAssert.In(zone, turret, "the turret is admitted"); for (var tick = 0; tick < 20; tick++) zone.Update(.1f); Assert.Equal(float2(200, 50), turret.Position.xz); } // A run has exactly one player, and it is a ship; a station is never staged, and a turret is never piloted. Each // is a staging failure, named, with nothing admitted. [Fact] public void AMisplacedHullOrPlayerIsAStagingFailure() { var station = _cache.GetAll().First(hull => hull.HullType == HullType.Station).Name; var turret = TurretHull().Name; foreach (var (script, expected) in new (Action, string)[] { (stage => { stage.Player(stage.Bare("Djinni"), float2(0, 0)); stage.Place(stage.Bare(station), float2(200, 0)); }, $"{station} is a station hull"), (stage => stage.Player(stage.Bare(turret), float2(0, 0)), $"player: {turret} is not a ship hull"), (stage => { stage.Player(stage.Bare("Djinni"), float2(0, 0)); stage.Place(stage.Bare(turret), float2(200, 0), piloted: true); }, "cannot be piloted"), (stage => stage.Place(stage.Bare("Djinni"), float2(200, 0)), "places no player"), (stage => { stage.Player(stage.Bare("Djinni"), float2(0, 0)); stage.Player(stage.Bare("Djinni"), float2(9, 0)); }, "a second player"), }) { var failures = Refused(Arena(true), new Scripted(true, script)); Assert.Contains(failures, failure => failure.Contains(expected)); } } // Arcs' geometry: the bow hull sits inside every one of the player's forward mount arcs, the stern hull outside all of // them (the side mounts are ArcsFlanks'), the turret is hostile and the bare hulls are neutral. [Fact] public void ArcsGeometry() { var staged = Stage(Arena(false), new Arcs()); var player = staged.Player; var bow = staged.Entities[0]; var stern = staged.Entities[1]; var turret = Assert.IsType(staged.Entities[2]); Assert.Equal((Arcs.Bow, Arcs.Stern, Arcs.Turret), (bow.Position.xz, stern.Position.xz, turret.Position.xz)); var mounts = player.Equipment.Where(item => item.Behaviors.OfType().Any() && item.EquippableItem.Rotation == ItemRotation.None).ToList(); Assert.NotEmpty(mounts); foreach (var mount in mounts) { Assert.True(FireControl.InArc(mount, bow.Position - player.Position), $"{mount.Data.Name} cannot bear on the bow hull"); Assert.False(FireControl.InArc(mount, stern.Position - player.Position), $"{mount.Data.Name} bears on the stern hull"); } Assert.True(player.IsHostileTo(turret) && turret.IsHostileTo(player), "the turret is hostile"); Assert.False(player.IsHostileTo(bow) || player.IsHostileTo(stern) || player.IsHostileTo(staged.Entities[3]) || player.IsHostileTo(staged.Entities[4]), "the bare hulls are neutral"); } // Q3 (operator, 2026-09-30): a design no product sells is a scenario test design and nothing else. A test design // is one some scenario's staged entities carry, fitted or in cargo. These are the unsold designs none carries. private List UnsoldAndUnplaced(IEnumerable runs) { var sold = _cache.GetAll().Select(product => product.Design.Key).ToHashSet(); var placed = new HashSet(); foreach (var entity in runs.SelectMany(run => run.Entities.Prepend(run.Player))) { foreach (var item in entity.Equipment.Concat(entity.CargoBays).Concat(entity.DockingBays)) placed.Add(_cache.RefOf(_items.GetData(item.EquippableItem)).Key); foreach (var item in entity.CargoBays.SelectMany(bay => bay.Cargo.Keys)) placed.Add(item.Data.Key); } return _cache.GetAll() .Where(design => !sold.Contains(_cache.RefOf(design).Key) && !placed.Contains(_cache.RefOf(design).Key)) .Select(design => design.Name).OrderBy(name => name, StringComparer.Ordinal).ToList(); } // The shipped catalog holds no unsold design that no scenario carries (today, none unsold at all). A new unsold // design is flagged until a scenario fits it or carries it as cargo. [Fact] public void EveryUnsoldDesignIsAScenarioTestDesign() { var runs = EveryScenario.Select(scenario => Launch(scenario, Inputs(() => GalaxySeed)).staged).ToList(); Assert.Empty(UnsoldAndUnplaced(runs)); void Probe(string name) { var shape = new Shape(1, 1); shape[int2(0, 0)] = true; _cache.Upsert(new GearData { Name = name, Hardpoint = HardpointType.Tool, Shape = shape, Durability = 1 }); } Probe("Census Fitted"); Probe("Census Carried"); Assert.Equal(new[] { "Census Carried", "Census Fitted" }, UnsoldAndUnplaced(runs)); runs.Add(Stage(Arena(false), new Scripted(false, stage => { var ship = stage.Player(stage.Fit("Djinni", ("Census Fitted", int2(1, 6), ItemRotation.None), ("Cargo Bay", int2(3, 6), ItemRotation.None)), float2(0, 0)); stage.Cargo(ship, "Census Carried"); }))); Assert.Empty(UnsoldAndUnplaced(runs)); } // How far influence reaches is the galaxy's fact (Galaxy.InfluenceScale); a save records it with no second owner, and // a save without one (written before it existed) is refused by name rather than read as full influence. [Fact] public void InfluenceScaleRoundTripsAndOldSavesAreRefused() { var arena = Arena(true); var (demo, _) = RunSave.Capture(_cache, _galaxy, arena, null, new SavedActionBarBinding[0], 0); Assert.Equal(.5f, demo.InfluenceScale); var (main, _) = RunSave.Capture(_cache, MainSectorGalaxy(), arena, null, new SavedActionBarBinding[0], 0); Assert.Equal(1f, main.InfluenceScale); var old = Assert.Throws(() => new Galaxy(_cache, new SavedGame { Zones = demo.Zones, Factions = demo.Factions, HomeZones = demo.HomeZones, BossZones = demo.BossZones, Entrance = demo.Entrance, Exit = demo.Exit, DiscoveredZones = demo.DiscoveredZones, Background = demo.Background, Relationships = demo.Relationships, Standings = demo.Standings, Seed = demo.Seed, InfluenceScale = 0, }, _ => { })); Assert.Contains(nameof(SavedGame.InfluenceScale), old.Message); } // The halving is the cast's: InfluenceOf scales a faction's authored distance by the galaxy's InfluenceScale, rounding up. [Fact] public void InfluenceOfMatchesTheHalving() { var half = _galaxy; var full = MainSectorGalaxy(); var faction = _cache.GetAll().First(); var authored = faction.InfluenceDistance; try { for (var distance = 0; distance <= 10; distance++) { faction.InfluenceDistance = distance; Assert.Equal((distance + 1) / 2, half.InfluenceOf(faction)); Assert.Equal(distance, full.InfluenceOf(faction)); } } finally { faction.InfluenceDistance = authored; } } // Whether the arena gets a forced entrance station is the scenario's declaration, not the galaxy's. At a seed whose // natural roll is zero stations, a scenario declaring one gets a docking station and the same arena generated without // the declaration gets none. [Fact] public void EntranceStationIsTheScenariosDeclaration() { Assert.True(new DemoTerminus().EntranceStation); Assert.False(new MainGalaxy().EntranceStation); var natural = ZoneGenerator.GenerateZone(_items, _zoneSettings, _planetSettings, _galaxy, _galaxy.Entrance, entranceStation: false, ambient: false); var forced = ZoneGenerator.GenerateZone(_items, _zoneSettings, _planetSettings, _galaxy, _galaxy.Entrance, entranceStation: true, ambient: false); Assert.Equal(0, StationsOf(natural)); Assert.True(StationsOf(forced) >= 1); // Through RunStart, the scenario's declaration is what reaches the generator. Assert.True(StationsOf(RunStart.GenerateArena(_items, _zoneSettings, _planetSettings, _galaxy, new DemoTerminus())) >= 1); Assert.Equal(0, StationsOf(RunStart.GenerateArena(_items, _zoneSettings, _planetSettings, _galaxy, new MainGalaxy()))); } private int StationsOf(ZonePack pack) => pack.Entities.OfType().Count(entity => (_cache.Get(entity.Hull.Data) as HullData)?.HullType == HullType.Station); // PlayerSettings Key 2, the never-written tutorial flag, is retired: a player.cc written with it still loads, every other field intact. [Fact] public void OldPlayerSettingsLoad() { var options = CultDocumentMessagePackSerialization.OptionsFor(typeof(PlayerSettings).Assembly); var buffer = new ArrayBufferWriter(); var writer = new MessagePackWriter(buffer); writer.WriteArrayHeader(7); writer.Write("Pilot"); writer.WriteNil(); // Key 1, retired before this cut writer.Write(true); // Key 2, the retired tutorial flag MessagePackSerializer.Serialize(ref writer, new Dictionary { ["story"] = "hash" }, options); MessagePackSerializer.Serialize(ref writer, new PlayerGameplaySettings { TemperatureUnit = TemperatureUnit.Kelvin, SignificantDigits = 5 }, options); MessagePackSerializer.Serialize(ref writer, new PlayerInputSettings { ActionBarInputs = { "/1" } }, options); writer.WriteArrayHeader(3); // the old PlayerGraphicsSettings: Key 1 the retired minimap bool MessagePackSerializer.Serialize(ref writer, Quality.High, options); writer.Write(true); writer.Write(0.25f); writer.Flush(); var settings = MessagePackSerializer.Deserialize(buffer.WrittenMemory, options); Assert.Equal("Pilot", settings.Name); Assert.Equal("hash", settings.HashedStoryFiles["story"]); Assert.Equal((TemperatureUnit.Kelvin, 5), (settings.GameplaySettings.TemperatureUnit, settings.GameplaySettings.SignificantDigits)); Assert.Equal("/1", Assert.Single(settings.InputSettings.ActionBarInputs)); Assert.Equal((Quality.High, 0.25f), (settings.GraphicsSettings.NebulaQuality, settings.GraphicsSettings.ScreenShake)); } // A scenario's Brief is player text (the menu shows it): it names gear by what the catalog sells today. A name a rename retired, // that no design or product carries any more, would send the player looking for gear that is gone. [Fact] public void NoScenarioBriefNamesRetiredGear() { var current = _cache.GetAll().Select(design => design.Name) .Concat(_cache.GetAll().Select(product => product.Name)).ToHashSet(StringComparer.Ordinal); var stale = new List(); foreach (var scenario in EveryScenario) foreach (var retired in Program.Renames.Select(row => row.Old).Where(name => !current.Contains(name))) if (System.Text.RegularExpressions.Regex.IsMatch(scenario.Brief, @"(?