Unique extras
The unique property in vehicle configs allows you to define groups of lighting features that are mutually exclusive - activating one automatically deactivates the others.
Primary Use Case: Traffic Advisor
The most common use is for the traffic advisor, where only one direction should be active at a time:
unique = {
directLinks = {3, 4},
directRechts = {5, 6},
directCenter = {7, 8},
}
With this configuration:
- Activating
directLinks→ turns off extras{5,6}(directRechts) and{7,8}(directCenter) - Activating
directRechts→ turns off extras{3,4}(directLinks) and{7,8}(directCenter) - Activating
directCenter→ turns off extras{3,4}(directLinks) and{5,6}(directRechts)
How It Works
- 1
Step 1
The script checks if the toggled type exists in the
uniquetable. - 2
Step 2
For every other type in the same
uniquetable, it turns off all listed extras. - 3
Step 3
The UI updates for all deactivated types.
- 4
Step 4
The requested type is then toggled normally.
Custom Unique Groups
You're not limited to traffic adviser directions. Any combination of light types can be made mutually exclusive:
-- Example: Cruise lights and work lights are mutually exclusive
unique = {
steadyBlue = {7},
steadyWhite = {8},
}
With this, activating cruise lights turns off work lights and vice versa.
Important Notes
- The extras listed in the
uniquegroups should match the extras listed in the corresponding light type properties. - A light type can only be in one unique group.
- The
uniqueproperty is optional, omit it entirely if you don't need mutually exclusive behavior.