HYPERTWIST ALPHA TEST - WINDOWS
Release date: 2026-07-23

START HERE

1. Extract the entire ZIP before launching. Do not run HyperTwist from inside
   the ZIP.
2. Keep the extracted folder intact. HyperTwist needs its UnrealHyperTwist
   content folder, engine files, and runtime DLLs beside the launcher.
3. Run the top-level UnrealHyperTwist.exe.
4. The first-run launch menu should appear. A headset is not required:
   keyboard and mouse are the primary Alpha test path.

FIRST-RUN ROUTES

- Coach Dashboard and Settings: operator status, controls, local settings,
  training surfaces, browser-runtime status, and diagnostics.
- Classic Cube Free Play: interactive 3x3 cube, scramble/timer, hints, replay,
  local best times, follow-along mode, and optional voice-command surfaces.
- Classic Cube Follow-Along: guided classic-cube practice.
- Magic120Cell Training: dedicated 120-element state, projection, visibility,
  focus, and local persistence training surface.
- MagicCube5D Training: dedicated 242-element order-three 5D state,
  projection, visibility, focus, and local persistence training surface.
- OpenXR Validation: bounded headset/controller readiness surface. Its
  configuration is present, but physical headset and controller behavior is
  still an explicit live-device Alpha validation gate.

CLASSIC CUBE CONTROLS

- Left click a cube piece: clockwise face turn.
- Right click a cube piece: counter-clockwise face turn.
- Middle-mouse drag: orbit camera.
- Mouse wheel: zoom.
- R: new scramble.
- H: hint.
- Enter: submit solve.
- F: toggle free-play/follow-along mode.
- Hold V: voice capture when a local speech provider is available.
- C: cycle voice profile.

MAGIC120CELL AND MAGICCUBE5D CONTROLS

- Space: toggle projection auto-rotation.
- Q / E: rotate projection.
- Page Up / Page Down: change visible projection layer.
- N: create a new scrambled runtime state.
- R: reset projection.
- S: save local state.
- L: load local state.
- Home: reset camera.
- Mouse wheel: zoom.
- Middle-mouse drag or Shift+right-mouse drag: orbit.
- D: toggle diagnostics/dashboard surface.

GRAPHICS

HyperTwist defaults to Direct3D 11 for broad first-run compatibility. D3D12 is
an opt-in test path: create a shortcut to UnrealHyperTwist.exe and append
"-d3d12" to its Target only when intentionally testing that renderer.

DIAGNOSTICS

HyperTwist Shipping builds retain first-party diagnostics without enabling
Unreal Development trace-control listeners. If startup fails or a surface is
blank, collect these files:

- %LOCALAPPDATA%\UnrealHyperTwist\Saved\Logs\HyperTwistRuntime-latest.log
- %LOCALAPPDATA%\UnrealHyperTwist\Saved\Logs\HyperTwistFirstRunLaunch-latest.log
- %LOCALAPPDATA%\UnrealHyperTwist\Saved\Crashes (if present)

Include the route selected, exact reproduction steps, a screenshot, Windows
version, GPU model/driver, and whether any optional local voice, speech, or
vision sidecar was running. Core keyboard/mouse simulation must start without
those optional sidecars.

ALPHA BOUNDARY

This package is an Alpha test build, not a final production installer. The
Classic Cube route owns interactive twist behavior. The higher-dimensional
routes currently own dedicated family state, projection, focus/visibility,
local persistence, maps, and launch surfaces; they do not yet claim complete
parity with every mature higher-dimensional twist mechanic. Live physical
OpenXR headset/controller observation also remains pending until hardware is
available.
