Home Search Pricing Get inErrata About

Sign in Sign up

Graph/async-effects-outlive-owners

AntiPattern

Async Effects Outlive Owners

async-effects-outlive-owners

Async-driven gameplay effects keep running after their owning Component or GameObject is destroyed because raw Task.Delay and unmanaged cancellation aren’t tied to the engine’s lifetime, cutting particle/sound playback mid-effect and causing resource/state leaks or broken behavior.

Node Details

Public graph metadata

Updated7/14/2026

Connections

30 linked nodes

MATCHESSolution

you can use Zustand getters and optimistic update — multiple or rapid clicks could actually cause the updates to be executed but out of order. Tension: no optimistic update so u see that delay (lag) you said about.

MATCHESSolution

rendering the rows as a non complex component like a spinner or something — my laggy components were loading in as i scrolled etc. Tension: excessive blanking of the page. Outcome: using useEffect to determine if it is fully rendered, you can resolve most of the major blanking issues.

MATCHESSolution

useEffect(). Tension: not if it gets re-fetched in the background while the user is editing the form. Outcome: without it?

MATCHESSolution

Manage the refreshing state more robustly — ensuring it only turns off after all async operations are complete. Tension: remove the arbitrary timeout. Outcome: ensure no state updates occur after the component begins to unmount.

MATCHESSolution

single worker running async loop. Outcome: So you have a single worker running async loop and you block that loop.

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

Move the reset logic into a useEffect (or handle reset from the parent via props) so state updates occur as effects rather than during render. In the parent, toggle the reset flag (and optionally set it back to false after the update) to trigger the child's reset without causing continuous re-renders.

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 Sandbox.Services.Stats for leaderboards and Sandbox.Services.Achievements for achievements — s&box. Tension: Stats must be flushed after incrementing, and achievements use string identifiers defined in the game's asset config. Outcome: call at end of round/session.

MATCHESSolution

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

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

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

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

Use a two-level system: `ScheduleBase` (a sequence of tasks with a `ShouldCancel()` interrupt check) and `TaskBase` (a single atomic action with `OnStart/OnUpdate/OnEnd`). — The NPC calls `TickSchedule()` in `OnUpdate()` which runs the current schedule. Tension: When a task returns `Success`, the schedule advances to the next task. When `ShouldCancel()` returns true, the schedule returns `Interrupted` and the NPC can select a new schedule. Outcome: Built-in tasks: MoveTo, LookAt, Wait, Say, FireWeapon, PickUpProp, DropProp.

MATCHESSolution

CancellationTokenSource pattern allows cancelling mid-reload — In `OnReloadStart`. Tension: when switching weapons or firing. Outcome: cancel any existing reload, create a new CTS, set `isReloading = true`, then `await ReloadAsync(token)`.

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

record that the side effect fired, check before firing again — awarding XP, delivering a notification, processing a queue item. Outcome: All three are instances of the same principle.

MATCHESSolution

ShootEffects is [Rpc.Broadcast] — muzzle flash/impact effects. Tension: for muzzle flash/impact effects. Outcome: [Rpc.Broadcast].

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

Facepunch Sandbox demonstrates a clean dual-scope event architecture using `Local` and `Global` static classes. Tension: Difficulty implementing cancellable events.

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

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

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