# ACTelemetry

A Custom Shaders Patch (CSP) Lua application for Assetto Corsa that reads car telemetry data via the CSP Lua API and sends it as JSON over UDP.

## What It Does

The plugin runs inside Assetto Corsa under Proton/Linux. It collects telemetry at 60 Hz from the CSP Lua API and broadcasts a JSON datagram to a configurable UDP endpoint each frame (throttled to the configured rate).

## Installation

Copy the entire `ac-telemetry-plugin` directory into your CSP Lua apps folder:

```
<Assetto Corsa root>/extension/lua/apps/
```

Enable the app in the CSP in-game app launcher.

## Configuration

Edit `config.lua` to set the target UDP endpoint:

```lua
local config = {
    target_host = "127.0.0.1",   -- UDP receiver IP
    target_port = 5005,          -- UDP receiver port
    send_interval = 1 / 60,      -- 60 Hz send rate
}
```

## JSON Format

Each UDP datagram contains a JSON object with the following schema (sent to `target_host:target_port`):

```json
{
  "timestamp": 1716123456.789,
  "speed_kmh": 245.3,
  "rpm": 8750,
  "gear": 6,
  "throttle": 0.85,
  "brake": 0.0,
  "steering": 0.12,
  "g_forces": { "x": 0.5, "y": -0.2, "z": 1.0 },
  "wheel_slip": [0.1, 0.1, 0.0, 0.0],
  "suspension_travel": [0.15, 0.14, 0.16, 0.15],
  "lap_time": 85.234,
  "lap_count": 5
}
```

| Field              | Type             | Description                        |
|--------------------|------------------|------------------------------------|
| `timestamp`        | number           | `os.clock()` time                  |
| `speed_kmh`        | number           | Car speed in km/h                  |
| `rpm`              | number           | Engine RPM                         |
| `gear`             | number           | Current gear                       |
| `throttle`         | number           | Throttle input (0.0 - 1.0)         |
| `brake`            | number           | Brake input (0.0 - 1.0)            |
| `steering`         | number           | Steering input (-1.0 - 1.0)        |
| `g_forces`         | object           | G-forces: `x`, `y`, `z`            |
| `wheel_slip`       | array[4]         | Per-wheel slip (FL, FR, RL, RR)    |
| `suspension_travel`| array[4]         | Per-wheel suspension travel        |
| `lap_time`         | number           | Current lap time in seconds        |
| `lap_count`        | number           | Completed lap count                |

## Dependencies

- CSP (Custom Shaders Patch) with Lua support
- LuaSocket (bundled with CSP)