# Custom Races (/docs/assetto-corsa/custom-races)



import { Step, Steps } from "fumadocs-ui/components/steps";
import { Callout } from "fumadocs-ui/components/callout";

A **Custom Race** is a full event configuration. Where Quick Race gives you one session with defaults, a Custom Race lets you build a complete weekend — practice, qualifying, and race — with your own weather, time of day, and entry list. This is what you use for leagues and structured events.

Building an event [#building-an-event]

<Steps>
  <Step>
    Choose track and cars [#choose-track-and-cars]

    Pick the track and layout, then select the cars allowed in the event from the car picker. The car list defines what entrants can drive.
  </Step>

  <Step>
    Add sessions [#add-sessions]

    Enable the sessions you want and set each one's length:

    * **Booking** — optional reserved-entry phase before practice.
    * **Practice** — open running; set a duration in minutes.
    * **Qualifying** — timed; sets the grid. Set a duration.
    * **Race** — set laps **or** a time limit, plus the starting-grid rule (from qualifying, reversed, or random).

    You can run any combination — practice only, qualifying + race, or all three.
  </Step>

  <Step>
    Set weather and conditions [#set-weather-and-conditions]

    Add one or more weather presets. For each you can set ambient and road temperature, time of day, and wind. Dynamic track grip builds up as cars run; set the starting grip level and how fast it builds. See [Weather & Track Conditions](/docs/assetto-corsa/weather-and-track-conditions) for the detail.
  </Step>

  <Step>
    Build the entry list [#build-the-entry-list]

    Define who's on the grid:

    * **AutoFill Entrants** — let the manager populate the grid from the allowed cars (fast for AI or open lobbies).
    * **Manual entrants** — add named drivers, assign their car and skin, fixed setup, ballast, and restrictor, and pin them to a pit/grid position.

    Keep the entrant count at or below the track's pit-box limit.
  </Step>

  <Step>
    Save and start [#save-and-start]

    Click **Save** to store the event, or **Start Event** to launch it now. Saved races can be reused — see below.
  </Step>
</Steps>

Saving, starring, and templates [#saving-starring-and-templates]

Custom Races are reusable:

* **Save** an event to keep its full configuration.
* **Star** the events you run often so they're easy to find.
* **Use as template** — open a saved race, tweak it, and start it as a new event without rebuilding from scratch.
* **Edit** a saved race at any time.

This makes it easy to keep a "league night" config ready to fire each week.

Scheduling instead of starting now [#scheduling-instead-of-starting-now]

Any Custom Race can be scheduled for later — once, or on a repeating cadence — and it appears on the calendar. See [Scheduling Races](/docs/assetto-corsa/scheduling-races).

<Callout type="info">
  **Auto Loop** keeps the server busy when nobody's racing by looping events while the server is idle. Combine it with saved races so there's always something running for drivers who join.
</Callout>

Race Weekends (premium) [#race-weekends-premium]

For multi-session weekends with progression between sessions (where results carry forward), use **Race Weekends** from the sidebar. This is a premium feature included on XGamingServer plans that support it.

<Callout type="warn">
  Can't save or start a race, or the track shows no pit boxes? The track content is incomplete (missing its `ui_track.json`). See [Troubleshooting → missing pitboxes](/docs/assetto-corsa/troubleshooting).
</Callout>