Region Debug Console

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>");

Beta_Server_Office_Hours/Minutes/2010-10-07