San Andreas Station Pack

Program ownership and synchronization

A Station Pack owns the local station catalog, deterministic order, identifiers, current program, metadata, and timestamps. Radio owns the vehicle, permissions, selection, power, volume, UI, and playback lifecycle; Sound renders the selected local media.

Installation and Radio registration

ensure san_andreas_sound
ensure san_andreas_dispatch
ensure san_andreas_station_pack
ensure san_andreas_radio

Config.ServerRadio = {
    Enabled = true,
    AcousticClass = 'server_music',
    VolumeMultiplier = 0.70,
    ExteriorVolumeMultiplier = 0.75,
    Resources = {
        'san_andreas_station_pack'
    }
}

• Keep the exact san_andreas_station_pack folder name and start it before Radio so the initial catalog is discoverable.
• Keep fxmanifest.lua, config.lua, server/, audio/, artwork/, and ASSET_PROVENANCE.md together.
• The release manifest packages files directly beneath audio/ and artwork/. Add manifest patterns if custom media uses subfolders or additional supported extensions.
• When more than one pack is installed, append each exact folder name to Config.ServerRadio.Resources and keep every station ID unique across packs.
• The server validates the invoking configured resource and local media prefix; a pack cannot publish another resource's files or take ownership of its stations.

Prepare music, artwork, and durations

1. Begin only with media that may be redistributed through the FiveM resource packfile.
2. Trim unwanted silence and add very short fades where hard edges click.
3. Keep perceived loudness consistent and preserve headroom; MP3 around 128 kbps at 44.1 or 48 kHz is a practical music balance.
4. Test the loudest track at maximum managed Radio volume.
5. Measure the final encoded file, not a source copy from before conversion, and retain the decimal seconds.
6. Record creator, source, license, modification notes, and required attribution in ASSET_PROVENANCE.md.

ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 audio/track-name.mp3

Configure the broadcast clock

Define stations and tracks

{
    id = 'SERVER_EXAMPLE_ROCK',
    label = 'Vinewood Rock Works',
    short = 'VRW',
    genre = 'Server-owned rock',
    accent = '#d95f4d',
    artwork = 'artwork/vinewood-rock-works.jpg',
    shuffle = true,
    tracks = {
        {
            id = 'vrw:track-one',
            artist = 'Artist Name',
            title = 'Track Name',
            file = 'audio/track-name.mp3',
            duration = 214.437
        }
    }
}

Schedule identifiers and multiple stations

Identifiers = {
    Enabled = true,
    EveryTracks = 2,
    Randomize = true,
    Clips = {
        {
            id = 'vrw:station-ident-01',
            artist = 'Vinewood Rock Works',
            title = 'Station Identification',
            file = 'audio/vrw-ident-01.ogg',
            duration = 3.428
        }
    }
}

Synchronization and volume balance

Radio requests station snapshot
-> receives active track and shared timestamp
-> creates the vehicle sound
-> seeks to the calculated offset
-> fades to the intended volume

1. Normalize track loudness and retain headroom before changing configuration gain.
2. Test the loudest track at full managed head-unit volume.
3. Lower Config.ServerRadio.VolumeMultiplier when local stations overpower Satellite Radio inside the vehicle.
4. Lower ExteriorVolumeMultiplier when local media overdrives exterior bass or filtering.
5. Do not raise the global Sound profile to compensate for one quiet file.

Public server API

GetStations()

GetSnapshot()

GetStation(stationId)

(stationId, source)

Verification, troubleshooting, and distribution

1. Start Sound, Station Pack, and Radio in order and open the Server Radio source.
2. Confirm every station's label, description, accent, artwork, artist, and title.
3. Tune one vehicle, wait at least 20 seconds, then tune a second and compare offsets.
4. Restart only the Station Pack; unchanged Anchor and Seed should reconstruct the current program.
5. Listen across several music and identifier boundaries for silence, overlap, clicks, metadata delay, or restart at zero.
6. Test maximum managed volume inside and outside, then verify radio-off, vehicle deletion, and resource-stop cleanup.