Rally English Compositor
Defines the English-language configuration for rally pacenote composition. Contains corner severity scales, direction labels, modifier definitions, visual styling (colors/icons), distance rounding, tr
Defines the English-language configuration for rally pacenote composition. Contains corner severity scales, direction labels, modifier definitions, visual styling (colors/icons), distance rounding, transition rules, and system phrases (countdown, finish, damage, etc.).
Public API
| Field | Type | Description |
|---|---|---|
M.config | table | Complete compositor configuration |
M.breathConfig | table | Breath timing between phrases |
Key Configuration Sections
Corner Severity (config.cornerSeverity)
Nine levels from tightest to most open:
| Name | Value | Diameter | Icon |
|---|---|---|---|
tight hairpin | 100 | 10m | turnHp |
hairpin | 89 | 17m | turnHp |
open hairpin | 78 | 25m | turnHp |
one | 68 | 35m | turn1 |
two | 57 | 55m | turn2 |
three | 47 | 88m | turn3 |
four | 36 | 139m | turn4 |
five | 26 | 221m | turn5 |
six | 15 | 350m | turn6 |
Corner Length (config.cornerLength)
| Name | Angle Range | Value |
|---|---|---|
short | 0°–50° | 40 |
| (default) | 50°–110° | 50 |
long | 110°–150° | 60 |
extra long | 150°–360° | 70 |
Modifiers (config.modifiers)
Ordered by priority: don't cut, narrows, watersplash, over jump, over crest, bumpy, over bump
Each modifier has: text, optional textWhenFirst, visual.icon, visual.colorIcon
Transitions (config.transitions)
| Level | Threshold | Text |
|---|---|---|
| level1 | 5m | <none> |
| level2 | 15m | into |
| level3 | 25m | and |
System Phrases (config.system)
Includes weighted variants for: damage, countdown (1-5, go), firstnoteintro, firstnoteoutro, finish, commsCheck, beltsCheck, rescheduled, falseStart, and time warnings (10s, 20s, 30s, 60s).
How It Works
- The compositor config is consumed by the pacenote composition system to generate co-driver call text and visual UI data
- Corner severity maps measured turn diameter to a named severity level with associated icon and color
- Transitions determine phrasing between consecutive notes based on distance apart
- Modifiers add contextual warnings (cut, crest, bump, etc.) as suffixes to corner calls
- Visual properties (colors, icons) drive the in-game pacenote HUD display
- System phrases provide pre-race and post-race co-driver dialogue with weighted random selection
Notes
- WARNING: Changing text strings requires regenerating all audio files
- Colors use CSS variable references (e.g.,
var(--bng-add-red-550)) for the UI breathConfig.default= 0.05–0.075s;lastSubphrase= 0.10–0.20s- Distance rounding: small=10m, medium=50m (>100m), large=250m (>1000m)
- Units default to metric with
m/kmlabels - Corner radius change:
opens(value 40),tightens(value 60) separateDigitsin transitions controls whether distance numbers are read digit-by-digit
See Also
- Gameplay Systems Guide - Guide
Rally Vehicle Tracker
Class that tracks the player vehicle's position, velocity, speed, and damage during rally gameplay. Provides damage detection with configurable threshold.
Rally Driveline Measurement
Stub class for driveline measurement functionality. Currently a placeholder with only an `init` method.