Roll20 API layer we're scripting against simply doesn’t surface that metadata from the track to the sandbox, and it also doesn’t give you a “track ended” event. 1) Playing flag does not reliably reflect reality Need: playing should automatically flip to false when a non-looping track naturally ends (and this should be consistent). 2) No “track ended” event / callback for API scripts Need: Emit an event when a jukebox track ends (or errors) with track id and metadata. 3) No duration/length metadata exposed to the API Need: Expose duration (and ideally currentTime or position) for each track. 4) No playback position/time controls Need: Add readable currentTime and writable currentTime (seek) or at least read-only position. 5) Softstop semantics unclear / insufficient for SFX Need: Add support for multiple instances of the same SFX (virtual instances), or provide a restart/retrigger flag that reliably restarts from 0 and plays once. 6) No API-visible “is actually audible” indicator Need: A truthy signal from the audio engine like isAudible, isActive, or playbackState (playing, ended, stalled, etc.) 7) Inadequate documentation of jukeboxtrack fields & guarantees Need: Document all jukeboxtrack properties (readable/writable), lifecycle, event timing, and any known limitations. 8) No Mass Track Management Needed: Interface for editing, adding, remove tracks on a scale that's not one at a time.
