TrackmaniaRL Connect bridges Trackmania/OpenPlanet with TrackmaniaRL, a reinforcement learning framework for Trackmania.

It exposes local-only TCP endpoints for live vehicle telemetry and session readiness checks. All connections are bound to 127.0.0.1; no telemetry is sent over the internet.

Endpoints

• 127.0.0.1:9000 — binary telemetry stream
• 127.0.0.1:9001 — newline-delimited JSON session channel

The telemetry server accepts one client and continuously sends one fixed-size packet per game tick: 33 float32 values. If the client disconnects, the plugin closes the connection and listens again.

The session channel uses protocol version "2" and supports:

• verify_loaded_map — returns the UID of the currently loaded map
• confirm_ready — verifies that a player and vehicle state are ready

Telemetry packet layout

Values are serialized in this exact order.

Race state — 4 floats

1. Checkpoints passed
2. Current lap number
3. Finished flag (1.0 or 0.0)
4. Current race time in milliseconds

Transform and vehicle state — 12 floats

1. Position: x, y, z
2. Velocity: x, y, z
3. Forward direction: x, y, z
4. Up vector: x, y, z

Engine and drivetrain — 3 floats

1. Speed
2. Engine RPM
3. Current gear

Wheels and surface — 8 floats

1. Slip coefficient: front-left, front-right, rear-left, rear-right
2. Ground-contact material ID: front-left, front-right, rear-left, rear-right

Driving helpers — 3 floats

1. Wheels skidding count
2. Flying duration
3. Adherence coefficient

Player inputs — 3 floats

1. Steering input
2. Gas-pedal input
3. Braking flag (1.0 or 0.0)

Integer and boolean values are encoded as floats to keep the telemetry payload uniform.