Difference between revisions of "Set"

From Multi Theft Auto: Wiki
Jump to: navigation, search
(Adding a example Command)
(Example)
Line 23: Line 23:
 
       return outputChatBox("Syntax: /setacl <acl> <value>")
 
       return outputChatBox("Syntax: /setacl <acl> <value>")
 
   end
 
   end
   set ( acl, value )
+
   if set ( acl, value ) then
  outputChatBox("Acl "..acl.." value set to "..value)
+
      outputChatBox("Acl "..acl.." value set to "..value)
  print(getPlayerName(playerElement).." has changed "..acl.." to "..value)
+
      print(getPlayerName(playerElement).." has changed "..acl.." to "..value)
 +
  else
 +
      outputChatBox("Error happend while changing the Acl "..acl.." value to "..value)
 +
      print(getPlayerName(playerElement).." tryed to change "..acl.." to "..value)
 +
  end
 
end
 
end
 
addCommandHandler("setacl", setAclRights)
 
addCommandHandler("setacl", setAclRights)
 
</syntaxhighlight>
 
</syntaxhighlight>
 
  
 
==See Also==
 
==See Also==
 
{{Settings registry functions}}
 
{{Settings registry functions}}

Revision as of 12:00, 3 May 2010

This function is used to save arbitrary data under a certain name on the settings registry.

It's important to note that set always writes to the settings.xml file, even if get read the value from a resource's meta.xml. This means that the admin can specify settings in the settings.xml that override the resource's defaults, but that the defaults can still be retrieved if need be. As a general principle, resources should not be designed so that the admin is required to modify them, they should be 'black boxes'.

Syntax

bool set ( string settingName, var value )

Required Arguments

  • settingName: The name of the setting you want to set. See setting names for information on settings names.
  • value: The value to set the setting to. This can be any Lua data type, except for functions, most userdata (only resources can't be stored) and threads.

Returns

Returns true if the setting has been set, false if you do not have access to the setting or invalid arguments were passed.

Example

This example sets a specified setting with a Value. This is a local setting belonging to the resource that the code is run in.

function setAclRights(playerElement, commandName, acl, value, type)
   if not acl or not value then
      return outputChatBox("Syntax: /setacl <acl> <value>")
   end
   if set ( acl, value ) then
      outputChatBox("Acl "..acl.." value set to "..value)
      print(getPlayerName(playerElement).." has changed "..acl.." to "..value)
   else
      outputChatBox("Error happend while changing the Acl "..acl.." value to "..value)
      print(getPlayerName(playerElement).." tryed to change "..acl.." to "..value)
   end
end
addCommandHandler("setacl", setAclRights)

See Also