Subsection 5.3
5.3 Jabs
Notice: Note: Docs are currently being updated for v1.45.0.
Created Last edited
Jabs are the playful opposite of celebrations: a red animation with a crowd of OOF!s and OUCH!es rising up the screen when something goes wrong. They play on the Celebrations & jabs overlay (/celebrations-and-jabs). Set them up on ⧉ Overlays → Jabs in the control panel. Each panel on that page has its own section below.
Jab types at a glance
Jabs are off for new installs, so turn them on first (see the next section). TiRST has nine jab types:
- Lost positions: other cars get past you on track. The title grows with the places lost: POSITION LOST, DOUBLE TROUBLE, TRIPLE DROP, QUADRUPLE DROP, then "5 PLACES GONE" and up. It names the drivers who passed you.
- Incident: you pick up incident points (1x, 2x or 4x), counting toward your session total.
- Contact: a 4x with a car right next to you, iRacing's heavy-contact penalty. It names the other driver and replaces the incident jab.
- Went backwards: you finish lower than you started.
- DNF: you leave a race after it starts without finishing, with iRacing's reason when it gives one.
- No qualifying lap: you were in qualifying while others set times, but you didn't.
- Meatball flag: you need repairs.
- Black flag: you've been given a penalty.
- Packet loss: your connection to iRacing drops below the quality you set.
The bigger the mistake, the more drama: losing 5 places or a 4x gets a bigger jab than losing 1 or a 1x.
Jabs only play in sessions whose event type is turned on under Settings → Event tracking. Jabs, overtakes, celebrations and Grid Rivals boards take turns on screen, so they never overlap.
Jabs
Show jab animations turns all jabs on or off. It's off by default.
- Flair & drama: how big the animation is, from 1 (Subtle) through Clean, Lively and Dramatic to 5 (Maximum). The default is 3, Lively.
- Screen position: Top, Middle, Above the HUD, or a custom offset from the top in pixels. The default is a 300-pixel offset.
- Volume: from 0 to 100, default 80. If volume normalization is on in Settings → Sound effects, the slider is hidden and the level set there applies.
Animation style: jabs don't have their own style setting. They use the style picked under Overlays → Celebrations → Animation style, so jabs and celebrations always match. All ten styles are described in the Celebrations section: Classic, Neon glow, Broadcast, Retro arcade, Minimal, Carbon, Glass, Luxe, Comic and Synthwave. With Minimal, jabs play no sounds.
What gets booed
Tick the jabs you want. All are on by default once jabs are turned on.
Losing positions on track
- Check position every: how often TiRST compares your position, from 10 to 60 seconds. The default is 30.
- Sensitivity: how far ahead of you a car must get, from 0.001 to 1 second, before it counts. The default is 0.001.
- TiRST counts the net places lost since the last jab. If you lose 2 and gain 1 back, the jab shows 1.
- How often: every time (the default), or only 1 in every 2, 3, 5, 10, 20, 25, 50 or 100.
- Always jab losing 2+ places at once: multi-place losses show even when How often would skip them. On by default.
Incident points from: jab incidents of 1x and up (the default), 2x and up, or 4x only.
Contact with another car: a 4x with a car right next to you. Light 0x contact never counts. It's shown instead of the incident jab.
Finishing lower than you started: the Went backwards jab after the finish. Tick …even after a celebration to jab a result that was also celebrated, such as starting P1 and finishing P3. That box is off by default.
Not finishing the race (DNF), No qualifying lap and Meatball or black flag each turn their jab on or off.
Packet loss: jabs when iRacing's connection quality (ChanQuality) stays below your threshold for more than a second, at most once a minute. The threshold goes from 30% to 98%, default 80%. The panel shows your connection quality right now, so you can adjust the threshold if jabs fire too often or not at all.
No jabs (or overtakes) until I've completed lap 1: on by default. This is the same setting as on the Celebrations page.
Places lost when you pit or under caution don't count, and neither does being lapped.
Try it
The preview buttons play a sample of every jab on all connected overlays, including OBS:
- Lost 1, Lost 2, Lost 3 and Lost 5
- 1x, 2x, 4x and Contact
- Went backwards, DNF and No qualifying lap
- Meatball, Black flag and Packet loss
- Mercy notice and Full mercy notice, the two Mercy rule announcements
Mercy rule
The mercy rule makes the jabs back off when a race is going badly, so your stream doesn't turn into a pile-on.
When the race is going badly has four settings:
- Off: jab everything (the default).
- Gentle: only back off in a really bad race.
- Standard.
- Strong: back off early.
TiRST keeps a score for the race: 1 point for each place lost since the start, ½ point for each incident point, and 4 points for each meatball or black flag. Gaining places back lowers the score again.
- Past the first level, the jabs calm down. Only losing 2 or more places at once or a 4x still gets a jab, and it's toned down.
- Past the second level, there are no more jabs for the rest of the race.
Show a "Mercy rule" notice when the jabs back off tells viewers what happened. It's on by default.
Mercy levels
This panel shows where each setting draws the line:
- Gentle: jabs calm down at 10 points and stop at 20.
- Standard: jabs calm down at 6 points and stop at 12.
- Strong: jabs calm down at 3 points and stop at 8.
For example, down 4 places with 6x and no penalties is 4 + 3 = 7 points. Standard calms the jabs down, and Strong turns them off.
Right now shows your score in the current race.
Incident report
Show viewers an incident report puts up a card with your name, the lap, what's left of the race and your incident count. It breaks the count down into off-tracks (1x), loss of control (2x) and contact (4x), and names the drivers you made contact with. It shows in races only and is on by default.
Show it
- When the car is damaged: when repair time appears or you get a meatball flag. On by default. iRacing's telemetry doesn't say when you open the damage report screen, so damage is the closest moment.
- After every incident: off by default.
- The report never shows more than once every 25 seconds.
Look
- On screen for: from 3 to 60 seconds, default 10.
- Distance from the top: in pixels, default 300.
- Opacity: from 10% to 100%, default 97%.
- Show with: Drop in (the default), cut, fade, zoom, or slide in from any side.
- Hide with: Lift out (the default), cut, fade, zoom, or slide out to any side.
- Transition speed: from 200 to 2000 milliseconds, default 700.
Preview plays a sample report, and Show my report now shows your real one for the current race.
Jab sounds
Each jab has its own sound list. Add as many sounds as you like; one plays at random each time, never the same one twice in a row. Jabs have no sounds until you add some, and unlike celebrations there's no shared global list.
The sound lists:
- Lost 1 place, Lost 2, Lost 3, Lost 4, and Lost 5+
- 1x incident, 2x incident and 4x incident
- Contact (when empty, the 4x incident sounds play)
- Went backwards
- DNF
- No qualifying lap
- Meatball flag
- Black flag
- Packet loss
To add a sound, paste a link to the file and click Add, or click Upload… to add files from your PC (mp3, wav, ogg or m4a). Click ▶ beside a sound to hear it, or ✕ to remove it. Uploading works best from a normal web browser at http://localhost:8767 rather than inside OBS.
In OBS, tick Control audio via OBS on the Celebrations & jabs browser source so the sounds reach your stream.
Wording
Every jab except lost positions has a title and a subtitle you can rewrite. Restore defaults puts back the wording TiRST comes with. Lost-position titles (POSITION LOST, DOUBLE TROUBLE, TRIPLE DROP…) are fixed and grow with the number of places.
These tokens are replaced with the real details:
{inc}: the incident points just picked up{total}: your incident total this session{start}and{finish}: your starting and finishing positions{lost}: places lost{reason}: why you didn't finish{lap}: the lap{quality}: your connection quality, as a percentage{track}: the track{class}: your car class{name}: the other driver (Contact only)
The default wording:
- Incident: {inc}x INCIDENT / That's {total}x this session
- Went backwards: WENT BACKWARDS / Started P{start}, finished P{finish}
- DNF: DNF / Did not finish — {reason}
- No qualifying lap: NO QUALIFYING LAP / Starting from the back. Bold strategy.
- Meatball flag: MEATBALL! / Repairs needed — back to the pits
- Black flag: BLACK FLAG / Report to the pits, please
- Packet loss: PACKET LOSS / Is the hamster tired?
- Contact: CONTACT! / Rubbing's racing… with {name}. That's {total}x.
- Mercy rule: MERCY RULE / Rough race. The jabs are taking it easy on you. (calmed down) / That's enough. No more jabs this race. (stopped)