Simple QTE is a complete Quick Time Event framework for Unity. Create cinematic action sequences, boss finishers, and interactive moments with 11 fully-featured QTE types. Works with both Legacy Input Manager and New Input System out of the box.
Three ways to create QTEs:
- Design in the Inspector with visual timeline editors (ScriptableObject configs)
- Generate from JSON using the built-in import/export system (perfect for AI-assisted workflows)
- Create at runtime via code (ScriptableObject.CreateInstance or direct evaluator access)
11 QTE TYPES
Button-Based:
- Press: Single button press with Open or Windowed timing modes
- Hold: Hold button until meter fills, optional release decay
- Mash: Rapid presses to reach target (Count or Value modes), rapid bonus system
- PingPong: Bouncing cursor on a bar, press when over target zone (golf swing, penalty kick, fishing style)
Stick-Based:
- StickWaggle: Waggle stick back and forth on configurable axis
- Directional: Push stick in correct direction, 8-direction support
- LinearPrecision: Find sweet spot on horizontal bar and hold
- RotationalPrecision: Rotate to target angle and hold
- Arc: Traverse arc from start to end angle (God of War style)
- RotationalSpin: Rotate stick N full times (door crank style)
Advanced:
- Composite: Combine multiple QTEs in sequence or parallel blocks with branching
KEY FEATURES
Dual Input System Support
Works with Legacy Input Manager and New Input System 1.4+. No configuration needed - auto-detects at compile time.
JSON Import/Export
Full-fidelity JSON serialization. Export schema documentation for AI tools. Import AI-generated configs directly into your project. Includes 5 sample JSON files demonstrating all QTE types.
Advanced Timing System
- Random time limits for unpredictability
- Speed curves: countdown accelerates or decelerates over time
- Decay curves: decay rate changes over time
- Timing phases: designer-friendly alternative to curves
- Optional timeout: disable time pressure for accessibility
Composite QTEs
Build complex sequences with:
- Sequential steps (do A, then B, then C)
- Parallel blocks (do A AND B simultaneously)
- Logic gates (ALL must succeed vs ANY can succeed)
- Branching (custom success/fail paths, recovery routes, alternate endings)
Release Modes
For precision and rotation QTEs:
- Continue: cursor stays where it is
- Decay: cursor drifts back to rest position
- Reset: cursor snaps back to start
- Fail: releasing fails the QTE
Custom Editors
11 visual Inspector editors with:
- Timeline visualization showing prompt/success/perfect zones
- D-pad direction picker for Directional QTEs
- Arc and angle visualizations
- Bar preview with zone visualization for PingPong
- Real-time validation with error display
- Tooltips with examples
RUNTIME ARCHITECTURE
- Pure C# evaluators: no MonoBehaviour inheritance required
- Zero GC allocation per tick
- Injected deltaTime for slow-motion and frame stepping support
- Clean event system: OnStateChanged, OnProgressChanged, OnCompleted
- Immutable QTEResult struct with accuracy, timing, and score data
WHAT'S INCLUDED
Runtime Scripts:
- 11 QTE config classes (ScriptableObject)
- 11 evaluators with complete logic
- QTEInstance lifecycle controller
- Input abstraction layer (IQTEInputSource)
- QTEInputAdapter for both input systems
Editor Scripts:
- 11 custom Inspector editors
- Import/Export Wizard window
- Schema exporter for AI tools
- Timing phase editor with visual timeline
Demo and Documentation:
- Demo managers and UI for all 11 types
- 10 HTML documentation pages
- 5 sample JSON files (God of War, Resident Evil, Heavy Rain, Spider-Man, Edge Cases themes)
USE CASES
- Boss finishers and cinematic kills
- Parry based gameplay with QTE prompts
- Door cranks and valve wheels
- Lockpicking and safe cracking
- Button mashing escape sequences
- Precision aiming minigames
- Golf swing / penalty kick meters
- Fishing minigame reeling
- Dialogue wheel selections
- Struggle and grapple moments
- Charge attacks
- Multi-input combo sequences
- Timeline cutscene interaction with QTE
SUPPORT
- Full HTML documentation included
- Sample JSON files for reference
- Demo scenes for all QTE types