ResetMapInfo: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
 
(2 intermediate revisions by 2 users not shown)
Line 5: Line 5:
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool resetMapInfo ( [player thePlayer = getRootElement()] )
bool resetMapInfo ( [ player thePlayer = root ] )
</syntaxhighlight>
</syntaxhighlight>


===Optional Arguments===
===Optional Arguments===
'''thePlayer:''' The specific player you wish to restore the state of.  Not specifying this will result in all players map info being reset.
{{OptionalArg}}
*'''thePlayer:''' The specific player you wish to restore the state of.  Not specifying this will result in all players map info being reset.


==Returns==
==Returns==
Line 17: Line 18:
This will reset all map info when the resource is stopped.
This will reset all map info when the resource is stopped.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addEventHandler("onResourceStop", getResourceRootElement(getThisResource()),
function onResourceStop()
-- Resource stop event
resetMapInfo()
function()
end
            resetMapInfo()
addEventHandler("onResourceStop", resourceRoot, onResourceStop)
        end
)
</syntaxhighlight>
</syntaxhighlight>


==See Also==
==See Also==
{{Map_functions}}
{{Map_functions}}

Latest revision as of 08:01, 5 November 2023

This function is used to reset the state of a player. It is intended to restore a player to his default state as if he had just joined the server, without any scripts affecting him.

Syntax

bool resetMapInfo ( [ player thePlayer = root ] )

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • thePlayer: The specific player you wish to restore the state of. Not specifying this will result in all players map info being reset.

Returns

Returns true if the map info was reset successfully, otherwise false.

Example

This will reset all map info when the resource is stopped.

function onResourceStop()
	resetMapInfo()
end
addEventHandler("onResourceStop", resourceRoot, onResourceStop)

See Also