Configuring Scripting
From OpenSimulator
(Difference between revisions)
| (13 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| + | {{Quicklinks}} | ||
= Introduction = | = Introduction = | ||
Script configuration in OpenSimulator occurs in three major configuration sections within OpenSim.ini | Script configuration in OpenSimulator occurs in three major configuration sections within OpenSim.ini | ||
| + | # Major option is the script engine used: [[XEngine]] or [[YEngine]] | ||
| + | # Permisssions | ||
| + | # LL-Functions | ||
| + | # [[OSSL Implemented|OSSL]] | ||
| − | + | == Permissions == | |
| − | + | * allowed_script_creators - This can be "all" or "gods". If set to "gods" then only users who have requested and received administrator status can create scripts. All other attempts to create scripts will fail. | |
| − | + | * allowed_script_editors - This can be "all" or "gods". If set to "gods" then only users who have requested and received administrator status can update scripts. All other attempts to update scripts, even if the user is the owner of the script, will fail. | |
| − | + | == LL-Functions == | |
| − | + | ||
| − | = | + | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
* AllowGodFunctions - If true, god functions can be executed by gods (e.g. http://wiki.secondlife.com/wiki/LlSetObjectPermMask). If false then not even gods can execute these functions. | * AllowGodFunctions - If true, god functions can be executed by gods (e.g. http://wiki.secondlife.com/wiki/LlSetObjectPermMask). If false then not even gods can execute these functions. | ||
* max_external_urls_per_simulator. Change the max number of URLs that scripts can request in this simulator. Default is 100. Present since commit 22f25df (16 June 2012, OpenSimulator master dev branch post 0.7.3.1). | * max_external_urls_per_simulator. Change the max number of URLs that scripts can request in this simulator. Default is 100. Present since commit 22f25df (16 June 2012, OpenSimulator master dev branch post 0.7.3.1). | ||
| Line 18: | Line 17: | ||
* max_listens_per_script - Change the max number of llListens per script. Default is 64. | * max_listens_per_script - Change the max number of llListens per script. Default is 64. | ||
| − | = [ | + | == Relevant ini files == |
| − | * | + | |
| + | '''OpenSim.ini''' | ||
| + | |||
| + | * Choose the default script engine (DefaultScriptEngine in [Startup] section). | ||
| + | * Review and edit the [XEngine] or [YEngine] sections according to your needs. Refer to specific instruction : [[XEngine]], [[YEngine]] | ||
| + | |||
| + | '''OpenSimDefault.ini''' | ||
| + | |||
| + | Default values should be changed with care as they may impact stability/security. | ||
| + | * In the [Network] section, HttpBodyMaxLenMAX sets the maximum answer length for a llHTTPRequest. | ||
| + | * ExternalHostNameForLSL is the host name used for allocating URLs (llRequestURL/llRequestSecureURL) and is set to ${Const|BaseHostname} in OpenSim.ini, which should point automatically to your external host name. | ||
| + | * If you need to make requests to private IPs on your local network, edit OutboundDisallowForUserScripts. You should weight the security risk of exposing your local network to malicious requests. | ||
| + | * In the [ScriptsHttpRequestModule] section are variables that throttle object's hhtp requests. Raise them if you absolutely need it. Be warned this can overload your server. | ||
| + | |||
| + | If you want to leave OpenSimDefault.ini untouched, you may declare the variable you need in OpenSim.ini, creating the relevant section if needed. | ||
| + | |||
| + | '''config-include/osslDefaultEnable.ini''' | ||
| + | |||
| + | * Default premissions for OSSL functions. Better leave untouched and edit latter file osslEnable.ini. | ||
| + | |||
| + | '''config-include/osslEnable.ini''' | ||
| + | |||
| + | * Site-wise permissions for OSSL functions. Override permission from osslDefaultEnable.ini to suit your needs. More instructions here : [[:Category:OSSL_Functions]] | ||
| + | |||
| + | |||
| + | [[Category:Scripting]] | ||
Latest revision as of 01:12, 20 November 2021
Contents |
[edit] Introduction
Script configuration in OpenSimulator occurs in three major configuration sections within OpenSim.ini
[edit] Permissions
- allowed_script_creators - This can be "all" or "gods". If set to "gods" then only users who have requested and received administrator status can create scripts. All other attempts to create scripts will fail.
- allowed_script_editors - This can be "all" or "gods". If set to "gods" then only users who have requested and received administrator status can update scripts. All other attempts to update scripts, even if the user is the owner of the script, will fail.
[edit] LL-Functions
- AllowGodFunctions - If true, god functions can be executed by gods (e.g. http://wiki.secondlife.com/wiki/LlSetObjectPermMask). If false then not even gods can execute these functions.
- max_external_urls_per_simulator. Change the max number of URLs that scripts can request in this simulator. Default is 100. Present since commit 22f25df (16 June 2012, OpenSimulator master dev branch post 0.7.3.1).
- max_listens_per_region - Change the max number of llListens per region. Default is 1000.
- max_listens_per_script - Change the max number of llListens per script. Default is 64.
[edit] Relevant ini files
OpenSim.ini
- Choose the default script engine (DefaultScriptEngine in [Startup] section).
- Review and edit the [XEngine] or [YEngine] sections according to your needs. Refer to specific instruction : XEngine, YEngine
OpenSimDefault.ini
Default values should be changed with care as they may impact stability/security.
- In the [Network] section, HttpBodyMaxLenMAX sets the maximum answer length for a llHTTPRequest.
- ExternalHostNameForLSL is the host name used for allocating URLs (llRequestURL/llRequestSecureURL) and is set to ${Const|BaseHostname} in OpenSim.ini, which should point automatically to your external host name.
- If you need to make requests to private IPs on your local network, edit OutboundDisallowForUserScripts. You should weight the security risk of exposing your local network to malicious requests.
- In the [ScriptsHttpRequestModule] section are variables that throttle object's hhtp requests. Raise them if you absolutely need it. Be warned this can overload your server.
If you want to leave OpenSimDefault.ini untouched, you may declare the variable you need in OpenSim.ini, creating the relevant section if needed.
config-include/osslDefaultEnable.ini
- Default premissions for OSSL functions. Better leave untouched and edit latter file osslEnable.ini.
config-include/osslEnable.ini
- Site-wise permissions for OSSL functions. Override permission from osslDefaultEnable.ini to suit your needs. More instructions here : Category:OSSL_Functions
