From Multi Theft Auto: Wiki
Revision as of 23:34, 25 August 2023 by Pirulax (talk | contribs)
Jump to navigation Jump to search

Sets the maximum amount of RAM [in bytes] that can be used for streaming

[[{{{image}}}|link=|]] Tip: The `showmemstat` command can be used to see this value in real-time [You might have to scroll down using PgDown on your keyboard]
[[{{{image}}}|link=|]] Tip: To restore to default value use engineStreamingRestoreMemorySize
[[{{{image}}}|link=|]] Important Note: This function is meant for advanced users only, as it can lead to stability issues. Using a very high value might result in more crashes, while using a value too low might lead to frequent pop-in [and due to the way MTA works micro-stutter as well]


nil engineStreamingSetMemorySize( number sizeBytes )

OOP Syntax Help! I don't understand this!

Method: EngineStreaming:setMemorySize(...)
Variable: .memorySize
Counterpart: engineStreamingGetMemorySize

Required Arguments

  • sizeBytes : The maximum amount of RAM [in bytes] that can be used for streaming. Must be a positive non-zero number.


This example adds a command that can be used to change the streaming memory size, and display the previous value.

addCommandHandler("ssms", function(_, sizeMB)
    if tonumber(sizeMB) then
        outputChatbox("The maximum streaming memory available has been changed from " .. math.floor(engineGetStreamingMemorySize() / 1024 / 1024) .. " MB to " .. sizeMB .. " MB")      
        engineStreamingSetMemorySize(tonumber(sizeMB) * 1024 * 1024) -- Convert MB to Bytes
        outputChatbox("Please enter a numeric value!")
end, false, false)


Minimum server version n/a
Minimum client version 1.6.0-9.21874

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version client="1.6.0-9.21874" />

See Also