uw-game-feel-integrator

Game Feel Integrator

Apply juice to gameplay events using the GFD Feedback Matrix.

Before You Start

1. Read docs/ProjectConfig.yaml for:
   • feel_tools.tweening — which tween library ("dotween", "primetween", or "none").
   • feel_tools.feedback_system — feedback framework if any.
   • feel_tools.audio — audio middleware.
   • feel_tools.camera — camera system (Cinemachine, custom, etc.).
   • mcp.unity_mcp — if true, call refresh_unity after creating files.
2. Read docs/GFD.md for the Feedback Matrix — it defines which events need which feedback channels.
3. Read docs/CODING_STANDARDS.md for async patterns (Awaitable + CancellationToken) used in middleware-agnostic patterns.

Rule of Three

Every meaningful action needs feedback in at least 3 channels: Visual, Audio, Kinesthetic.

Middleware Reference

• DOTween: See references/dotween.md
• PrimeTween: See references/primetween.md
• No middleware: Use async Awaitable coroutines
• Shader effects as feel: See references/shaders-as-feel.md — outline flash, dissolve, chromatic aberration, UV scroll, distortion

Theory & Inspiration

• Game feel foundations + Loic Jacob methodology: See references/gamefeel-theory.md

Universal Patterns (middleware-agnostic)

Hitstop

private async Awaitable Hitstop(float duration = 0.05f)
{
    Time.timeScale = 0f;
    await Awaitable.WaitForSecondsAsync(duration);
    Time.timeScale = 1f;
}

Shake Profile

[System.Serializable]
public struct ShakeProfile
{
    public float duration;
    public float magnitude;
    public static ShakeProfile Light => new() { duration = 0.1f, magnitude = 0.1f };
    public static ShakeProfile Medium => new() { duration = 0.2f, magnitude = 0.3f };
    public static ShakeProfile Heavy => new() { duration = 0.35f, magnitude = 0.6f };
}