OnResourceStateChange: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (Fixed abnormal gap)
m (formatting)
 
Line 6: Line 6:
}}
}}
__NOTOC__
__NOTOC__
{{Note|Possible states:
* '''loaded''' - when resource is loaded but not running
* '''running''' - when resource is loaded and running
* '''starting''' - when resource is starting
* '''stopping''' - when resource is stopping
* '''unloaded''' - when resource is not loaded}}
==Parameters==
==Parameters==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 17: Line 24:
==Source==
==Source==
The [[event system#Event source|source]] of this event is the root [[element]].
The [[event system#Event source|source]] of this event is the root [[element]].
==Possible states==
* '''loaded''' - when resource is loaded but not running
* '''running''' - when resource is loaded and running
* '''starting''' - when resource is starting
* '''stopping''' - when resource is stopping
* '''unloaded''' - when resource is not loaded


==Example==
==Example==

Latest revision as of 17:48, 1 June 2025

BETA: NEW FEATURE (BUILD: 1.6.0 r22430)

This event is triggered when a resource's state is changed. This event is an extended version of onResourceLoadStateChange

[[{{{image}}}|link=|]] Note: Possible states:
  • loaded - when resource is loaded but not running
  • running - when resource is loaded and running
  • starting - when resource is starting
  • stopping - when resource is stopping
  • unloaded - when resource is not loaded

Parameters

resource changedResource, string oldState, string newState
  • changedResource: The resource that was either loaded, reloaded or is unloading.
  • oldState: The state the resource was in before it changed.
  • newState: The state the resource has changed to.

Source

The source of this event is the root element.

Example

This code will output the state of resource when it's state will be changed:

addEventHandler('onResourceStateChange', root, function(res, oldState, newState)
    iprint('Resource '..getResourceName(res)..' has changed its state from '..oldState..' to '..newState)
end)

See Also

Resource events


Event functions