ModernUO/Projects/UOContent.Tests/Tests/Engines/Pathing/Multi/MultiWalkabilityTests.cs
Kamron Batman 54c0040ac8
test: run tile-dependent tests on synthetic terrain instead of client files (#2725)
## Summary

About 114 tests skipped on CI because they needed the official client files (`tiledata.mul`, map and multi files). They gave CI no signal, and locally they ran against whichever client a developer had installed. The test hosts now build their own world instead, so every test runs on CI and runs the same on every machine. CI simulation: Server.Tests 837 passed, UOContent.Tests 1131 passed, **0 skipped**.

- **Generated tile data.** The fixtures write a pre-HS `tiledata.mul` from a small invented tile kit (`Server.Tests/Terrain/TestTiles`) and load it through the real `TileData.Load()`. The test hosts no longer read any client directory (`MODERNUO_CLIENT_PATH`, `MODERNUO_TEST_DATA_DIR` and `C:\Ultima Online Classic` are gone from test code). The file is written to `SyntheticData` in each test project's output, overwritten every run and removed by `dotnet clean`.
- **Injected terrain.** `TestTerrain` stamps land and statics into Felucca and Trammel, which share one terrain. Writes after startup must go in a `TestTerrain.Scope()`, which puts back every block it touched and keeps the step cache fresh.
- **Prefab scenes.** Seven named scenes (town, causeway, sewer walkway, coastline, deep sea, map-edge sea, an upstairs room with an L-shaped counter) replace the Britain coordinates the pathing, AI and fishing tests relied on. Each scene-based test asserts its scene is present first, so a missing scene fails instead of passing on flat ground. Stamping all seven takes 3-5 ms.
- **Multi footprints.** Contrived footprints for the three multi IDs content looks up (0x74, 0x7A, 0x0) are seeded through a new internal `MultiData.SetComponents`.
- **Fingerprint.** `StepCacheFile.HashTileDataFile` is extracted so a test can show that a one-flag change to the file changes the fingerprint, while runtime table mutation does not.

### Engine changes

- `TileMatrix.GetLandBlock`/`GetStaticBlock`: on a map without its files, return the block injected with `SetLandBlock`/`SetStaticBlock`, or the default when nothing was injected. Maps with files take the same path as before.
- `MultiData.SetComponents` (internal): registers a footprint without multi files.

### Test changes worth a look

- Values that were properties of real Britain terrain (probes at Z 10, a pinned plain walk mask of 0xC1) are re-pinned to the synthetic plain (Z 0, 0xFF).
- No tests were deleted. The multi walkability and boat-deck tests assert movement behaviour over a footprint, not what a real multi looks like, so they run on the contrived footprints.
- Maps 0 and 1 keep file indexes 0 and 1, and every stamp writes both, rather than sharing one file index. On a map without files the getters never consult the shared-file cache, and its patch bits would hide one facet's injection from the other.

## Test plan

- [x] `dotnet test -p:SolutionDir=... --filter "Category!=Manual"` with the client env vars pointed at an empty directory: 837 + 1131 passed, 0 skipped, 0 failed
- [x] Mutation check: removing the step-cache clear from `TestTerrain` makes the stale-cache tests fail
- [x] CI green on all platforms
2026-10-18 22:07:40 -07:00

133 lines
4.6 KiB
C#

using Server.Engines.Pathing.Cache;
using Server.Items;
using Server.Mobiles;
using Server.Tests.Terrain;
using Xunit;
using Xunit.Abstractions;
using CalcMoves = Server.Movement.Movement;
namespace Server.Tests.Pathfinding;
[Collection("Sequential Pathfinding Tests")]
public class MultiWalkabilityTests
{
private readonly ITestOutputHelper _output;
public MultiWalkabilityTests(ITestOutputHelper output) => _output = output;
private const int MapId = 1;
private const int PlaceX = 1500;
private const int PlaceY = 1600;
[Fact]
public void WallCell_CannotBeEnteredFromAnyAdjacentCell()
{
StepCache.Instance.Clear();
var map = Map.Maps[MapId];
map.GetAverageZ(PlaceX, PlaceY, out _, out var z, out _);
var multi = new TestMulti(TestMultis.GuildHouse);
multi.MoveToWorld(new Point3D(PlaceX, PlaceY, (sbyte)z), map);
var walker = new WalkerStub();
walker.MoveToWorld(new Point3D(PlaceX, PlaceY, (sbyte)z), map);
try
{
var wall = MultiArt.FindWallCell(multi);
Assert.True(wall.HasValue, "non-vacuity: house MCL must contain a wall tile");
var w = wall.Value;
// From each of the 8 cells surrounding the wall, try stepping in all 8 directions.
// No step may land ON the wall cell. We also require that SOME step succeeds, so a
// "zero wall entries" result reflects the wall blocking — not the walker being
// unable to move here at all (e.g. a Z mismatch blocking everything: a vacuous pass).
var entriesIntoWall = 0;
var successfulSteps = 0;
for (var around = 0; around < 8; around++)
{
var cx = w.X;
var cy = w.Y;
CalcMoves.Offset((Direction)around, ref cx, ref cy);
map.GetAverageZ(cx, cy, out _, out var cz, out _);
var from = new Point3D(cx, cy, (sbyte)cz);
for (var d = 0; d < 8; d++)
{
if (!CalcMoves.CheckMovement(walker, map, from, (Direction)d, out _))
{
continue;
}
successfulSteps++;
var tx = cx;
var ty = cy;
CalcMoves.Offset((Direction)d, ref tx, ref ty);
if (tx == w.X && ty == w.Y)
{
entriesIntoWall++;
_output.WriteLine($"UNEXPECTED entry into wall ({w.X},{w.Y}) from ({cx},{cy}) dir {d}");
}
}
}
Assert.True(successfulSteps > 0, "non-vacuity: walker must be able to move near the wall");
Assert.Equal(0, entriesIntoWall);
}
finally
{
walker.Delete();
multi.Delete();
}
}
[Fact]
public void FloorCell_IsStandable()
{
StepCache.Instance.Clear();
var map = Map.Maps[MapId];
map.GetAverageZ(PlaceX, PlaceY, out _, out var z, out _);
var multi = new TestMulti(TestMultis.GuildHouse);
multi.MoveToWorld(new Point3D(PlaceX, PlaceY, (sbyte)z), map);
var walker = new WalkerStub();
try
{
var floor = MultiArt.FindFloorCell(multi);
Assert.True(floor.HasValue, "non-vacuity: house MCL must contain a floor tile");
var f = floor.Value;
// Stand the walker on a cardinal neighbour of the floor cell and require at least
// one direction that successfully steps onto the floor cell.
var enteredFloor = false;
for (var d = 0; d < 8 && !enteredFloor; d++)
{
var nx = f.X;
var ny = f.Y;
CalcMoves.Offset((Direction)((d + 4) & 7), ref nx, ref ny);
map.GetAverageZ(nx, ny, out _, out var nz, out _);
walker.MoveToWorld(new Point3D(nx, ny, (sbyte)nz), map);
if (CalcMoves.CheckMovement(walker, map, walker.Location, (Direction)d, out _))
{
var tx = nx;
var ty = ny;
CalcMoves.Offset((Direction)d, ref tx, ref ty);
if (tx == f.X && ty == f.Y)
{
enteredFloor = true;
}
}
}
Assert.True(enteredFloor, $"expected the floor cell ({f.X},{f.Y}) to be reachable from a neighbour");
}
finally
{
walker.Delete();
multi.Delete();
}
}
}