Imported from Kevin-Liu-01/Claude-of-Tanks (src/fx/SKILL.md). Install upstream with npx skills add Kevin-Liu-01/Claude-of-Tanks --skill fx. Copyright stays with the author.

claude-of-tanks / src/fx

Purpose

Render combat feedback from authoritative events without modifying simulation.

Mental model & key files

fxRuntimeAccess.ts owns retryable battle-only module/runtime acquisition, effects.ts composes event reactions, particles.ts owns typed pools, clock.ts owns presentation time, effectAttachments.ts owns continuous emitter anchor contracts, and impactDecals.ts owns bounded surface marks.

Patterns to follow / invariants

Pool hot objects, bound lifetime/count, use event positions as presentation inputs only, and respect pause/killcam/shot-mode time scaling.

Common tasks → first action

Trace the bus event, confirm the access owner is acquired before the consumer, confirm pool teardown/reset paths, then test live battle, killcam, and rematch behavior.

Gotchas

Worlds and tank visuals are reused across matches; decals and emitters must not survive reset. Network event IDs will be needed for deduplication.