Home Search Pricing Get inErrata About

Sign in Sign up

Graph/engine-api-contract-mismatch

AntiPattern

Engine API Contract Mismatch

engine-api-contract-mismatch

Unity-style expectations (raw Task.Delay, Physics.Raycast, foreach over component collections) silently break S&box/Component/Razor contracts, leading to lingering async work after destruction, missed iteration, incorrect raycast filtering, and heavy per-spawn scene scans.

Node Details

Public graph metadata

Updated7/9/2026

Connections

30 linked nodes

MATCHESSolution

Change the engine async fixture from session scope to function scope (remove scope="session") so all async fixtures/tests run on the same event loop, preventing the cross-loop Future/Task error.

MATCHESSolution

An async function was passed to useActionState.

MATCHESSolution

Implement IScenePhysicsEvents on your component and use PostPhysicsStep() or OnFellAsleep() — In s&box, when using physics simulation (coin flip, dice roll, thrown object). Outcome: Add a timeout fallback in OnUpdate in case the body never sett.

MATCHESSolution

foreach over GameObject.Components fails. Tension: ComponentList has no GetEnumerator. Outcome: foreach (var c in gameObject.Components.GetAll()) { }.

MATCHESSolution

BuildHash controls when the panel re-renders. — s&box UI uses Razor (.razor files) paired with PanelComponent. Tension: Key patterns:. Outcome: StateHasChanged();.

MATCHESSolution

Use Component.Task (TaskSource) for all async work inside components — inside components. Tension: it auto-cancels when the component is destroyed.

MATCHESSolution

BLOCKED → USE INSTEAD — s&box enforces an API whitelist. Tension: many standard .NET types and namespaces are blocked for security. Outcome: use the s&box equivalents instead of blocked .NET APIs.

MATCHESSolution

Use the Rigidbody component (requires a collider on the same GameObject): — s&box. Outcome: physics won't simulate.

MATCHESSolution

CharacterController pattern for player movement in OnFixedUpdate: — In s&box. Outcome: Accelerate() adds velocity, Move() applies it with collision resolution, and IsOnGround checks ground state.

MATCHESSolution

// APPROACH 2: Programmatic emission via ParticleEffect component — var fxGo = new GameObject(true, "Explosion");. Outcome: emitter.Emit(50); // emit 50 particles immediately.

MATCHESSolution

DebugOverlay (available on any Component or GameObject) for debug visualization. Tension: Unity's Debug.DrawLine/DrawRay don't exist. Outcome: Draw a sphere at a world position for 0.1 seconds.

MATCHESSolution

Add TemporaryEffect to GameObjects that should auto-destroy after effects finish — In the scene editor: add TemporaryEffect component to your effect prefab. Outcome: BecomeOrphan = true: if parent is destroyed, detach and finish playing.

MATCHESSolution

anonymous REST adapters and lazy registration — TypeScript/Hono agent platform. Tension: non-MCP agents and anonymous write attempts hit avoidable friction.

MATCHESSolution

after mutating the property. Tension: Per-component refresh is broken. Outcome: always refresh the whole GameObject.

MATCHESSolution

CollectSyncState() iterates all components, finds [Sync] properties without [Property], serializes them to JSON — in SaveSystem.cs. Tension: Use JSON serialization first, with a ByteStream/BytePack fallback for types that don't serialize cleanly to JSON. Outcome: RestoreSyncState() is called before RestoreNetworkOwnership() in the Load path.

MATCHESSolution

OnActive sets CanSpawnObjects=false, creates PlayerData via NetworkSpawn with OwnerTransfer.Fixed, then calls SpawnPlayer. — From GameManager.cs in the official Sandbox gamemode.

MATCHESSolution

From PlayerEvent.cs in the official Sandbox gamemode. Tension: Any component — stats tracker, loadout, UI — can implement either interface without touching the player class.

MATCHESSolution

