CopyResource

From Multi Theft Auto: Wiki
Revision as of 22:38, 28 March 2012 by -ffs-Sniper (talk | contribs) (Added optional argument, fixed returns and added note about revision)
Jump to navigation Jump to search

This function copies a specified resource with a new name.

Note: This function only works properly from 1.3.0-3912 (r3912). In case you are below r3912 you need to create a directory called "trash" inside of the "resources-cache" folder .

Syntax

bool copyResource ( resource theResource, string newResourceName[, string organizationalDir] )

Required Arguments

  • theResource: the resource which is going to be copied
  • newResourceName: the name that the copied resource will receive

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.

  • organizationalDir: A string containing the path where the resource should be copied to (e.g. "[gamemodes]/[amx]").

Returns

Returns the resource element that was copied. Returns false if the arguments are incorrect

Example

-- This script can backup your resource with a easy command! /backupresource [resourcename]
function backupResource (player,command,resourcetobackup) -- start the function
  if (resourcetobackup) and (getResourceFromName(resourcetobackup)) then -- check if the resource is exist
    copyResource (getResourceFromName(resourcetobackup),resourcetobackup .. "_backup") -- copy the resource and give it the name [resource]_backup
    outputChatBox ("Resource " .. resourcetobackup .. " succesfully backed up!",player,255,0,0,false) -- say it's OK!
  else -- if it isn't exist
    outputChatBox ("Resource can't be backed up! (don't forget the parameters!)",player,255,0,0,false) -- say it isn't exist!
  end
end
addCommandHandler ("backupresource",backupResouce) -- add command

Requirements

Minimum server version 1.1.1-9.03316
Minimum client version n/a

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version server="1.1.1-9.03316" />

See Also