# EA SPORTS WRC

## Connection Method

**UDP** — EA SPORTS WRC sends telemetry data over UDP using a JSON-configured telemetry system.

* **Default IP**: `127.0.0.1`
* **Default Port**: `20789`
* **Update Rate**: Approximately 60 Hz

## Automatic Setup

1. Launch EA SPORTS WRC at least once, then exit the game.
2. Select **EA SPORTS WRC** as your source in DR Sim Manager.
3. Click the **Settings** icon (⚙) next to the source.
4. Click **Install WRC Plugin** — this will automatically:
   * Copy the `drsm.json` packet definition to the telemetry folder
   * Update the `config.json` with the correct entry
   * Find an available port if the default is in use
5. Restart EA SPORTS WRC.

## Manual Setup

If you prefer to configure manually:

1. **Copy the Configuration File** Copy the `drsm.json` file from:

   ```
   C:\Users\<Username>\AppData\Local\DRSimManager\Plugins\WRC\
   ```

   Paste it into:

   ```
   C:\Users\<Username>\Documents\My Games\WRC\telemetry\udp\
   ```
2. **Edit the Config File** Open the `config.json` file located at:

   ```
   C:\Users\<Username>\Documents\My Games\WRC\telemetry\
   ```

   Add the following entry to the bottom of the `"packets"` array:

   ```json
   {
       "structure": "drsm",
       "packet": "session_update",
       "ip": "127.0.0.1",
       "port": 20888,
       "frequencyHz": -1,
       "bEnabled": true
   }
   ```

   **Note:** Ensure there is a comma `,` before this entry if it is not the first item in the `"packets"` array.
3. **Verify Setup** After starting WRC, check the `log.txt` file for any errors. This file is located at:

   ```
   C:\Users\<Username>\Documents\My Games\WRC\telemetry\
   ```

> **Note:** Replace `<Username>` with your actual Windows username.

## Available Telemetry

EA SPORTS WRC provides excellent rally telemetry:

* **Orientation**: Pitch, Roll, Yaw (calculated from vehicle direction vectors for high accuracy)
* **Acceleration**: Full 3-axis acceleration (projected onto vehicle-local axes)
* **Velocity**: Full 3-axis local velocity (including rear axle correction for yaw)
* **Angular Velocity**: Pitch, Roll, Yaw rates (calculated from orientation deltas)
* **Speed**: Vehicle speed
* **RPM**: Engine RPM (current, max, and idle)
* **Gear**: Current gear and maximum gears
* **Suspension**: 4-wheel hub position and velocity (FL, FR, BL, BR)
* **ABS**: Anti-lock braking indicator
* **Stage Progress**: Current distance and total stage length
* **Vehicle ID**: Mapped to specific real-world rally car names (over 100 vehicles identified)

### Telemetry Quality: ★★★★★

WRC provides comprehensive rally data. The orientation is calculated from forward and left direction vectors rather than simple Euler angles, providing more accurate rotation data especially during extreme car attitudes.

## Recommended Starting Settings

Rally driving produces dramatic forces:

* **Primary Cue Gain**: 50–80%
* **Smoothing**: Medium
* **Washout**: Medium to high — sustained pitch/roll on rough terrain
* **Safety Limits**: Recommended for big jumps and crash landings

## Known Quirks

* **Orientation from direction vectors**: WRC doesn't send Euler angles directly. DR Sim Manager calculates pitch, roll, and yaw from the vehicle's forward and left direction vectors, which provides more accurate rotation data.
* **Rear axle velocity correction**: The lateral velocity is corrected for the rear axle position (1.25m behind center of gravity) to improve yaw feel accuracy.
* **Vehicle name mapping**: WRC sends a numeric vehicle ID. DR Sim Manager maps this to the actual car name (e.g., ID 103 → "Ford Puma Rally1 HYBRID"). Over 100 vehicles are mapped.
* **Packet deduplication**: Duplicate packets are detected and skipped using a unique packet ID.
* **Port conflict detection**: The automatic installer checks if the default port is already in use (by another app or another WRC telemetry output) and can suggest alternative ports.
* **Interpolation enabled**: Smooth motion is achieved through interpolation between 60 Hz data updates.

## Checking the WRC Telemetry Log

If telemetry isn't working, check the WRC log file for errors:

1. Click the **Settings** icon next to the WRC source.
2. Click **Check WRC Telemetry Logs** to open the log file.
3. Look for errors related to packet definitions or UDP configuration.

## Troubleshooting

### No telemetry data

1. Verify the `drsm.json` file exists in `Documents\My Games\WRC\telemetry\udp\`.
2. Check that `config.json` contains the DRSM entry in the `"packets"` array.
3. Ensure proper JSON syntax (especially commas between array entries).
4. Make sure you are in a rally stage (not in menus or watching replays).
5. Check the WRC telemetry log file for errors.
6. Restart both WRC and DR Sim Manager.

### Port conflict with other telemetry apps

* If you use other WRC telemetry apps (like SimHub), they may already be using the same port. The DRSM automatic installer detects this and can assign an alternative port.
* You can manually change the port in both the WRC `config.json` and DR Sim Manager's source settings.

### Vehicle name shows as a number

* If a vehicle's ID hasn't been mapped yet (e.g., new DLC cars), it will display the numeric ID. This is cosmetic only — motion works normally regardless.

### "config.json" or "telemetry" folder doesn't exist

* Launch EA SPORTS WRC at least once and drive a stage. The game creates these folders on first use.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.departedreality.com/dr-sim-manager/general/sources/ea-sports-wrc.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
