hatayama/unity-cli-loop

uloop-replay-input

Replay recorded PlayMode keyboard and mouse input. Use for exact gameplay reproduction, E2E runs, or consistent demos from JSON recordings.

First seen Apr 16, 2026

Installation

$ npx skills add hatayama/unity-cli-loop --skill uloop-replay-input

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from hatayama/unity-cli-loop · top by installs.

npx skills add hatayama/unity-cli-loop

Browse all from hatayama/unity-cli-loop

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 510
License LICENSE.md
Default branch main
Open issues 10
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,468 B
  • docs SUMMARY.md 165 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 5 installs

SKILL.md

uloop replay-input

Replay recorded keyboard and mouse input during PlayMode. Loads a JSON recording and injects input frame-by-frame via Input System with zero CLI overhead. Supports looping and progress monitoring.

Create recording JSON files in the Unity Editor from Window > Unity CLI Loop > Recordings with Start Recording and Stop Recording. There is no CLI command for recording input.

Usage

# Start replay (auto-detect latest recording)
uloop replay-input --action Start

# Start replay with specific file
uloop replay-input --action Start --input-path scripts/my-play.json

# Start replay with looping
uloop replay-input --action Start --loop

# Check replay progress
uloop replay-input --action Status

# Stop replay
uloop replay-input --action Stop

Parameters

Parameter Type Default Description
--action enum Start Start - begin replaying, Stop - stop mid-way, Status - check progress
--input-path string auto Path to the recording JSON. When empty, auto-detects the latest recording in .uloop/outputs/InputRecordings/
--no-show-overlay flag - Hide replay progress overlay
--loop flag - Loop continuously

Deterministic Replay

Replay injects the exact same input frame-by-frame, but the game must also be deterministic to produce identical results. If replay output must be compared across runs, read [references/deterministic-replay.md](references/deterministic-replay.md) before interpreting failures.

Prerequisites

  • Unity must be in PlayMode
  • Input System package (com.unity.inputsystem) must be installed; this tool only works with the New Input System.

Output

Returns JSON with:

  • Success: Whether the operation succeeded
  • Message: Status message
  • Action: Echoes which action was executed (Start, Stop, or Status)
  • InputPath: Path to recording file (nullable string; populated on Start only)
  • CurrentFrame: Current replay frame index (nullable int)
  • TotalFrames: Total frames in the recording (nullable int)
  • Progress: Replay progress (nullable float in 0.0 – 1.0)
  • IsReplaying: Whether replay is currently active (nullable bool)