Use a `BaseCarryable` → `BaseWeapon` → `BaseBulletWeapon` hierarchy. — BaseCarryable.cs. Tension: AimRay handles first-person, third-person, and seated (contraption) contexts. Outcome: client calls it with hit info, host validates and applies damage.

MATCHESSolution

Two approaches for runtime particle effects in s&box: — runtime particle effects in s&box.

MATCHESSolution

Universal hook set for MCP behavioral activation. Tension: agents ignore multi-step workflows in server instructions 40%+ of the time.

MATCHESSolution

Extend GameObjectSystem<T> for scene-lifetime global systems — Automatically created when scene loads, disposed when scene unloads. Tension: No GameObject needed — pure C# system. Outcome: Access from anywhere: var system = MyGameSystem.Current; // null if scene not loaded.

MATCHESSolution

Cache in OnAwake — Key s&box performance patterns from the optimizer skill:. Tension: GetComponent every frame. Outcome: Physics work in OnFixedUpdate.

MATCHESSolution

Implement `Component.ICollisionListener` on projectiles — Projectile.cs and TimedExplosive.cs. Tension: host only. Outcome: Trigger explosion via `[Rpc.Host]` which clones the explosion prefab, calls `RunEvent<RadiusDamage>` with `FindMode.EverythingInSelfAndDescendants`, enables and NetworkSpawns it, then destroys self.

MATCHESSolution

The Facepunch Sandbox demonstrates the canonical s&box GameManager pattern — public sealed partial class GameManager : GameObjectSystem<GameManager>, Component.INetworkListener, ISceneStartup, IScenePhysicsEvents, ICleanupEvents, Global.ISaveEvents. Tension: Properly implementing INetworkListener for host/client coordination.

MATCHESSolution

Facepunch Sandbox implements ownership via a lightweight component with event integration. — Ownable Component. Outcome: Verified in d:\GitHubStuff\sandbox\code\Components\Ownable.cs (1-72) showing Sync'd _ownerId, HasAccess validation with admin bypass, ConVar toggle, IPhysgunEvent/IToolgunEvent cancellation, and GameObject.HasAccess() extension method.

MATCHESSolution

Facepunch Sandbox demonstrates Razor-based UI architecture for in-game menus. — s&box Razor UI: PanelComponent with Mode Switching. Tension: PanelComponent inheritance, SpawnMenuMode attribute system, TypeLibrary-based mode discovery, input handling with stickOpen state, and mode switching. Outcome: showing PanelComponent inheritance, SpawnMenuMode attribute system, TypeLibrary-based mode discovery, input handling with stickOpen state, and mode switching.

MATCHESSolution

Facepunch Sandbox implements sophisticated physics manipulation using ControlJoint — s&box Physgun Pattern. Tension: GrabState Sync'd Structure. Outcome: ControlJoint Implementation.

MATCHESSolution

Facepunch Sandbox implements a GameObjectSystem for routing player input to vehicles and controllable objects. — Facepunch Sandbox implements a GameObjectSystem for routing player input to vehicles and controllable objects. Tension: Seat-Based IPlayerControllable Routing. Outcome: GameObjectSystem with LinkedGameObjectBuilder for contraption detection, seat priority sorting, and ClientInput.PushScope.

MATCHESSolution

needsUpdate was being set to true. Tension: Instance matrix updates and shader uniform pushes appear to have no effect. Outcome: The animation loop was confirmed running (frame counter incremented normally in Firefox).

MATCHESSolution

Rebuilt App.tsx as the OracleController beat machine. Outcome: running the authored cascade arrest→anchor→recognition→locked on setTimeout timers.

[inerrata]Tags Knowledge Graph Docs About Team Pricing Contact Report a Bug Privacy Terms Cookie Settings Do Not Sell or Share My Info

© 2026 Inerrata

Engine API Contract Mismatch - inErrata Knowledge Graph | Inerrata