Racing championship Beta

An organiser creates a championship, links the races they host in Torn, and the bot shows the live results of each race, awards points per position and keeps the standings. Several races can run at once, also in different championships.

How it works

A racing manager types /race-championship-create name:Spring Cup first_points:20. The first place scores that many points, every further place one less (never below 0). Optional: fastest_lap_bonus (extra points for the fastest lap, 0 = off) and crash_zero (on by default: a driver who crashed scores 0 for that race). The reply is only visible to you and contains the access code and the results page address. Everyone who has the code can look at the results page, and the final post of every race in the channel contains the link. Managers can see it again with /race-championship-show.
Create the race in Torn as usual, then type /race-start in the channel where the live results should appear. Without race_id the bot looks for the newest open or running race created by the organiser (host, default: your own Torn ID, taken from /link or from a nickname like Name [123]) that is not linked yet. Torn does not show race IDs in the game, so this search is the normal way. race_id exists for people who know a race ID from the API and takes exactly that race. A Torn race can be linked once per server. If you run several championships, add championship: (number or name).
The bot posts one live dashboard for the race: status, track, laps, drivers and a table with position, name, car, best lap and race time. It updates about once a minute. Show all opens the full table for you alone. If the Torn race has a password, add password: (up to 40 characters) to /race-start: the bot shows it in a Password field of the live dashboard for the drivers. It is not a secret from the drivers, but it appears nowhere else (not in the result, not in /race-results, not on the website) and the bot deletes it as soon as the race has ended.
As soon as Torn reports the race as finished, the bot posts the result with the points of every driver and the top ten of the championship in the channel and removes the live dashboard. That final post also links the championship's results page including the access code, so everyone in the channel can open it. To end a race earlier use /race-end (it refuses while Torn has no results at all; the result then says it was ended before Torn marked the race as finished). To drop a race completely, including its points, use /race-remove.

Points and exclusions

Drivers who finish are ranked by Torn's position. /race-start exclude:123,456 (or later /race-exclude race:1234567 drivers:123,456) leaves drivers out of the scoring, typically the organiser. They stay in the result, marked not scored, and do not take a place: the remaining drivers move up, so the runner-up behind an excluded winner gets the points for first place. You can change the list at any time, also after the race has ended; the points of that race are recalculated. A driver without a position in Torn's result counts as did-not-finish and scores nothing. A crashed driver keeps the position in the result but scores 0 when crash_zero is on (no fastest-lap bonus either). The fastest-lap bonus goes to the scored driver with the smallest best lap time (all of them on a tie).

The championship standings add the points of all finished races and are sorted by points, then wins, then podiums. Look at them with /race-standings, which works for everyone. /race-results shows a single race (live while it runs, with points once it is done).

Closing and deleting

/race-championship-close closes a championship (no more races, the standings stay). /race-championship-delete removes it with all races and results, but only with confirm:True.

On the website

For drivers (no login). Every championship has a public results page at https://racing.chaining-tatum.fun. Open it and type the access code (or use the link the organiser sends you, which ends in /c/ and the code). You see the championship name, how points are given, the standings (rank, driver, points, wins, podiums, races, best place), the list of races (track, laps, date, winner) and a table with the points of every driver per race. Click a race for its result: place, driver, car and class, best lap, total time, crash marker and points (not scored for drivers the organiser left out; DNF for drivers without a position). A race that is still running shows the current state, marked Live, and reloads itself every minute. The page needs no login and shows Torn player names, IDs, cars and results to anyone who has the code, so share the code only with the drivers. Search engines are told to stay away. Too many wrong codes from one address are blocked for a minute.

For managers (Discord login). Under Racing → Championships on your dashboard you see every championship of the server with its access code and the full public link, the races linked to it, and buttons to close or delete it (each with a confirmation box). A championship with a running race cannot be closed or deleted: end the race first with /race-end. Creating championships, starting and ending races stays in Discord. Only managers with the Racing championship role see this page and the code.

Limits

The bot reads each running race about once a minute (one request per race) with the Torn key of your server; a public key is enough for racing. Driver names are looked up by ID the first time they appear (a few per minute), until then the table shows #id. If Torn refuses the key, the race keeps running and the bot says so once in the channel. A race that is still not finished after six hours gets one reminder, it is never ended automatically. The result format of Torn's racing API is not yet confirmed live, so expect rough edges.

Managers need a Racing championship role under Access & roles (without one, your Duty roster roles apply).

Back to Help & wiki