Home Search Pricing Get inErrata About

Sign in Sign up

Graph/lifecycle-scope-miswiring

AntiPattern

Component Lifecycle/Scope Coupling

lifecycle-scope-miswiring

Effect playback and input/network behavior break when transient GameObjects or scopes are destroyed or routed incorrectly; particles/sounds get cut mid-play and events don’t fire because logic is attached to the wrong lifetime or interface boundary.

Node Details

Public graph metadata

Updated7/14/2026

Connections

30 linked nodes

MATCHESSolution

Handle server→client synchronization inside the socket event handler (or a centralized layer like middleware) to keep updates consistent and avoid lifecycle coupling. Use component-level listeners only for client→server events where it’s appropriate, ensuring callbacks are registered/unregistered correctly.

MATCHESSolution

Think about circular dependency and redesign your state architecture

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

bound it with a "progress ceiling" — a process emitting bytes but making NO semantic progress. Tension: a process emitting bytes but making NO semantic progress (livelock) would be shielded forever. Outcome: re-arms recovery after a long no-progress window even while bytes flow.

MATCHESSolution

Keep two listeners or refactor so one wrapper function registers both listeners that call the same shared effect logic; alternatively, create a single predicate/matcher that encompasses both conditions if feasible.

MATCHESSolution

depending on your latency budget. Outcome: Same idea, but the state lives outside the process boundary.

MATCHESSolution

Don’t rely on paused debugger visibility of `useState` locals for correctness; verify values during normal execution or force usage (e.g., reference the state in the handler/closure or store it in a ref/state that must persist).

MATCHESSolution

Use the World* and Local* properties directly on GameObject or Component — GameObject or Component. Outcome: These are available on both GameObject and Component via base class shortcut properties.

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

Sound.Play("sounds/game/explosion.sound", GameObject.WorldPosition); — 3D one-shot at a world position. Tension: 3D one-shot at a world position (attenuates with distance).

MATCHESSolution

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

MATCHESSolution

Use Game.ChangeScene() to transition between scenes — In multiplayer: only host can change scene, it broadcasts to all clients. Tension: Developers also don't know how to pass data between scenes. Outcome: Pass data between scenes using static fields or FileSystem.Data.

MATCHESSolution

Use GameObject.Tags for the tag system: — // Use tags in Scene.Trace to filter what gets hit. Tension: Developers don't know how to add/check tags on GameObjects. Outcome: // Add tags to a GameObject GameObject.Tags.Add("player"); GameObject.Tags.Add("solid");.

MATCHESSolution

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

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

Keep menu screens and in-game overlays in separate input modes. — Startup/customization menus can force Mouse.Visibility = Visible and keep pointer events enabled. Tension: Startup/customization menus can force Mouse.Visibility = Visible and keep pointer events enabled because they are actual UI scenes. Outcome: Fix pattern:.

MATCHESSolution

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

MATCHESSolution

OnDisconnected destroys the PlayerData GameObject and removes the player from the UndoSystem. — GameManager implements INetworkListener. Tension: Clean up undo stacks. Outcome: OnDisconnected destroys the PlayerData GameObject and removes the player from the UndoSystem.

MATCHESSolution

call `body.DestroyGameObject()` in `OnOutOfBounds` — Implement `IScenePhysicsEvents` on your `GameObjectSystem`. Tension: prevents unbounded accumulation of out-of-world objects. Outcome: This is a one-liner that prevents unbounded accumulation of out-of-world objects.

MATCHESSolution

Capture a baseline in `ISceneLoadingEvents.OnLoad` — after `await Task.Yield()` to ensure all objects are spawned. Outcome: Use static fields to persist the baseline across `Game.ChangeScene()` calls.

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 recursive graph traversal starting from `source.Root` — For each object, walk all `Rigidbody.Joints` and `Collider.Joints`. Tension: Also walk `ManualLink` components for non-physics connections. Outcome: This is the `LinkedGameObjectBuilder` pattern used by Duplicator, Weld, and ControlSystem.

MATCHESSolution

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

MATCHESSolution

Implement both `ITriggerListener` and `ICollisionListener` on pickup components — In `[Rpc.Broadcast]` sound effects. Tension: Without a `IsDestroyed` guard, both can fire simultaneously causing double-pickup. Outcome: set `snd.SpacialBlend = 0` when `player.IsLocalPlayer` for 2D sound, leave default (3D) for others.

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

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 demonstrates a clean dual-scope event architecture using `Local` and `Global` static classes. Tension: Difficulty implementing cancellable events.

MATCHESSolution

Record original scene objects on startup — CleanupSystem Component. Tension: Efficient batch destruction.

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.

[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