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.
- 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
- Sign-up closes. Every racer is respawned onto their grid position with the kit.
- After a short countdown the bot says GO and the vehicles appear, so nobody can jump the start.
- Racers drive through the checkpoints in order. Each lap time is shown in game chat.
- When the winner finishes, everyone else has the finish window to get home.
- The race ends when everyone has finished, the finish window closes, or the time limit runs out.
- 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.
- 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.
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.