Skip to content
MTA:SA Neon Documentation

playMissionAudio

Client-side
NEON APINative mission and frontend audio

Available in Neon, not standard MTA

Starts one loaded mission-audio handle exactly once through GTA's native player.

Syntax

bool playMissionAudio(int handle)

Arguments

handleint

Owned loaded handle.

Returns

true when playback started; false for unloaded, already played, stale, or foreign handles.

Ownership and lifecycle

Mission-audio handles belong to the resource generation that created them and are released on stop. Mission-passed tunes are local one-shot frontend tracks and create no handle.

Where this comes from

SOURCECLuaAudioDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaAudioDefs.cpp INTRODUCED / EXTENDED28b42898bRead the commit and why the change was made RELATED CATEGORY HARNESS native-mission-audio-test Category-level coverage · test-resources/native-mission-audio-test
RELATED NEON APIS

Continue exploring

Read the system guide →
playMissionPassedTune Plays one of GTA's two native mission-passed beat tracks. requestMissionAudio Preloads a supported GTA script-audio event and returns a resource-owned opaque handle. isMissionAudioLoaded Reports whether an owned native mission-audio event has finished loading.

← Back to the Neon Lua API · How Native mission and frontend audio works →