Skip to content

game-feedback-mandate

Always-loaded, engine-agnostic. Every player-facing action ships WITH its feedback in the same PR as the action itself — a feature with no sensory confirmation is incomplete, exactly like one with no test.

Channels: visual · vfx · sfx · haptic · ui. Classes: input-ack · valid-action · invalid-action · progress · milestone · terminal. This table IS the blocking gate:

action classvisualvfxsfxhapticui
input-ackREQUIRED—optionalREQUIRED—
valid-actionREQUIREDoptionalREQUIREDoptional—
invalid-actionREQUIRED—REQUIREDREQUIRED—
progressREQUIREDoptionalREQUIRED—REQUIRED
milestoneREQUIREDREQUIREDREQUIREDoptionalREQUIRED
terminalREQUIREDREQUIREDREQUIREDoptionalREQUIRED

SFX loudness band (also blocking): volume scales inversely with fire rate —

Fire rateTarget
more than 2/sec−18 to −24 LUFS
0.3 to 2/sec−12 to −18 LUFS
less than 0.3/sec−8 to −12 LUFS
once per level−3 to −8 LUFS

No stated target, or a wrong-band cue, fails the gate like a missing channel. Peak/voice/vendor rules, timing budget, invariants: docs/game-feedback-mandate.md. How to measure + full standard: feel-juice feedback-matrix.md § Measuring.

Variation (V1, blocking): >3×/level or session ships ≥3 variants on the dominant channel; below that, one is fine. V2–V7 are non-blocking reviewer defaults. Full table: feel-juice’s references/feedback-matrix.md § Variation Rules.

Waiver: a REQUIRED cell or V1 ships unmet ONLY via inline feedback-waiver: <reason> in the PR/contract; no waiver = gate fails.

HARD-GATE (rules/workflow-gates.md, not restated here); the waiver above is the named override. Classify the action → fill its Feedback Matrix row (feel-juice’s references/feedback-matrix.md) → implement every REQUIRED cell in the same PR or record a waiver. t1k:cook/t1k:review and design review block on any unwaived gate violation above — AskUserQuestion the gap, never ship silently.

t1k:designer:base:feel-juice § references/feedback-matrix.md (full contract + examples) · t1k:designer:base:feel-foundations (timing theory) · rules/observable-gameplay.md · rules/workflow-gates.md (core) · game-feedback-mandate-unity.md (theonekit-unity) · t1k:cocos:playable:juice § references/feedback-channel-mechanisms.md (theonekit-cocos, when installed) · docs/game-feedback-mandate.md (full detail, history)