Skip to content
This repository was archived by the owner on Mar 25, 2024. It is now read-only.

Running Events

Pigalala edited this page Sep 9, 2023 · 4 revisions

Driving (PLAYERS)

When driving in a race, you only have to join by clicking on a race join message or doing /race join.

When driving in an event, you need to sign up before you can race. To sign up for an event, click on a sign-up message (shown below), use /event sign [EVENT] or wait for an admin to add you to the event.

Example sign-up message

You can leave a heat via /race leave or /heat quit

Creating and Running Events (ADMINS)

In TimingSystem, an event is simply a series of qualifications and final (race) rounds. There are two methods of creating events, each for different use cases.

Race Method

The Race Method is a way to quickly create a race without going through the hassle of making a whole event. This is most useful for one-off, fun races. This method does not allow for multi-heat events.

General Race Flow

  1. Create a race, with track, laps and pits specified.
  2. Wait for players to join.
  3. Start the race.
  4. End race

Race Commands

Create a race: /race create [TRACK] [LAPS] [PITS]

Start a race: /race start

Join a race: /race join

Leave a race: /race leave

Spectate a race: /event spectate QuickRace

Example Race Structure and Creation

Example Race Structure

Use the following commands and image above to understand how a simple race can be created. This race would consist of 5 laps and 1 pit.

/race create ExampleTrack 5 1
-WAIT FOR PLAYERS TO JOIN-
/race start
/race end (when all drivers have finished)

Event Method

The Event Method allows for more specific event structures, however, these take more time to create than the Race Method

General Event Flow

  1. Create the event.
  2. Broadcast a sign-up message for the event. [OPTIONAL]
  3. Set a track for the event.
  4. Create rounds for the event.
  5. Create heats for each round.
  6. Add players to the heats manually. [OPTIONAL]
  7. Run all heats in order.
  8. When all rounds are finished, end the event.

Most commands are named according to purpose, which should help you follow the General Event Flow. Below are a few useful commands to get you started.

Event Commands

Create an event: /event create [NAME]

Set a track: /event set track [TRACK]

Select an event: /event select [EVENT] allows you to access rounds and heats of an event

Spectate an event /event spectate [EVENT] sends you driver information and scoreboard of active heats

Broadcast a signup message /event broadcast [clicktosign|clicktoreserve] sends a message to all players which adds them to the signlist or reservelist if they click on it

Toggle event signing: /event set signs [open|closed] toggle whether players can add themselves to the event or not

Sign for an event: /event sign [EVENT] [PLAYER] add another player to an event

Reserve for an event: /event reserve [EVENT] [PLAYER] add another a player to an event

Round Commands

Create a round: /round create [TYPE]

Finish a round: /round finish

Get round results: /round results

Get list of rounds: /round

Fill heats with players: /round fillheats [random|sorted] [all|signed|reserve] fills the heats in a round with players from the signlist or the reservelist. They are sorted randomly or by timetrail times on the track

Heat Commands

Create a heat: /heat create [HEAT]

Load a heat to grid: /heat load [HEAT]

Start a heat: /heat start [HEAT]

Set laps of a heat: /heat set laps [HEAT] [LAPS]

Set pits of a heat: /heat set pits [HEAT] [PITS]

Set timelimit of a qualification heat: /heat set timelimit [HEAT] [h/m/s] eg. 2m OR 1h OR 30s OR 10000 [ms]

Get heat info: /heat info [HEAT]

Example Event Structure and Creation

Example Event Structure

Use the following commands and image above to understand how a simple event can be created. This event would consist of 2 qualies and a 10 lap and 1 pit race.

--SETTING UP THE EVENT--
/event create ExampleEvent ExampleTrack
/event set signs open 
/event set broadcast clicktosign
/round create qualification
/round create final
/heat create R1-Qualy
/heat set timelimit R1Q1 5m
/heat set startdelay R1Q1 5s
/heat set maxdrivers R1Q1 5
/heat create R1-Qualy
/heat set timelimit R1Q2 5m
/heat set startdelay R1Q2 5s
/heat set maxdrivers R1Q1 5
/heat create R2-Final
/heat set laps R2F1 10
/heat set pits R2F1 1
-WAIT FOR PLAYERS TO JOIN-
/round fillheats random signed

--RUNNING THE EVENT--
/heat load R1Q1
/heat start R1Q1
/heat finish R1Q1 (if not all players finish)
/heat load R1Q2
/heat start R1Q2
/heat finish R1Q2 (if not all players finish)
/round finish
/heat load R2F1
/heat start R2F1
/heat finish R2F1 (if not all players finish)

/event finish

If you need help, run into issues or have questions about TimingSystem, contact support in the BoatLabs Discord Server.

BoatLabsLogo

Clone this wiki locally