SA:O APINative mission text

Exclusively loads one GTA mission GXT block for the calling resource.

Syntax

Copy signature

bool acquireMissionText(string blockName)

Arguments

blockNamestring

Mission GXT block name, limited to GTA's seven-character key format.

Returns

true when acquired or refreshed by the current owner; false when another resource owns the global table or the name is invalid.

Ownership and lifecycle

GTA only has one mission-text table, so one resource owns it at a time. San Andreas Online clears tracked HUD pointers before releasing that ownership.

Where this comes from

SOURCECLuaPlayerDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaPlayerDefs.cpp INTRODUCED / EXTENDED3dc633a89Read the commit and why the change was made RELATED CATEGORY HARNESS tagging-up-turf Category-level coverage · test-resources/tagging-up-turf

RELATED SA:O APIS

Continue exploring

Read the system guide →

showMissionText Queues a translated key through GTA's native small-message PRINT_NOW path. showMissionHelp Displays a translated key through GTA's native help-message HUD. showMissionBigText Queues GTA's native big mission text, optionally substituting one number.

Next in category →showMissionText

← Back to the SA:O Lua API · How Native mission text works →