OnResourcePreStart: Difference between revisions
Jump to navigation
Jump to search
Zangomangu (talk | contribs) No edit summary |
(Improve example.) |
||
| (4 intermediate revisions by 3 users not shown) | |||
| Line 3: | Line 3: | ||
Analogous to [[onResourceStart]], but triggered before script files are initialised. | Analogous to [[onResourceStart]], but triggered before script files are initialised. | ||
{{Note|This event isn't triggered within the resource starting.}} | {{Note|This event isn't triggered within the resource starting.}} | ||
==Parameters== | ==Parameters== | ||
| Line 12: | Line 9: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
*'''startingResource''': | *'''startingResource''': the [[resource]] that is starting. | ||
==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]]. | ||
==Cancel effect== | ==Cancel effect== | ||
| Line 23: | Line 20: | ||
This code will output the name of any resource that is starting. | This code will output the name of any resource that is starting. | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
function displayStartingRes ( res ) | function displayStartingRes(res) | ||
outputChatBox ( "Resource " .. getResourceName(res) .. " is going to start", | outputChatBox("Resource "..getResourceName(res).." is going to start.", root, 255, 255, 255) | ||
end | end | ||
addEventHandler ( "onResourcePreStart", | addEventHandler("onResourcePreStart", root, displayStartingRes) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
{{See also/Server event|Resource events}} | {{See also/Server event|Resource events}} | ||
Latest revision as of 08:07, 16 September 2021
Analogous to onResourceStart, but triggered before script files are initialised.
Parameters
resource startingResource
- startingResource: the resource that is starting.
Source
The source of this event is the root element.
Cancel effect
If this event is cancelled, the resource won't begin starting.
Example
This code will output the name of any resource that is starting.
function displayStartingRes(res)
outputChatBox("Resource "..getResourceName(res).." is going to start.", root, 255, 255, 255)
end
addEventHandler("onResourcePreStart", root, displayStartingRes)
See Also
Resource events
Event functions
- addEvent
- addEventHandler
- cancelEvent
- cancelLatentEvent
- getEventHandlers
- getLatentEventHandles
- getLatentEventStatus
- removeEventHandler
- triggerEvent
- wasEventCancelled