Skip to content
MTA:SA Neon Documentation

engineParseSAMPMap

Client-side
NEON APISA-MP maps and object streaming

Available in Neon, not standard MTA

Parses Texture Studio / SA-MP Pawn map source into inert objects, building removals, material overrides, and diagnostics.

Syntax

table engineParseSAMPMap(string source)

Arguments

sourcestring

Complete Pawn map source text.

Returns

A result table with success, counts, objects, removedBuildings and diagnostics.

Ownership and lifecycle

Parsing creates inert data. Objects, custom models, material overrides, removals, and any temporary streaming-limit split remain owned by the calling client resource and must be cleaned up when that resource stops.

Important behavior
  • Parsing does not create elements or load models.
  • Object records preserve virtual world, interior, stream/draw distance and source location metadata.

Example

local parsed = engineParseSAMPMap(mapSource)
if not parsed.success then
    outputDebugString(parsed.diagnostics[1].message, 1)
end

Where this comes from

SOURCECLuaEngineDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaEngineDefs.cpp INTRODUCED / EXTENDED28dfcff23Read the commit and why the change was made TEST RESOURCE samp-map-loader test-resources/samp-map-loader
RELATED NEON APIS

Continue exploring

Read the system guide →
engineGetTXDIDFromName Resolves a loaded GTA texture-dictionary name to its current TXD slot. setObjectMaterial Applies an SA-MP-style texture and/or color override to one DFF material slot on a client object. removeObjectMaterial Removes one SA-MP-style material-slot override from a client object.

← Back to the Neon Lua API · How SA-MP maps and object streaming works →