CopyResource: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(add oop syntax)
(Remove obsolete Requirements section)
 
(2 intermediate revisions by 2 users not shown)
Line 2: Line 2:
{{Server function}}
{{Server function}}
This function copies a specified [[resource]] with a new name.
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==  
==Syntax==  
Line 34: Line 32:
addCommandHandler ("backupresource",backupResouce) -- add command
addCommandHandler ("backupresource",backupResouce) -- add command
</syntaxhighlight>
</syntaxhighlight>
==Requirements==
{{Requirements|1.1.1-9.03316|n/a|}}


==See Also==
==See Also==
{{Resource_functions}}
{{Resource_functions|server}}

Latest revision as of 15:33, 7 November 2024

This function copies a specified resource with a new name.

Syntax

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

OOP Syntax Help! I don't understand this!

Method: resource:copy(...)


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 of the copy. 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

See Also