Configuration guide

Vehicle Race

Every Vehicle Race setting: the checkpoints and laps, the start grid, the vehicle, race rules and kits, plus the live scoreboard picture and the track record.

Time
15 minutes
You need
Manage Server (website) or Owner, Co-Owner, Head Admin (Discord)
Applies to
Per Rust server

Overview

Every racer gets the same vehicle and drives laps of a track you set up. The track is a list of checkpoints: visible zones that must be passed in order. Checkpoint 1 is the start / finish line. Passing it after the last checkpoint counts a lap, and the first racer to finish every lap wins. The shared controls are in Auto-Events.

Before you start
  • Build or pick a track. An oval works best, about 150 metres or more from end to end.
  • Decide where the racers line up (the start grid), just behind the start / finish line.
  • Set a channel, or the scoreboard picture has nowhere to go.

Setup & Configuration

Log in to the RustyWorks website, open Servers Configure, pick your server and select Auto-Events, then Configure on Vehicle Race. Discord: /auto-event config.

Track

Setting What it does Limits and default
Checkpoints X, Y, Z for each checkpoint, in the order they are driven. The first one is the start / finish line 2 to 8. Required
Checkpoint Radius (metres) Size of every checkpoint zone 10 to 60. Default 25
Checkpoint Colour Colour of the checkpoint zones, as R,G,B. The start / finish line is always white Default 0,200,255
Checkpoint Call-outs A small line in game chat each time a racer passes a checkpoint, so they know it counted. Lap times are always shown On or Off. Default On
Track Record The fastest lap ever set on this track with this vehicle. Tick Clear the record when I save (website) or press Reset Record (Discord) to remove it Set by the bot

Stand in the middle of the track at each checkpoint in game and capture your position. Tips for a good track:

  • For an oval, 3 or 4 checkpoints is enough: the line, then one on each far side. The checkpoints in between stop racers cutting across or turning round on the line.
  • Make the radius wide enough to cover the whole width of the track.
  • Checkpoints should not overlap each other.
  • Players can only see a zone when they are within about 100 metres of it, so keep each checkpoint in sight of the one before.

Start grid

Add 2 to 10 grid positions, one for each racer. The first player to sign up gets the first position. The number of grid positions is also the most racers that can join. Leave a few metres between positions so the vehicles have room.

Race rules

Setting What it does Limits and default
Ping Role Role pinged when sign-ups open Optional
Laps How many laps the race is 1 to 20. Default 3
Max Racers Most racers that can join. Never more than your grid positions 2 to 10. Default 8
Join Phase (minutes) How long players have to sign up 1 to 60. Default 10
Time Limit (minutes) The race ends here even if nobody has finished 3 to 60. Default 15
Finish Window (seconds) How long everyone else has to finish once the winner is home 15 to 300. Default 60

A race needs at least 2 racers. With fewer, it is cancelled when sign-up closes.

Vehicle

Setting What it does Limits and default
Race Vehicle What every racer drives: a 2, 3 or 4 Module Car, Motorbike, Motorbike + Sidecar, Pedal Bike, Pedal Trike, Horse, Minicopter, Scrap Helicopter, Attack Helicopter, Rowboat, RHIB or Kayak Default 2 Module Car
Fuel Per Racer Low grade fuel given to each racer. Not given for horses, pedal bikes or kayaks 0 to 500. Default 100
Vehicle Spawn Height (metres) How far above the position the vehicle appears. Horses always spawn on the ground 0 to 10. Default 1

Kits

Setting What it does
Racer Kit Optional. Given at the start and after every respawn. Racers are respawned with an empty inventory, so this is all they carry
Reward Kit Optional. Given to the winner

The scoreboard picture

When the race starts the bot posts a picture in your channel and keeps it up to date. It shows:

  • Every racer in race order, with the lap they are on out of the total and the checkpoint they are on.
  • Each racer's last lap and their personal best lap.
  • The fastest lap of this race and who set it (shown in purple).
  • The track record. If it is beaten, the picture says NEW RECORD.
  • The race time, and at the end each racer's finish time or gap to the winner.

The track record belongs to one track and one vehicle. Changing the checkpoints, the radius or the vehicle starts a new record.

How a race plays out

  1. Sign-up closes. Every racer is respawned onto their grid position with the kit.
  2. After a short countdown the bot says GO and the vehicles appear, so nobody can jump the start.
  3. Racers drive through the checkpoints in order. Each lap time is shown in game chat.
  4. When the winner finishes, everyone else has the finish window to get home.
  5. The race ends when everyone has finished, the finish window closes, or the time limit runs out.
  6. Everyone is sent back to where they joined from, and inventories are cleared.

A racer who dies is put back on the last checkpoint they passed with a new vehicle (and the kit and fuel again). If a vehicle is wrecked or stuck, the racer gets a new one the next time they die and respawn. A racer who is offline for 60 seconds is retired from the race.

Good to know
  • The bot checks racers one at a time, so each racer is checked every 2 to 4 seconds. It also checks the line between a racer's last two positions, so driving straight through a checkpoint counts. Lap times are accurate to about a second or two.
  • Vehicles are not removed when the race ends. They stay on the map like any other vehicle.
  • Catch-A-Ride is switched off for racers while the race is running.

Vehicle Race has no custom announcement text. The channel, schedule and Pop Trigger are in Auto-Events.

Troubleshooting

Problem Cause Fix
"Still needed: a second checkpoint" Fewer than 2 checkpoints are saved Add another checkpoint and save
"Still needed: two start grid positions" Fewer than 2 grid positions are saved Add a grid position for each racer and save
"The race grid is full" Every grid position is taken Add more grid positions (up to 10) and raise Max Racers
A checkpoint did not count It was passed out of order, or the racer went round the outside of the zone Drive through the zones in order. Make the radius bigger if the track is wider than the zone
Laps are not counting A checkpoint was missed, so the line does not count yet Turn on Checkpoint Call-outs to see which checkpoints count, and go back for the missed one
No vehicle appeared The spawn point is blocked or inside something Move the grid position to open ground, or raise the Vehicle Spawn Height
The car will not move No fuel Raise Fuel Per Racer. Racers put the fuel in the vehicle themselves
No scoreboard picture No channel is set, or the bot cannot post there Choose a channel the bot can send messages and files in
It was cancelled at the start Fewer than 2 racers signed up A race needs at least 2 racers
It will not start Another team event is running Stop the other event first

Checked against RustyWorks on 11 Nov 2026.

Stuck on this step?

Tell us which setting you are on and what the bot said, and paste a screenshot if you can. Staff in the support Discord can usually fix it in a minute.