Personal / public Windows utility

CCD2 OpenTrack Companion

Head tracking that stops the instant the game context is no longer safe.

01 / Purpose

A tool with a reason to exist.

A safety-gated bridge between OpenTrack head tracking and City Car Driving 2.0. It receives processed head-pose data over local UDP and converts it into mouse-look controls only while the intended game state remains valid.

01

Translate OpenTrack rotational pose into City Car Driving 2.0 camera movement.

02

Hold the configured in-game binding only during a deliberately armed driving session.

03

Stop output immediately when focus, cursor state or tracking freshness becomes unsafe.

04

Provide repeatable setup, centring controls, deadzones and useful diagnostics.

02 / Decisions

The interesting part is why.

01

Own the output

The companion—not OpenTrack—controls synthetic input so game focus and safety state can participate in every movement decision.

02

Loopback only

Tracking traffic never needs to leave the machine, which keeps the communication boundary narrow.

03

Fail closed

Focus loss, a visible cursor or stale data releases held input immediately instead of guessing.

04

No injection or capture

The design avoids game-memory access, process injection, screen capture and fragile UI automation.

03 / Architecture

A deliberate path through the system.

01

Track

OpenTrack maps and filters camera input, then sends fixed-size pose packets over loopback UDP.

02

Gate

A 10 ms state loop checks arming, exact game focus, hidden cursor state and fresh valid tracking.

03

Convert

Pose deltas become relative mouse movement with centring and deadzone state kept non-blocking.

04

Recover

A durable marker records held input so the next launch can release exactly the binding left behind.

04 / Technology

The working parts.

C#Windows Forms.NET FrameworkWin32Loopback UDPINI configurationTimer-driven state machinesGitHub Releases

05 / State & roadmap

What is real now—and what comes next.

Current
  • Version 1.2.0 is a stable public GitHub release.
  • Build, regression harness and maintainer live testing passed for normal movement and safety cancellation paths.
  • The packaged release was inspected, hashed, backed up and read back.
  • The project’s AI-assisted provenance is explicitly disclosed.
Planned
  • Broader validation of the experimental cursor guard across display and DPI configurations.
  • Separate positive and negative centring and deadzone ranges.
  • Portable OpenTrack lifecycle support only after its safeguards are designed and tested.
  • Any feature work continues on a new alpha line while 1.2.0 remains frozen.