Region Debug Console
Revision as of 13:53, 29 August 2012 by Toady Nakamura (talk | contribs) (→Turn on/off Pathfinding: changed format slightly after question from user inworld)
Capability Documentation
Post to Capability: "SimConsole"
Post:
<llsd><string>help</string></llsd>
Response:
<llsd><string>Response</string></llsd>
Commands
- Help (Command)
Help is available for the following commands and topics. Type "help <topic>" for more information. Note that all commands are case insensitive.
Get Retrieve the value of a variable.
Set Set the value of a variable.
Variables List variables you are authorized to view or modify.
Restart Restart the region after a specified amount of time (default 5mins).
- Get (Command)
Syntax: get <parameter>
Retrieve the current value of a simulator or region variable. Note that if the variable was set since the region was restarted, the new value will be returned rather than the value used when the region started. This can be significant for some variables. For more information, see "help <variable>". To retrieve the value of a variable used at startup, use "get -s <variable>".
- Set (Command)
Syntax: set <variable> <value>
Sets the value of a simulator or region variable. Note that some variable will not take effect until the region is restarted. This behavior will typically be specified in the parameter's description (see: "help variables")."
Value Format Examples:
Integer: 1234 or -435 0xffeb6194
Float: -3.4 or 14
Bool: [ON/OFF] or [TRUE/FALSE] or [ENABLED/DISABLED]
Vector: <1.34, -4.2, 8> in <x, y, z> order.
- Help Variables (Command)
Syntax: help variables
You are authorized to access the following parameters in this region:
accurate_terrain
Enable more accurate terrain simulation at the cost of performance. Defaults to disabled.
Read/Write
allow_return_encroaching_estate_object
Allow land owners to return an Estate Manager's object that overlaps their land.
Read/Write
allow_return_encroaching_object
Allow land owners to return a regular object that overlaps their land.
Read/Write
- Restart (Command)
Syntax: restart <minutes>
Restart the region after a specified amount of time (default 5mins).
Notes:
Can only accept positive integers.
If used during a active countdown will set the countdown to the specified time.
Appears to have no throttling or wait timers.
Giving the time "0" will cause the sim to shutdown immediately with no warning except for Second Life closing with a (Region is going down)
Restarts are warned to all clients with a message like this ([AlertMessage] /RESTART_X_MINUTES 5) (The dialog thing that normally appears.)
Notable Responses
If you stumble upon a variable or command not in help these two can show.
- You are not authorized to set that parameter. This event has been logged.
- You are not authorized to perform that command. This event has been logged.
LSL possibilities
If you have a bot with estate manager rights hand a LSL script the SimConsole Capability URL you can send commands to it. Note, you can't read the responses.
llHTTPRequest("https://<YOUR REGION HOST>.agni.lindenlab.com:12043/cap/<YOUR CAP HERE>",[HTTP_METHOD,"POST"],"<llsd><string>set accurate_terrain FALSE</string></llsd>");
Turn on/off Pathfinding
Must be estate power to do this: set dynamic_pathfinding [enabled|disabled]
Detailed instructions
- To open the console type:
CTRL + SHIFT + ` (CTRL + SHIFT + backtick) {{ENTER}}
- Turn off Pathfinding:
set dynamic_pathfinding disabled {{ENTER}}
restart {{ENTER}}
- Turn on Pathfinding:
set dynamic_pathfinding enabled {{ENTER}}
restart {{ENTER}}