Settings system: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Can someone else finish this?)
 
(5 intermediate revisions by 4 users not shown)
Line 1: Line 1:
__NOTOC__
The settings system allows you to store and retrieve settings for future use, or provide server administrators with an easy way to configure your resource without modifying any files.
The settings system allows you to store and retrieve settings for future use, or provide server administrators with an easy way to configure your resource without modifying any files.


Line 19: Line 20:


The ''settingName'' can be anything you want.
The ''settingName'' can be anything you want.
==Manager==
You can manage your settings with the default [[Resource:admin|admin]] manager resource. In addition you can add some attributes in a setting, which will be useful in the settings manager:
<syntaxhighlight lang="xml"><settings>
    <setting name="*settingname" value="defValue" friendlyname="" group="" accept="" examples="" desc="" />
</settings></syntaxhighlight>
*'''Explanation:''' <small>TODO</small>
:*'''friendlyname:''' A friendly name to the setting.
<!-- :*'''group:''' Explain this! -->
:*'''accept:''' The values the setting could accept.
:*'''examples:''' An Example of a value.
:*'''desc:''' A description of the setting.


==Scripting functions==
==Scripting functions==
Line 25: Line 38:
==Console functions==
==Console functions==
There are two console functions in the settings system:
There are two console functions in the settings system:
 
{{Settings registry functions}}
===set===
 
===get===

Revision as of 20:00, 16 September 2012

The settings system allows you to store and retrieve settings for future use, or provide server administrators with an easy way to configure your resource without modifying any files.

Settings can be modified in two ways - either by scripts or by the server administrator using the console.

Setting names

Settings have a fairly simple naming system that allows you to specify the scope and access they provide.

Names are in the format:

[access][resourceName].settingName

Access modifiers:

  • *: public and can be read and written by any resource.
  • #: protected and can be read by any resource but only written by the resource they belong to.
  • @: private and can only be read and written to by the resource they belong to.
  • None specified: private if it is a local setting, public if it's a global setting.

The resourceName is optional. If it isn't specified, then the setting is global.

The settingName can be anything you want.

Manager

You can manage your settings with the default admin manager resource. In addition you can add some attributes in a setting, which will be useful in the settings manager:

<settings>
    <setting name="*settingname" value="defValue" friendlyname="" group="" accept="" examples="" desc="" />
</settings>
  • Explanation: TODO
  • friendlyname: A friendly name to the setting.
  • accept: The values the setting could accept.
  • examples: An Example of a value.
  • desc: A description of the setting.

Scripting functions

There are two scripting functions in the setting system: set and get.

Console functions

There are two console functions in the settings system: