NEON APINative mission and frontend audio

Available in Neon, not standard MTA

Plays one of GTA's two native mission-passed beat tracks.

Syntax

Copy signature

bool playMissionPassedTune(int tune)

GTA task mapping

NATIVE GTA BEHAVIOR 0394

No CTask is created

SCM equivalent: PLAY_MISSION_PASSED_TUNE

This is a native audio command, not a CTask. Neon preloads and starts the matching beat track through GTA's existing frontend-audio path.

Arguments

tuneint

Mission-passed tune selector: 1 or 2.

Returns

true when tune 1 or 2 was started; false for any other selector.

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.

Important behavior

• The selector maps to GTA's native beat-track IDs 11 and 12. This is a local one-shot sound and does not return a mission-audio handle.

Example

assert(playMissionPassedTune(1))

Where this comes from

SOURCECLuaAudioDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaAudioDefs.cpp INTRODUCED / EXTENDED7346d730fRead the commit and why the change was made TEST RESOURCE tagging-up-turf test-resources/tagging-up-turf

RELATED NEON APIS

Continue exploring

Read the system guide →

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. playMissionAudio Starts one loaded mission-audio handle exactly once through GTA's native player.

Next in category →requestMissionAudio

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