OnResourceStop: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (Right revision number)
 
(5 intermediate revisions by 2 users not shown)
Line 11: Line 11:
==Parameters==
==Parameters==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
resource stoppedResource
resource stoppedResource, boolean wasDeleted
</syntaxhighlight>  
</syntaxhighlight>  


*'''stoppedResource''': the [[resource]] that is being stopped.
*'''stoppedResource''': the [[resource]] that is being stopped.
{{New items|3.0160|1.5.5|
*'''wasDeleted''': a [[boolean]] representing whether the resource folder was deleted, moved or renamed.
*'''wasDeleted''': a [[boolean]] representing whether the resource folder was deleted, moved or renamed.
|11854}}


==Source==
==Source==
Line 24: Line 22:
==Example==
==Example==
This example displays a message in the chatbox when a resource is stopped.
This example displays a message in the chatbox when a resource is stopped.
<section name="Example 1: Server" class="server" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua" >
addEventHandler( "onResourceStop", root,
addEventHandler ( "onResourceStop", root,  
     function( resource )
     function ( resource )
         outputChatBox( "The resource " .. getResourceName( resource ) .. " was stopped!", root )
         outputChatBox ( "The Resource " .. getResourceName(resource) .. " was stopped!", root, 255, 255, 255 )
    end
  end  
)
)
</syntaxhighlight>
</syntaxhighlight>
</section>
 
<section name="Example 2: Server" class="server" show="true">
This example only outputs message if the stopped resource is the same resource where the eventHandler is.  
This example only outputs message if the stopped resource is the same resource where the eventHandler is.  
<syntaxhighlight lang="lua" >
<syntaxhighlight lang="lua">
addEventHandler ( "onResourceStop", resourceRoot,  
addEventHandler( "onResourceStop", resourceRoot,
     function ( resource )
     function( resource )
         outputChatBox ( "This resource has stoped", root, 255, 255, 255 )
         outputChatBox( "This resource has stopped!", root )
   end  
   end
)
)
</syntaxhighlight>
</syntaxhighlight>
</section>


==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.5.5-9.11854|Added wasDeleted parameter}}


{{See also/Server event|Resource events}}
{{See also/Server event|Resource events}}

Latest revision as of 22:06, 9 October 2019

This event is triggered when the resource is stopped. This can occur for a number of reasons:

  • The stop console command was used
  • The restart console command was used
  • The resource was modified (the resource will automatically restart)
  • Another resource stopped it using stopResource.

Note: If you wish to just detect a single resource being stopped, you should attach handlers for this event to the resource's root element. You can access this using getResourceRootElement.

Parameters

resource stoppedResource, boolean wasDeleted
  • stoppedResource: the resource that is being stopped.
  • wasDeleted: a boolean representing whether the resource folder was deleted, moved or renamed.

Source

The source of this event is the root element of the resource that is being stopped.

Example

This example displays a message in the chatbox when a resource is stopped.

addEventHandler( "onResourceStop", root,
    function( resource )
        outputChatBox( "The resource " .. getResourceName( resource ) .. " was stopped!", root )
    end
)

This example only outputs message if the stopped resource is the same resource where the eventHandler is.

addEventHandler( "onResourceStop", resourceRoot,
    function( resource )
        outputChatBox( "This resource has stopped!", root )
   end
)

Changelog

Version Description
1.5.5-9.11854 Added wasDeleted parameter

See Also

Resource events


Event functions