→Custom jukebox tracks: update for builds 24070 (alternative track IDs no longer case-sensitive) and 24071 (can now have always-shown tracks)
Line 6,650:
Line 6,650:
This consists of a string → model lookup, where...
This consists of a string → model lookup, where...
−
* The key is the [[#Custom audio|audio cue ID]] to play.
+
* The key is the [[#Custom audio|audio cue ID]] to play (case-sensitive).
* The value is a model with the fields listed below.
* The value is a model with the fields listed below.
Line 6,664:
Line 6,664:
|-
|-
| <samp>Available</samp>
| <samp>Available</samp>
−
| ''(Optional)'' Whether the track should be shown in the jukebox menu. Default true.
+
| ''(Optional)'' Whether the track should be shown in the jukebox menu. This can be <samp>true</samp> (always shown), <samp>false</samp> (never shown), or <samp>null</samp> (show if the player has heard it before). Default <samp>null</samp>.
+
+
Tracks with <samp>"Available": true</samp> are listed first in the jukebox menu.
|-
|-
| <samp>AlternativeTrackIds</samp>
| <samp>AlternativeTrackIds</samp>
−
| ''(Optional)'' A list of other cue names for this audio track. If the player has heard any of these track IDs, this entry is available in the menu. Default none.
+
| ''(Optional)'' A list of other cue names for this audio track (not case-sensitive). If the player has heard any of these track IDs, this entry is available in the menu. Default none.
For example, this can be used when renaming a track to keep it unlocked for existing players:
For example, this can be used when renaming a track to keep it unlocked for existing players: