RefreshResources: Difference between revisions

Latest revision as of 22:48, 6 September 2024

This function finds new resources and checks for changes to the current ones.

[[{{{image}}}\|link=\|]]	Note: The resource using this function needs access to function.refreshResources in order for this function to work. You can give it the access by including an aclrequest command in its meta.xml file or by adding it to the admin ACL group.

Syntax

bool refreshResources ( [ bool refreshAll = false, resource targetResource = nil ] )

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.

refreshAll: If true MTA will check for changes in all resources. If false, MTA will only check for new resources and try to reload resources with errors

ADDED/UPDATED IN VERSION 1.5.5-9.11718 :

targetResource: If set, the refresh is restricted to the supplied resource only

Note: Checking for changes in all resources can result in lag for a short period of time. It should generally be avoided to set refreshAll to true.

Returns

Returns true if refresh was successful, false otherwise.

Example

Click to collapse [-]

Server

This example will refresh resources when a player uses the /refreshresources command just like the hardcoded /refreshall.

function commandRefreshResources(player)
    refreshResources(true)
    outputChatBox("Resources refreshed", player, 255, 255, 0)
end
addCommandHandler("refreshresources", commandRefreshResources)

This example will refresh only the named resource:

refreshResources(true, getResourceFromName("admin"))

Changelog

Version	Description

1.5.5-9.11718

Added targetResource argument

@@ Line 2: / Line 2: @@
 __NOTOC__
 This function finds new resources and checks for changes to the current ones.
+{{Note|The resource using this function needs access to ''function.refreshResources'' in order for this function to work. You can give it the access by including an [[Server_Commands#aclrequest|aclrequest]] command in its [[meta.xml]] file or by adding it to the admin [[ACL]] group.}}
 ==Syntax==
@@ Line 17: / Line 18: @@
 ===Returns===
-Returns true is refresh was successful, false otherwise.
+Returns true if refresh was successful, false otherwise.
 ==Example==
@@ Line 42: / Line 43: @@
 ==See Also==
-{{Resource_functions}}
+{{Resource_functions|server}}