OnResourceStart: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Undo revision 29715 by Jeremy Themans (talk))
No edit summary
Line 1: Line 1:
{{Server event}}
{{Server event}}
__NOTOC__
__NOTOC__
This event is triggered when a resource is loaded.
This event is triggered when a resource is started.


'''Important:''' If you attach this event to the root element it will called when ''any'' resource starts, not just the resource your script is running inside. As such, most of the time you will want to check that the resource passed to this event matches your resource (compare with the value returned by [[getThisResource]]) before doing anything. Alternatively you can attach the event to [[getResourceRootElement]]([[getThisResource]]()).
'''Important:''' If you attach this event to the root element it will called when ''any'' resource starts, not just the resource your script is running inside. As such, most of the time you will want to check that the resource passed to this event matches your resource (compare with the value returned by [[getThisResource]]) before doing anything. Alternatively you can attach the event to [[getResourceRootElement]]([[getThisResource]]()).
Line 16: Line 16:


==Cancel effect==
==Cancel effect==
If this event is [[Event system#Canceling|canceled]], the resource starting is aborted and is gets unloaded again.
If this event is [[Event system#Canceling|canceled]], the resource starting is aborted and is stopped again.


==Example==
==Example==

Revision as of 13:36, 12 January 2014

This event is triggered when a resource is started.

Important: If you attach this event to the root element it will called when any resource starts, not just the resource your script is running inside. As such, most of the time you will want to check that the resource passed to this event matches your resource (compare with the value returned by getThisResource) before doing anything. Alternatively you can attach the event to getResourceRootElement(getThisResource()).

Parameters

resource startedResource
  • startedResource: The resource that was started

Source

The source of this event is the root element in the resource that started.

Cancel effect

If this event is canceled, the resource starting is aborted and is stopped again.

Example

This code will output the name of any resource that is started.

function displayLoadedRes ( res )
	outputChatBox ( "Resource " .. getResourceName(res) .. " loaded", getRootElement(), 255, 255, 255 )
end
addEventHandler ( "onResourceStart", getRootElement(), displayLoadedRes )

See Also

Resource events


Event functions