feat(runtime): first-entry conductor sequences local-player world entry
Cutover slice C3a: the resumable transaction that dissolves the C3 flip's circularity finding. RuntimeLocalPlayerFirstEntryState drives the local player's complete entry in retail's own order — authored-mover preparation (the makeObject/set_description shape analog, via a pure no-submit extraction TryPrepareAuthoredMover), the publication chain's off-canonical Prepare + atomic body Commit against the residence's exact placement token, the Evaluate/CommitActivation enter-world analog, the Place-receipt acknowledgement as that act's virtualized completion, and only then the executor's FIFO drain (retail: enter_world at 93824 strictly precedes ProcessObjectNetBlobs at 93831). Five stages, eight typed statuses, exactly-once per stage under retry, no second token copies, and an acknowledge-stage discriminator that separates not-yet-FIFO-head (retryable) from authority-moved (typed abandonment) — a mid-flight delete can no longer strand a retry-forever entry. The residence retirement notification becomes an ordered multicast (snapshot-iterated per the event-stream precedent), the lifetime constructs the conductor with a late-bind Publication seam (transactional unbound failure — no mutation before the throw), deletion/reset converge the conductor automatically through the same choke points as the executor, and its active count is in the ownership snapshot and IsConverged. Dormant: no production Advance caller; GameRuntime binding is C3c's first act. Reviewed: retail-conformance PASS (the stage order verified step-for-step against retail's entry sequence; the live-controller-on- abandonment invariant proven structurally enforced and retail-correct — retail has no entry-flow rollback) + architecture/adversarial PASS after one fix round (acknowledge-stage authority discrimination; the wiring fold; two prescribed pre-C3c hardenings). Runtime 948/948; complete Release solution green across all nine projects. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
parent
874d94bf34
commit
960373df2e
6 changed files with 1816 additions and 29 deletions
|
|
@ -2623,6 +2623,53 @@ public sealed class RuntimeInitialCreateResidenceStateTests
|
|||
lifetime.Entities.SetPhysicsBody(canonical, body);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void RetirementNotificationBoundReentrantlyDuringDispatchDoesNotCorruptTheCurrentIteration()
|
||||
{
|
||||
// H1: RuntimeEntityObjectLifetime's own constructor already binds
|
||||
// TWO retirement notifications (the executor's DiscardProgress and
|
||||
// the local-player first-entry conductor's Forget). Before this
|
||||
// fix, NotifyRetirement iterated the live _retirementNotifications
|
||||
// list directly; a THIRD subscriber binding from inside one of
|
||||
// those two (or this test's own) callbacks would throw
|
||||
// "Collection was modified" on the very next notify() call in the
|
||||
// SAME foreach. Snapshotting via ToArray() before iterating must
|
||||
// let a reentrant bind land safely mid-dispatch, with the newly
|
||||
// added subscriber observed on the NEXT retirement, not the current
|
||||
// one (it is not required to see notifications that were already
|
||||
// "in flight" when it bound).
|
||||
using var lifetime = new RuntimeEntityObjectLifetime();
|
||||
Bind(lifetime, 20UL);
|
||||
var lateBoundKeys = new List<RuntimeEntityKey>();
|
||||
bool reentrantBindAttempted = false;
|
||||
lifetime.InitialCreateResidences.BindRetirementNotification(key =>
|
||||
{
|
||||
if (reentrantBindAttempted)
|
||||
return;
|
||||
reentrantBindAttempted = true;
|
||||
lifetime.InitialCreateResidences.BindRetirementNotification(
|
||||
lateBoundKeys.Add);
|
||||
});
|
||||
|
||||
RuntimeEntityRecord first = lifetime.RegisterEntityWithInitialResidence(
|
||||
Spawn(0x70003F80u, 1), isLocalPlayer: false).Canonical!;
|
||||
RuntimeEntityKey firstKey = first.Key!.Value;
|
||||
Exception? thrown = Record.Exception(() =>
|
||||
lifetime.InitialCreateResidences.Forget(first, out _, out _));
|
||||
|
||||
Assert.Null(thrown);
|
||||
Assert.True(reentrantBindAttempted);
|
||||
Assert.DoesNotContain(firstKey, lateBoundKeys);
|
||||
|
||||
RuntimeEntityRecord second = lifetime.RegisterEntityWithInitialResidence(
|
||||
Spawn(0x70003F81u, 1), isLocalPlayer: false).Canonical!;
|
||||
RuntimeEntityKey secondKey = second.Key!.Value;
|
||||
Assert.True(lifetime.InitialCreateResidences.Forget(
|
||||
second, out _, out _));
|
||||
|
||||
Assert.Contains(secondKey, lateBoundKeys);
|
||||
}
|
||||
|
||||
private static void Bind(
|
||||
RuntimeEntityObjectLifetime lifetime,
|
||||
ulong generation)
|
||||
|
|
|
|||
|
|
@ -0,0 +1,922 @@
|
|||
using System.Collections.Immutable;
|
||||
using System.Numerics;
|
||||
using AcDream.Content;
|
||||
using AcDream.Content.Pak;
|
||||
using AcDream.Core.Net;
|
||||
using AcDream.Core.Net.Messages;
|
||||
using AcDream.Core.Physics;
|
||||
using AcDream.Runtime.Entities;
|
||||
using AcDream.Runtime.Gameplay;
|
||||
using AcDream.Runtime.Physics;
|
||||
using AcDream.Runtime;
|
||||
|
||||
namespace AcDream.Runtime.Tests.Gameplay;
|
||||
|
||||
public sealed class RuntimeLocalPlayerFirstEntryStateTests
|
||||
{
|
||||
private const uint Landblock = 0xA9B60000u;
|
||||
private const uint Cell = Landblock | 0x0001u;
|
||||
private const uint SetupId = 0x02000001u;
|
||||
private static readonly RuntimeInitialCreateExecutionInputs NoContact =
|
||||
new(UsePositionFromServer: false, PlayerDistance: 0f);
|
||||
|
||||
// ---------------------------------------------------------------
|
||||
// Happy path
|
||||
// ---------------------------------------------------------------
|
||||
|
||||
[Fact]
|
||||
public void FullSequenceHappyPathReachesExecutorCompletedWithOneBodyIdentity()
|
||||
{
|
||||
using var fixture = new Fixture(residentWorld: true);
|
||||
|
||||
RuntimeLocalPlayerFirstEntryStatus status = fixture.Advance(
|
||||
out RuntimeInitialCreateExecutionReceipt receipt);
|
||||
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.Completed, status);
|
||||
Assert.Equal(Cell, receipt.FullCellId);
|
||||
Assert.Equal(RuntimeTeleportHookPhase.AfterEnterWorld,
|
||||
receipt.TeleportHookPhase);
|
||||
PhysicsBody body = Assert.IsType<PhysicsBody>(fixture.Record.PhysicsBody);
|
||||
Assert.True(body.InWorld);
|
||||
PlayerMovementController controller =
|
||||
Assert.IsType<PlayerMovementController>(fixture.Movement.Controller);
|
||||
Assert.Same(body, controller.PhysicsBody);
|
||||
Assert.True(controller.IsRuntimePublished);
|
||||
Assert.NotNull(fixture.Record.PhysicsHost);
|
||||
Assert.True(fixture.Lifetime.Physics.IsSpatialRoot(fixture.Record));
|
||||
Assert.Equal(0, fixture.Conductor.CaptureOwnership().ActiveCount);
|
||||
Assert.Equal(0, fixture.Publication.CaptureOwnership().CandidateCount);
|
||||
Assert.Equal(0, fixture.Publication.CaptureOwnership().PendingActivationCount);
|
||||
Assert.False(fixture.Lifetime.TryGetInitialCreateResidence(
|
||||
fixture.Record, out _));
|
||||
Assert.Equal(0, fixture.Lifetime.CaptureOwnership()
|
||||
.InitialCreateResidenceLeaseCount);
|
||||
Assert.Equal(0, fixture.Lifetime.CaptureOwnership()
|
||||
.InitialCreateExecutorProgressCount);
|
||||
|
||||
// Retrying with the now-stale residence token is a distinct,
|
||||
// safe no-op — nothing left to resume.
|
||||
Assert.Equal(
|
||||
RuntimeLocalPlayerFirstEntryStatus.RejectedToken,
|
||||
fixture.Advance(out _));
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------
|
||||
// Yield flavors + resume
|
||||
// ---------------------------------------------------------------
|
||||
|
||||
[Fact]
|
||||
public void AwaitingCollisionSourceRetriesThenResumesOnceSetupLands()
|
||||
{
|
||||
using var fixture = new Fixture(residentWorld: true, setupTableId: SetupId);
|
||||
fixture.CollisionSource.Status = PreparedAssetReadStatus.Missing;
|
||||
|
||||
RuntimeLocalPlayerFirstEntryStatus first = fixture.Advance(out _);
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.AwaitingCollisionSource,
|
||||
first);
|
||||
Assert.Equal(0, fixture.Conductor.CaptureOwnership().ActiveCount);
|
||||
Assert.Equal(0, fixture.Publication.CaptureOwnership().CandidateCount);
|
||||
|
||||
RuntimeLocalPlayerFirstEntryStatus second = fixture.Advance(out _);
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.AwaitingCollisionSource,
|
||||
second);
|
||||
Assert.True(fixture.CollisionSource.ReadCount >= 2);
|
||||
|
||||
fixture.CollisionSource.Status = PreparedAssetReadStatus.Loaded;
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.Completed,
|
||||
fixture.Advance(out RuntimeInitialCreateExecutionReceipt receipt));
|
||||
Assert.Equal(Cell, receipt.FullCellId);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void AwaitingActivationRetriesWhileCellUnresolvedThenResumesAfterGenerationWake()
|
||||
{
|
||||
// Non-resident world: EvaluateActivation defers because the
|
||||
// destination landblock's collision generation was never committed.
|
||||
using var fixture = new Fixture(residentWorld: false);
|
||||
|
||||
RuntimeLocalPlayerFirstEntryStatus first = fixture.Advance(out _);
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.AwaitingActivation, first);
|
||||
Assert.Equal(1, fixture.Publication.CaptureOwnership().PendingActivationCount);
|
||||
Assert.False(fixture.Record.PhysicsBody!.InWorld);
|
||||
|
||||
RuntimeLocalPlayerFirstEntryStatus second = fixture.Advance(out _);
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.AwaitingActivation, second);
|
||||
Assert.Equal(1, fixture.Publication.CaptureOwnership().PendingActivationCount);
|
||||
|
||||
const ulong generation = 1UL;
|
||||
fixture.Lifetime.Physics.SetPosition.BeginCollisionGeneration(
|
||||
Cell & 0xFFFF0000u, generation);
|
||||
fixture.Lifetime.Physics.Engine.AddLandblock(
|
||||
Cell & 0xFFFF0000u,
|
||||
new TerrainSurface(new byte[81], new float[256]),
|
||||
Array.Empty<CellSurface>(),
|
||||
Array.Empty<PortalPlane>(),
|
||||
worldOffsetX: 0f,
|
||||
worldOffsetY: 0f);
|
||||
fixture.Lifetime.Physics.SetPosition.CommitCollisionGeneration(
|
||||
Cell & 0xFFFF0000u, generation, ready: true);
|
||||
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.Completed,
|
||||
fixture.Advance(out RuntimeInitialCreateExecutionReceipt receipt));
|
||||
Assert.True(fixture.Record.PhysicsBody!.InWorld);
|
||||
Assert.Equal(Cell, receipt.FullCellId);
|
||||
Assert.Equal(0, fixture.Publication.CaptureOwnership().PendingActivationCount);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void AwaitingReceiptAcknowledgementRetriesWhileNotFifoHeadThenResumes()
|
||||
{
|
||||
using var fixture = new Fixture(residentWorld: true);
|
||||
// Occupy the FIFO head with an unrelated, unacknowledged Place
|
||||
// projection before our own activation ever commits, so our own
|
||||
// token — assigned a LATER sequence — cannot acknowledge first.
|
||||
(RuntimeEntityRecord other, RuntimePlacementProjectionToken otherToken) =
|
||||
BeginPendingOrdinaryPlacement(fixture, 0x70099001u);
|
||||
|
||||
RuntimeLocalPlayerFirstEntryStatus first = fixture.Advance(out _);
|
||||
Assert.Equal(
|
||||
RuntimeLocalPlayerFirstEntryStatus.AwaitingReceiptAcknowledgement,
|
||||
first);
|
||||
// The activation itself already committed — retrying must not
|
||||
// re-run CommitActivation (which would reject a second time and
|
||||
// corrupt the ledger); only the acknowledgement itself is retried.
|
||||
Assert.Equal(0, fixture.Publication.CaptureOwnership().PendingActivationCount);
|
||||
Assert.True(fixture.Record.PhysicsBody!.InWorld);
|
||||
|
||||
RuntimeLocalPlayerFirstEntryStatus second = fixture.Advance(out _);
|
||||
Assert.Equal(
|
||||
RuntimeLocalPlayerFirstEntryStatus.AwaitingReceiptAcknowledgement,
|
||||
second);
|
||||
|
||||
Assert.True(fixture.Lifetime.Physics.SetPosition
|
||||
.AcknowledgeProjection(otherToken));
|
||||
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.Completed,
|
||||
fixture.Advance(out RuntimeInitialCreateExecutionReceipt receipt));
|
||||
Assert.Equal(Cell, receipt.FullCellId);
|
||||
_ = other;
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void DeleteWhileAwaitingReceiptAcknowledgementAbandonsInsteadOfRetryingForeverAndConverges()
|
||||
{
|
||||
// F1 regression: the gap between the two original delete tests (one
|
||||
// before activation ever commits, one after a non-resident
|
||||
// DeferredCell). Here the activation has ALREADY committed — the
|
||||
// projection is captured and real — but acknowledgement is blocked
|
||||
// behind another entity's own unacknowledged Place. A full delete
|
||||
// ALSO retires the residence (TryAcceptDelete's own
|
||||
// ForgetInitialCreateResidence call), which — now that F2 wires this
|
||||
// class's Forget into that same retirement notification — converges
|
||||
// everything automatically before Advance is ever called again;
|
||||
// that path is covered by the delete-while-AwaitingActivation and
|
||||
// reincarnation tests instead. This test exercises the narrower
|
||||
// mechanism directly: Physics.SetPosition.Forget alone (the exact
|
||||
// call TryAcceptDelete itself makes, releasePreparedMover: true)
|
||||
// rewrites the still-pending Place slot straight to Discard with a
|
||||
// bumped revision (CancelCoreDeferred) — invalidating BOTH the
|
||||
// residence's own placement-tracked currency AND the FIFO head's
|
||||
// projection kind/token for this entity. Without
|
||||
// IsAcknowledgementStillPending's re-check on a failed acknowledge,
|
||||
// the cached progress.Projection struct could never match the FIFO
|
||||
// head again and retrying Advance would report
|
||||
// AwaitingReceiptAcknowledgement forever, with Progress/Publication
|
||||
// ownership never converging.
|
||||
using var fixture = new Fixture(residentWorld: true);
|
||||
(RuntimeEntityRecord other, RuntimePlacementProjectionToken otherToken) =
|
||||
BeginPendingOrdinaryPlacement(fixture, 0x70099002u);
|
||||
|
||||
Assert.Equal(
|
||||
RuntimeLocalPlayerFirstEntryStatus.AwaitingReceiptAcknowledgement,
|
||||
fixture.Advance(out _));
|
||||
Assert.Equal(1, fixture.Conductor.CaptureOwnership().ActiveCount);
|
||||
Assert.True(fixture.Record.PhysicsBody!.InWorld);
|
||||
Assert.True(fixture.Lifetime.TryGetInitialCreateResidence(
|
||||
fixture.Record, out _));
|
||||
|
||||
RuntimePlacementCancellationReceipt cancellation = fixture.Lifetime
|
||||
.Physics.SetPosition.Forget(
|
||||
fixture.Record,
|
||||
releasePreparedMover: true);
|
||||
fixture.Lifetime.Physics.SetPosition.PublishCancellation(cancellation);
|
||||
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.RejectedAuthority,
|
||||
fixture.Advance(out _));
|
||||
Assert.Equal(0, fixture.Conductor.CaptureOwnership().ActiveCount);
|
||||
// FinalizeActivation already nulled Publication's own tracked
|
||||
// activation the instant CommitActivation succeeded (the controller
|
||||
// is genuinely live/published from that point on, not an in-progress
|
||||
// candidate) — so PendingActivationCount was already 0 before this
|
||||
// abandonment ran, and stays 0. Abandoning the acknowledgement here
|
||||
// does not retroactively un-publish the now-live controller; that is
|
||||
// ordinary entity teardown's job, not this class's.
|
||||
Assert.Equal(0, fixture.Publication.CaptureOwnership().PendingActivationCount);
|
||||
Assert.NotNull(fixture.Movement.Controller);
|
||||
Assert.True(fixture.Movement.Controller!.IsRuntimePublished);
|
||||
|
||||
// The unrelated entity's own placement is untouched and still
|
||||
// acknowledgeable — this class's abandonment must not have reached
|
||||
// past its own entity's projection.
|
||||
Assert.True(fixture.Lifetime.Physics.SetPosition
|
||||
.AcknowledgeProjection(otherToken));
|
||||
_ = other;
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void AwaitingContinuationPlacementPropagatesExecutorYieldThenResumes()
|
||||
{
|
||||
using var fixture = new Fixture(residentWorld: true);
|
||||
// A fresh Position arrives while the initial residence is still
|
||||
// pending — exactly the scenario the executor's own FIFO exists
|
||||
// for. It is enqueued as a continuation and only classified once
|
||||
// the executor actually drains it.
|
||||
WorldSession.EntityPositionUpdate update = new(
|
||||
fixture.Record.ServerGuid,
|
||||
new CreateObject.ServerPosition(Cell, 40f, 20f, 7f, 1f, 0f, 0f, 0f),
|
||||
Velocity: null,
|
||||
PlacementId: 2,
|
||||
IsGrounded: true,
|
||||
InstanceSequence: 1,
|
||||
PositionSequence: 2,
|
||||
TeleportSequence: 1,
|
||||
ForcePositionSequence: 0);
|
||||
Assert.True(fixture.Lifetime.TryApplyPosition(
|
||||
update,
|
||||
isLocalPlayer: true,
|
||||
forcePositionRotation: null,
|
||||
currentLocalVelocity: null,
|
||||
projectionRequiresTeleportHook: true,
|
||||
acknowledgeProjection: null,
|
||||
out PositionTimestampDisposition disposition,
|
||||
out _,
|
||||
out _));
|
||||
Assert.Equal(PositionTimestampDisposition.Apply, disposition);
|
||||
|
||||
RuntimeLocalPlayerFirstEntryStatus status = fixture.Advance(out _);
|
||||
Assert.Equal(
|
||||
RuntimeLocalPlayerFirstEntryStatus.AwaitingContinuationPlacement,
|
||||
status);
|
||||
// The conductor's OWN sequence (residence -> publication -> Execute)
|
||||
// already reached its terminal Acknowledged stage; its progress
|
||||
// entry is retained (not zero) purely so a retry skips straight to
|
||||
// re-calling Execute rather than restarting mover-prep/publication
|
||||
// from scratch — discarding it here would incorrectly reject a
|
||||
// retry with RejectedAuthority once the original residence lease is
|
||||
// long gone.
|
||||
Assert.Equal(1, fixture.Conductor.CaptureOwnership().ActiveCount);
|
||||
|
||||
RuntimeEntityKey key = fixture.Record.Key!.Value;
|
||||
Assert.True(fixture.Lifetime.InitialCreateExecution
|
||||
.TryGetPendingContinuationPlacement(
|
||||
key, out RuntimeEntityPlacementToken placement));
|
||||
Assert.True(fixture.Lifetime.InitialCreateExecution
|
||||
.TryGetPendingContinuationRoute(
|
||||
key, out RuntimeAuthoritativePositionRoute route));
|
||||
CompleteOrdinaryPlacement(fixture, placement, route);
|
||||
|
||||
RuntimeLocalPlayerFirstEntryStatus resumed = fixture.Advance(
|
||||
out RuntimeInitialCreateExecutionReceipt receipt);
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.Completed, resumed);
|
||||
Assert.Contains(receipt.Trace,
|
||||
a => a.Kind is RuntimeInitialCreateExecutedActionKind.Position);
|
||||
Assert.Equal(0, fixture.Conductor.CaptureOwnership().ActiveCount);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void ReentrantAdvanceDuringCollisionCallbackFailsClosedWithContentionAndOuterCallStillCompletes()
|
||||
{
|
||||
using var fixture = new Fixture(residentWorld: true);
|
||||
bool reentered = false;
|
||||
RuntimeLocalPlayerFirstEntryStatus? innerStatus = null;
|
||||
fixture.Lifetime.Physics.Engine.TransitionCellCollisionTestHook =
|
||||
(_, phase, _, observed) =>
|
||||
{
|
||||
if (!reentered && phase is TransitionCellCollisionPhase.Environment)
|
||||
{
|
||||
reentered = true;
|
||||
innerStatus = fixture.Advance(out _);
|
||||
}
|
||||
return observed;
|
||||
};
|
||||
|
||||
RuntimeLocalPlayerFirstEntryStatus outerStatus = fixture.Advance(
|
||||
out RuntimeInitialCreateExecutionReceipt receipt);
|
||||
|
||||
Assert.True(reentered);
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.Contention, innerStatus);
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.Completed, outerStatus);
|
||||
Assert.Equal(Cell, receipt.FullCellId);
|
||||
Assert.Equal(0, fixture.Conductor.CaptureOwnership().ActiveCount);
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------
|
||||
// Publication binding (H2)
|
||||
// ---------------------------------------------------------------
|
||||
|
||||
[Fact]
|
||||
public void AdvanceWithUnboundPublicationThrowsTransactionallyBeforeAnyStateMutation()
|
||||
{
|
||||
// H2: RuntimeEntityObjectLifetime constructs LocalPlayerFirstEntry
|
||||
// before RuntimeLocalPlayerPhysicsPublicationState can exist, so an
|
||||
// Advance in the window before a host calls BindPublication must
|
||||
// fail with NOTHING mutated — no authored-mover Setup-read/
|
||||
// PrepareMover call against RuntimeSetPositionState's own
|
||||
// _preparedMovers, no Progress entry created. Otherwise a poisoned
|
||||
// Progress entry would sit in _progress forever, and a later
|
||||
// Discard/DiscardAll from an unrelated retirement/session-clear
|
||||
// fan-out would ALSO throw.
|
||||
using var lifetime = new RuntimeEntityObjectLifetime();
|
||||
var generation = new RuntimeGenerationToken(1UL);
|
||||
lifetime.BindEventContext(() => generation, static () => 1UL);
|
||||
RuntimeEntityRecord record = lifetime.RegisterEntityWithInitialResidence(
|
||||
Spawn(0x70090099u, incarnation: 1),
|
||||
isLocalPlayer: true).Canonical!;
|
||||
Assert.True(lifetime.TryGetInitialCreateResidence(
|
||||
record, out RuntimeInitialCreateResidenceLease lease));
|
||||
var collisionSource = new FakeCollisionSource(
|
||||
0u,
|
||||
new FlatSetupCollision(
|
||||
ImmutableArray<FlatCollisionCylinder>.Empty,
|
||||
[new FlatCollisionSphere(Vector3.Zero, 0.48f)],
|
||||
height: 0f,
|
||||
radius: 0f,
|
||||
stepUpHeight: 0.4f,
|
||||
stepDownHeight: 0.4f));
|
||||
|
||||
Assert.Throws<InvalidOperationException>(() =>
|
||||
lifetime.LocalPlayerFirstEntry.Advance(
|
||||
record,
|
||||
lease.Token,
|
||||
PlayerMovementConstructionOptions.Fallback,
|
||||
new RuntimeLocalPlayerPhysicsActivationPreparation(
|
||||
0.48f, 1.835f, RuntimeLocalPlayerShadowDisposition.ProvenShapeless),
|
||||
collisionSource,
|
||||
gameTime: 10d,
|
||||
NoContact,
|
||||
out _));
|
||||
|
||||
Assert.Equal(0, lifetime.LocalPlayerFirstEntry.CaptureOwnership().ActiveCount);
|
||||
// The residence lease is untouched — the SAME token still drives to
|
||||
// completion once a host binds Publication, proving nothing was
|
||||
// mutated by the failed attempt.
|
||||
Assert.True(lifetime.TryGetInitialCreateResidence(
|
||||
record, out RuntimeInitialCreateResidenceLease stillLease));
|
||||
Assert.Equal(lease.Token, stillLease.Token);
|
||||
|
||||
var movement = new RuntimeLocalPlayerMovementState();
|
||||
var identity = new RuntimeLocalPlayerIdentityState();
|
||||
try
|
||||
{
|
||||
identity.ServerGuid = record.ServerGuid;
|
||||
var publication = new RuntimeLocalPlayerPhysicsPublicationState(
|
||||
lifetime.Entities, lifetime.Physics, movement, identity);
|
||||
movement.AttachPhysicsPublication(publication);
|
||||
lifetime.LocalPlayerFirstEntry.BindPublication(publication);
|
||||
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.AwaitingActivation,
|
||||
lifetime.LocalPlayerFirstEntry.Advance(
|
||||
record,
|
||||
lease.Token,
|
||||
PlayerMovementConstructionOptions.Fallback,
|
||||
new RuntimeLocalPlayerPhysicsActivationPreparation(
|
||||
0.48f, 1.835f, RuntimeLocalPlayerShadowDisposition.ProvenShapeless),
|
||||
collisionSource,
|
||||
gameTime: 10d,
|
||||
NoContact,
|
||||
out _));
|
||||
}
|
||||
finally
|
||||
{
|
||||
// F2 disposal-ordering constraint: Lifetime's own Dispose runs
|
||||
// BeginSessionClear -> LocalPlayerFirstEntry.DiscardAll, which
|
||||
// needs Publication still alive.
|
||||
lifetime.Dispose();
|
||||
movement.Dispose();
|
||||
identity.Dispose();
|
||||
}
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void BindPublicationTwiceThrows()
|
||||
{
|
||||
using var fixture = new Fixture(residentWorld: false);
|
||||
Assert.Throws<InvalidOperationException>(
|
||||
() => fixture.Conductor.BindPublication(fixture.Publication));
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------
|
||||
// Retry idempotency
|
||||
// ---------------------------------------------------------------
|
||||
|
||||
[Fact]
|
||||
public void RetryAtMoverPreparationNeverCreatesAPublicationCandidate()
|
||||
{
|
||||
using var fixture = new Fixture(residentWorld: true, setupTableId: SetupId);
|
||||
fixture.CollisionSource.Status = PreparedAssetReadStatus.Missing;
|
||||
|
||||
for (int i = 0; i < 3; i++)
|
||||
{
|
||||
Assert.Equal(
|
||||
RuntimeLocalPlayerFirstEntryStatus.AwaitingCollisionSource,
|
||||
fixture.Advance(out _));
|
||||
Assert.Equal(0, fixture.Publication.CaptureOwnership().CandidateCount);
|
||||
Assert.Null(fixture.Record.PhysicsBody);
|
||||
Assert.Null(fixture.Movement.Controller);
|
||||
}
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void RetryAtAwaitingActivationNeverRecommitsPublicationOrDuplicatesTheBody()
|
||||
{
|
||||
using var fixture = new Fixture(residentWorld: false);
|
||||
PhysicsBody? body = null;
|
||||
|
||||
for (int i = 0; i < 3; i++)
|
||||
{
|
||||
Assert.Equal(
|
||||
RuntimeLocalPlayerFirstEntryStatus.AwaitingActivation,
|
||||
fixture.Advance(out _));
|
||||
Assert.Equal(0, fixture.Publication.CaptureOwnership().CandidateCount);
|
||||
Assert.Equal(1, fixture.Publication.CaptureOwnership().PendingActivationCount);
|
||||
body ??= fixture.Record.PhysicsBody;
|
||||
Assert.Same(body, fixture.Record.PhysicsBody);
|
||||
Assert.Same(fixture.Movement.Controller, fixture.Movement.Controller);
|
||||
}
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------
|
||||
// Abandonment + converged ledgers
|
||||
// ---------------------------------------------------------------
|
||||
|
||||
[Fact]
|
||||
public void DeleteMidFlightDuringActivationAbandonsWithoutShadowOrPlaceAndConverges()
|
||||
{
|
||||
// Mirrors the publication suite's own
|
||||
// CollisionCallbackDeleteRetiresPrephaseWithoutShadowOrPlace: the
|
||||
// delete lands DURING the same Advance call (from inside
|
||||
// CommitActivation's collision dispatch), not across a retry
|
||||
// boundary — the only place a genuine mid-flight abandonment (as
|
||||
// opposed to a stale-lease retry) can be exercised for this fused
|
||||
// Prepare->Commit->Evaluate->CommitActivation sequence.
|
||||
using var fixture = new Fixture(residentWorld: true);
|
||||
bool deleted = false;
|
||||
var placements = new List<RuntimePlacementDelta>();
|
||||
using IDisposable placementSubscription = fixture.Lifetime.Events
|
||||
.SubscribePlacement(new PlacementObserver(d => placements.Add(d)));
|
||||
fixture.Lifetime.Physics.Engine.TransitionCellCollisionTestHook =
|
||||
(transition, phase, _, observed) =>
|
||||
{
|
||||
if (deleted || phase is not TransitionCellCollisionPhase.Environment)
|
||||
return observed;
|
||||
deleted = true;
|
||||
DeleteEntity(fixture);
|
||||
return observed;
|
||||
};
|
||||
|
||||
RuntimeLocalPlayerFirstEntryStatus status = fixture.Advance(out _);
|
||||
|
||||
Assert.True(deleted);
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.RejectedAuthority, status);
|
||||
Assert.DoesNotContain(placements,
|
||||
d => d.Placement.Kind is RuntimePlacementProjectionKind.Place);
|
||||
Assert.Equal(0, fixture.Conductor.CaptureOwnership().ActiveCount);
|
||||
Assert.Equal(0, fixture.Publication.CaptureOwnership().CandidateCount);
|
||||
Assert.Equal(0, fixture.Publication.CaptureOwnership().PendingActivationCount);
|
||||
Assert.Null(fixture.Movement.Controller);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void DeleteWhileAwaitingActivationConvergesAutomaticallyThroughTheRetirementFanOut()
|
||||
{
|
||||
// RuntimeEntityRecord.Key is computed from LocalEntityId and goes
|
||||
// null the instant ReleaseLocalId runs (part of delete's teardown,
|
||||
// RuntimeEntityObjectLifetime.CompleteProjectionRetirement) — so a
|
||||
// SUBSEQUENT Advance call can never recompute the dictionary key to
|
||||
// reach its own stale progress (RejectedToken, mirroring the
|
||||
// executor's own convention for "nothing addressable here" — same
|
||||
// as calling Execute with a record whose Key just went null). F2:
|
||||
// this no longer matters for cleanup, because TryAcceptDelete's own
|
||||
// ForgetInitialCreateResidence call fires the residence's multicast
|
||||
// retirement notification SYNCHRONOUSLY, DURING delete itself —
|
||||
// RuntimeEntityObjectLifetime binds this class's Forget into that
|
||||
// SAME fan-out (alongside the executor's DiscardProgress), using the
|
||||
// exact key the notification carries, never one re-derived from
|
||||
// record.Key. Convergence is therefore already complete by the time
|
||||
// delete returns, with no separate host Forget call needed.
|
||||
using var fixture = new Fixture(residentWorld: false);
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.AwaitingActivation,
|
||||
fixture.Advance(out _));
|
||||
Assert.Equal(1, fixture.Publication.CaptureOwnership().PendingActivationCount);
|
||||
|
||||
DeleteEntity(fixture);
|
||||
Assert.Null(fixture.Record.Key);
|
||||
|
||||
Assert.Equal(0, fixture.Conductor.CaptureOwnership().ActiveCount);
|
||||
Assert.Equal(0, fixture.Publication.CaptureOwnership().PendingActivationCount);
|
||||
Assert.Null(fixture.Movement.Controller);
|
||||
|
||||
// Retrying Advance afterward is a safe, distinct no-op.
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.RejectedToken,
|
||||
fixture.Advance(out _));
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void MovementResetSessionMidFlightConvergesOwnershipThroughOrdinaryAdvance()
|
||||
{
|
||||
// Unlike delete, ResetSession does not touch RuntimeEntityRecord.Key
|
||||
// at all — it only clears RuntimeLocalPlayerPhysicsPublicationState's
|
||||
// own candidate/activation directly. So a plain retry of Advance (no
|
||||
// captured-key Forget needed) reaches EvaluateActivation, which
|
||||
// reports RejectedToken because _activation is now null outright
|
||||
// (its own "nothing here" status, not "found but stale") — and this
|
||||
// class's Discard(key) still runs on that path, converging ownership
|
||||
// through ordinary retry alone.
|
||||
using var fixture = new Fixture(residentWorld: false);
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.AwaitingActivation,
|
||||
fixture.Advance(out _));
|
||||
|
||||
fixture.Movement.ResetSession();
|
||||
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.RejectedToken,
|
||||
fixture.Advance(out _));
|
||||
Assert.Equal(0, fixture.Conductor.CaptureOwnership().ActiveCount);
|
||||
Assert.Equal(0, fixture.Publication.CaptureOwnership().PendingActivationCount);
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------
|
||||
// GUID / LeaseId staleness
|
||||
// ---------------------------------------------------------------
|
||||
|
||||
[Fact]
|
||||
public void DeleteAndSameGuidReincarnationAutomaticallyFreesThePublicationSlotForTheFreshIncarnation()
|
||||
{
|
||||
// Delete releases the old LocalEntityId (ReleaseLocalId), so a
|
||||
// reincarnation's RuntimeEntityKey structurally differs from the
|
||||
// deleted one — the orphaned incarnation-1 progress entry can never
|
||||
// collide with the fresh incarnation-2 dictionary slot. Separately,
|
||||
// RuntimeLocalPlayerPhysicsPublicationState holds exactly ONE
|
||||
// dormant candidate/activation globally (there is only ever one
|
||||
// local player), so the fresh incarnation's own Prepare would be
|
||||
// structurally rejected (CanPrepare requires the slot empty) for as
|
||||
// long as the orphaned incarnation-1 activation still occupied it.
|
||||
// F2: TryAcceptDelete's own ForgetInitialCreateResidence call fires
|
||||
// the residence's multicast retirement notification synchronously,
|
||||
// DURING delete — RuntimeEntityObjectLifetime binds this class's
|
||||
// Forget into that SAME fan-out, so the stale activation is already
|
||||
// discarded by the time delete returns. No separate host Forget is
|
||||
// needed for the fresh incarnation to proceed immediately.
|
||||
using var fixture = new Fixture(residentWorld: false);
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.AwaitingActivation,
|
||||
fixture.Advance(out _));
|
||||
RuntimeEntityKey staleKey = fixture.Record.Key!.Value;
|
||||
Assert.Equal(1, fixture.Conductor.CaptureOwnership().ActiveCount);
|
||||
Assert.Equal(1, fixture.Publication.CaptureOwnership().PendingActivationCount);
|
||||
|
||||
uint guid = fixture.Record.ServerGuid;
|
||||
DeleteEntity(fixture);
|
||||
Assert.Equal(0, fixture.Conductor.CaptureOwnership().ActiveCount);
|
||||
Assert.Equal(0, fixture.Publication.CaptureOwnership().PendingActivationCount);
|
||||
RuntimeEntityRecord reincarnated = fixture.Lifetime
|
||||
.RegisterEntityWithInitialResidence(
|
||||
Spawn(guid, incarnation: 2),
|
||||
isLocalPlayer: true)
|
||||
.Canonical!;
|
||||
// ReleaseLocalId (part of delete's teardown) returns the old
|
||||
// LocalEntityId to the free pool rather than pinning it per GUID, so
|
||||
// the reincarnation's key differs in BOTH fields, not just
|
||||
// Incarnation — either way it is a different _progress dictionary
|
||||
// key than the deleted incarnation's.
|
||||
Assert.NotEqual(staleKey, reincarnated.Key!.Value);
|
||||
fixture.Identity.ServerGuid = reincarnated.ServerGuid;
|
||||
Assert.True(fixture.Lifetime.TryGetInitialCreateResidence(
|
||||
reincarnated,
|
||||
out RuntimeInitialCreateResidenceLease freshLease));
|
||||
fixture.Record = reincarnated;
|
||||
fixture.Lease = freshLease;
|
||||
|
||||
// The fresh incarnation's own publication Prepare succeeds
|
||||
// immediately — the one global slot was already freed by delete's
|
||||
// automatic convergence above, with no explicit Forget call in
|
||||
// between. The fixture's non-resident world defers the fresh
|
||||
// incarnation's own activation once — wake it the same way the
|
||||
// AwaitingActivation retry test does.
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.AwaitingActivation,
|
||||
fixture.Advance(out _));
|
||||
const ulong generation = 1UL;
|
||||
fixture.Lifetime.Physics.SetPosition.BeginCollisionGeneration(
|
||||
Cell & 0xFFFF0000u, generation);
|
||||
fixture.Lifetime.Physics.Engine.AddLandblock(
|
||||
Cell & 0xFFFF0000u,
|
||||
new TerrainSurface(new byte[81], new float[256]),
|
||||
Array.Empty<CellSurface>(),
|
||||
Array.Empty<PortalPlane>(),
|
||||
worldOffsetX: 0f,
|
||||
worldOffsetY: 0f);
|
||||
fixture.Lifetime.Physics.SetPosition.CommitCollisionGeneration(
|
||||
Cell & 0xFFFF0000u, generation, ready: true);
|
||||
|
||||
RuntimeLocalPlayerFirstEntryStatus status = fixture.Advance(
|
||||
out RuntimeInitialCreateExecutionReceipt receipt);
|
||||
Assert.Equal(RuntimeLocalPlayerFirstEntryStatus.Completed, status);
|
||||
Assert.Equal(Cell, receipt.FullCellId);
|
||||
Assert.Same(reincarnated, fixture.Record);
|
||||
Assert.Equal(reincarnated.Key!.Value.LocalEntityId,
|
||||
fixture.Movement.Controller!.LocalEntityId);
|
||||
Assert.Same(reincarnated.PhysicsBody, fixture.Movement.Controller.PhysicsBody);
|
||||
Assert.Equal(0, fixture.Conductor.CaptureOwnership().ActiveCount);
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------
|
||||
// Helpers
|
||||
// ---------------------------------------------------------------
|
||||
|
||||
private static (RuntimeEntityRecord Record, RuntimePlacementProjectionToken Token)
|
||||
BeginPendingOrdinaryPlacement(Fixture fixture, uint guid)
|
||||
{
|
||||
RuntimeEntityRecord record = fixture.Lifetime.RegisterEntity(
|
||||
Spawn(guid, incarnation: 1, includePosition: true)).Canonical!;
|
||||
var body = new PhysicsBody
|
||||
{
|
||||
Position = new Vector3(50f, 50f, 3f),
|
||||
Orientation = Quaternion.Identity,
|
||||
State = record.FinalPhysicsState,
|
||||
};
|
||||
body.SnapToCell(Cell, body.Position, body.Position);
|
||||
fixture.Lifetime.Entities.SetPhysicsBody(record, body);
|
||||
RuntimeEntityPlacementToken placement = fixture.Lifetime.Physics
|
||||
.SetPosition.BeginAuthoredPlacement(
|
||||
record,
|
||||
record.PositionAuthorityVersion,
|
||||
RuntimeSetPositionOperationKind.RemoteAuthoritative);
|
||||
Assert.True(placement.IsValid);
|
||||
var preparation = new RuntimeSetPositionMoverPreparation(
|
||||
RuntimeSetPositionMoverSetup.ResolvedAbsent,
|
||||
RuntimeSetPositionOperationKind.RemoteAuthoritative,
|
||||
GameTime: 1d,
|
||||
PhysicsPlacementClass.Ordinary,
|
||||
PhysicsSetPositionFlags.Placement | PhysicsSetPositionFlags.Slide);
|
||||
Assert.Equal(RuntimeSetPositionMoverPreparationStatus.Prepared,
|
||||
fixture.Lifetime.Physics.SetPosition.PrepareMover(
|
||||
placement, preparation, out RuntimeSetPositionCommand command));
|
||||
RuntimeSetPositionOutcome outcome = fixture.Lifetime.Physics.SetPosition
|
||||
.SubmitPreparedPlacement(placement, command);
|
||||
Assert.Equal(RuntimeSetPositionStatus.CommittedHostAcknowledgementPending,
|
||||
outcome.Status);
|
||||
return (record, outcome.Projection);
|
||||
}
|
||||
|
||||
private static void CompleteOrdinaryPlacement(
|
||||
Fixture fixture,
|
||||
in RuntimeEntityPlacementToken placement,
|
||||
in RuntimeAuthoritativePositionRoute route)
|
||||
{
|
||||
var preparation = new RuntimeSetPositionMoverPreparation(
|
||||
RuntimeSetPositionMoverSetup.ResolvedAbsent,
|
||||
route.OperationKind,
|
||||
GameTime: 1d,
|
||||
PhysicsPlacementClass.Ordinary,
|
||||
route.SetPositionFlags);
|
||||
Assert.Equal(RuntimeSetPositionMoverPreparationStatus.Prepared,
|
||||
fixture.Lifetime.Physics.SetPosition.PrepareMover(
|
||||
placement, preparation, out RuntimeSetPositionCommand command));
|
||||
RuntimeSetPositionOutcome outcome = fixture.Lifetime.Physics.SetPosition
|
||||
.SubmitPreparedPlacement(placement, command);
|
||||
Assert.Equal(RuntimeSetPositionStatus.CommittedHostAcknowledgementPending,
|
||||
outcome.Status);
|
||||
Assert.True(fixture.Lifetime.Physics.SetPosition
|
||||
.AcknowledgeProjection(outcome.Projection));
|
||||
}
|
||||
|
||||
private static void DeleteEntity(Fixture fixture)
|
||||
{
|
||||
Assert.True(fixture.Lifetime.TryAcceptDelete(
|
||||
new DeleteObject.Parsed(fixture.Record.ServerGuid, fixture.Record.Incarnation),
|
||||
isLocalPlayer: false,
|
||||
removeRetainedObject: false,
|
||||
out RuntimeEntityDeleteAcceptance acceptance));
|
||||
fixture.Lifetime.CompleteAcceptedDelete(acceptance);
|
||||
Assert.Null(fixture.Lifetime.RetireCanonicalOnly(fixture.Record));
|
||||
}
|
||||
|
||||
private static WorldSession.EntitySpawn Spawn(
|
||||
uint guid,
|
||||
ushort incarnation,
|
||||
bool includePosition = true,
|
||||
uint setupTableId = 0u)
|
||||
{
|
||||
CreateObject.ServerPosition? position = includePosition
|
||||
? new CreateObject.ServerPosition(Cell, 1f, 2f, 3f, 1f, 0f, 0f, 0f)
|
||||
: null;
|
||||
var timestamps = new PhysicsTimestamps(
|
||||
Position: 1,
|
||||
Movement: 1,
|
||||
State: 1,
|
||||
Vector: 1,
|
||||
Teleport: 0,
|
||||
ServerControlledMove: 1,
|
||||
ForcePosition: 0,
|
||||
ObjDesc: 1,
|
||||
Instance: incarnation);
|
||||
var physics = new PhysicsSpawnData(
|
||||
RawState: (uint)(PhysicsStateFlags.Gravity
|
||||
| PhysicsStateFlags.ReportCollisions),
|
||||
Position: position,
|
||||
Movement: null,
|
||||
AnimationFrame: null,
|
||||
SetupTableId: setupTableId == 0u ? null : setupTableId,
|
||||
MotionTableId: 0x09000001u,
|
||||
SoundTableId: null,
|
||||
PhysicsScriptTableId: null,
|
||||
Parent: null,
|
||||
Children: null,
|
||||
Scale: 1f,
|
||||
Friction: null,
|
||||
Elasticity: null,
|
||||
Translucency: null,
|
||||
Velocity: null,
|
||||
Acceleration: null,
|
||||
AngularVelocity: null,
|
||||
DefaultScriptType: null,
|
||||
DefaultScriptIntensity: null,
|
||||
Timestamps: timestamps);
|
||||
return new WorldSession.EntitySpawn(
|
||||
Guid: guid,
|
||||
Position: position,
|
||||
SetupTableId: setupTableId == 0u ? null : setupTableId,
|
||||
AnimPartChanges: Array.Empty<CreateObject.AnimPartChange>(),
|
||||
TextureChanges: Array.Empty<CreateObject.TextureChange>(),
|
||||
SubPalettes: Array.Empty<CreateObject.SubPaletteSwap>(),
|
||||
BasePaletteId: null,
|
||||
ObjScale: 1f,
|
||||
Name: "first-entry-fixture",
|
||||
ItemType: null,
|
||||
MotionState: null,
|
||||
MotionTableId: 0x09000001u,
|
||||
PhysicsState: physics.RawState,
|
||||
ObjectDescriptionFlags: 0x8u,
|
||||
Friction: null,
|
||||
Elasticity: null,
|
||||
InstanceSequence: incarnation,
|
||||
MovementSequence: 1,
|
||||
ServerControlSequence: 1,
|
||||
PositionSequence: 1,
|
||||
Physics: physics);
|
||||
}
|
||||
|
||||
private sealed class PlacementObserver(Action<RuntimePlacementDelta> onPlacement)
|
||||
: IRuntimePlacementObserver
|
||||
{
|
||||
public void OnPlacement(in RuntimePlacementDelta delta) => onPlacement(delta);
|
||||
}
|
||||
|
||||
private sealed class FakeCollisionSource(
|
||||
uint expectedSetupTableId,
|
||||
FlatSetupCollision setup) : IPreparedCollisionSource
|
||||
{
|
||||
internal int ReadCount { get; private set; }
|
||||
internal PreparedAssetReadStatus Status { get; set; } =
|
||||
PreparedAssetReadStatus.Loaded;
|
||||
|
||||
public PreparedAssetPresence ProbeCollision(
|
||||
PakAssetType type, uint sourceFileId) =>
|
||||
PreparedAssetPresence.Available;
|
||||
|
||||
public PreparedCollisionReadResult<FlatSetupCollision> ReadSetupCollision(
|
||||
uint sourceFileId,
|
||||
CancellationToken cancellationToken = default)
|
||||
{
|
||||
ReadCount++;
|
||||
Assert.Equal(expectedSetupTableId, sourceFileId);
|
||||
return Status switch
|
||||
{
|
||||
PreparedAssetReadStatus.Loaded =>
|
||||
PreparedCollisionReadResult<FlatSetupCollision>.Loaded(setup),
|
||||
PreparedAssetReadStatus.Corrupt =>
|
||||
PreparedCollisionReadResult<FlatSetupCollision>.Corrupt,
|
||||
_ => PreparedCollisionReadResult<FlatSetupCollision>.Missing,
|
||||
};
|
||||
}
|
||||
|
||||
public PreparedCollisionReadResult<FlatGfxObjCollisionAsset>
|
||||
ReadGfxObjCollision(
|
||||
uint sourceFileId,
|
||||
CancellationToken cancellationToken = default) =>
|
||||
throw new NotSupportedException(
|
||||
"Only ReadSetupCollision is exercised by these tests.");
|
||||
|
||||
public PreparedCollisionReadResult<FlatCellStructureCollisionAsset>
|
||||
ReadCellStructureCollision(
|
||||
uint sourceFileId,
|
||||
CancellationToken cancellationToken = default) =>
|
||||
throw new NotSupportedException(
|
||||
"Only ReadSetupCollision is exercised by these tests.");
|
||||
|
||||
public PreparedCollisionReadResult<FlatEnvCellTopology>
|
||||
ReadEnvCellTopology(
|
||||
uint sourceFileId,
|
||||
CancellationToken cancellationToken = default) =>
|
||||
throw new NotSupportedException(
|
||||
"Only ReadSetupCollision is exercised by these tests.");
|
||||
|
||||
public PreparedCollisionSourceStats CollisionStats => default;
|
||||
|
||||
public void Dispose()
|
||||
{
|
||||
}
|
||||
}
|
||||
|
||||
private sealed class Fixture : IDisposable
|
||||
{
|
||||
internal Fixture(bool residentWorld, uint setupTableId = 0u)
|
||||
{
|
||||
if (residentWorld)
|
||||
{
|
||||
var engine = new PhysicsEngine { DataCache = new PhysicsDataCache() };
|
||||
engine.AddLandblock(
|
||||
Cell & 0xFFFF0000u,
|
||||
new TerrainSurface(new byte[81], new float[256]),
|
||||
Array.Empty<CellSurface>(),
|
||||
Array.Empty<PortalPlane>(),
|
||||
worldOffsetX: 0f,
|
||||
worldOffsetY: 0f);
|
||||
Lifetime = new RuntimeEntityObjectLifetime(engine);
|
||||
}
|
||||
else
|
||||
{
|
||||
Lifetime = new RuntimeEntityObjectLifetime();
|
||||
}
|
||||
var generation = new RuntimeGenerationToken(1UL);
|
||||
Lifetime.BindEventContext(() => generation, static () => 1UL);
|
||||
|
||||
Movement = new RuntimeLocalPlayerMovementState();
|
||||
Identity = new RuntimeLocalPlayerIdentityState();
|
||||
Publication = new RuntimeLocalPlayerPhysicsPublicationState(
|
||||
Lifetime.Entities, Lifetime.Physics, Movement, Identity);
|
||||
Movement.AttachPhysicsPublication(Publication);
|
||||
// F2: use the SAME conductor instance RuntimeEntityObjectLifetime
|
||||
// itself constructs and wires into the residence's multicast
|
||||
// retirement fan-out and BeginSessionClear — not a separate,
|
||||
// standalone instance — so these tests exercise the real
|
||||
// production wiring (automatic convergence on delete/reset/
|
||||
// session-clear), not a parallel copy of it.
|
||||
Conductor = Lifetime.LocalPlayerFirstEntry;
|
||||
Conductor.BindPublication(Publication);
|
||||
|
||||
Record = Lifetime.RegisterEntityWithInitialResidence(
|
||||
Spawn(0x70090001u, incarnation: 1, setupTableId: setupTableId),
|
||||
isLocalPlayer: true).Canonical!;
|
||||
Identity.ServerGuid = Record.ServerGuid;
|
||||
Assert.True(Lifetime.TryGetInitialCreateResidence(
|
||||
Record, out RuntimeInitialCreateResidenceLease lease));
|
||||
Lease = lease;
|
||||
|
||||
CollisionSource = new FakeCollisionSource(
|
||||
setupTableId,
|
||||
new FlatSetupCollision(
|
||||
ImmutableArray<FlatCollisionCylinder>.Empty,
|
||||
[new FlatCollisionSphere(Vector3.Zero, 0.48f)],
|
||||
height: 0f,
|
||||
radius: 0f,
|
||||
stepUpHeight: 0.4f,
|
||||
stepDownHeight: 0.4f));
|
||||
}
|
||||
|
||||
internal RuntimeEntityObjectLifetime Lifetime { get; }
|
||||
internal RuntimeLocalPlayerMovementState Movement { get; }
|
||||
internal RuntimeLocalPlayerIdentityState Identity { get; }
|
||||
internal RuntimeLocalPlayerPhysicsPublicationState Publication { get; }
|
||||
internal RuntimeLocalPlayerFirstEntryState Conductor { get; }
|
||||
internal RuntimeEntityRecord Record { get; set; }
|
||||
internal RuntimeInitialCreateResidenceLease Lease { get; set; }
|
||||
internal FakeCollisionSource CollisionSource { get; }
|
||||
|
||||
internal RuntimeLocalPlayerFirstEntryStatus Advance(
|
||||
out RuntimeInitialCreateExecutionReceipt receipt) =>
|
||||
Conductor.Advance(
|
||||
Record,
|
||||
Lease.Token,
|
||||
PlayerMovementConstructionOptions.Fallback,
|
||||
new RuntimeLocalPlayerPhysicsActivationPreparation(
|
||||
Radius: 0.48f,
|
||||
Height: 1.835f,
|
||||
RuntimeLocalPlayerShadowDisposition.ProvenShapeless),
|
||||
CollisionSource,
|
||||
gameTime: 10d,
|
||||
NoContact,
|
||||
out receipt);
|
||||
|
||||
public void Dispose()
|
||||
{
|
||||
// F2: RuntimeEntityObjectLifetime's own Dispose runs
|
||||
// BeginSessionClear, which now reaches
|
||||
// LocalPlayerFirstEntry.DiscardAll() -> Publication.Discard for
|
||||
// any still-tracked entity — Publication must still be alive for
|
||||
// that. Lifetime must therefore be disposed BEFORE Movement
|
||||
// (whose Dispose tears down Publication), never after.
|
||||
Lifetime.Dispose();
|
||||
Movement.Dispose();
|
||||
Identity.Dispose();
|
||||
}
|
||||
}
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue