Region Debug Console

From Second Life Wiki
(Redirected from SimConsole)
Jump to navigation Jump to search

The Command Console

The command console allows for a handful of region settings to be changed via text commands or http post operations from script.

You must be an estate manager to change the settings.

The console is opened in the viewer through the Develop > Consoles menu, or by pressing Ctrl+Shift ⇧+`. (` is the key with the tilde on it ~) The Region Debug Console can also be opened by a button on the World > Region/Estate > Debug window.

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.
      Unset               Returns a parameter to its built-in default. (Only available for certain parameters.)
      Parameters          List parameters 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.
  • Unset (command)
Syntax: unset <parameter>

Sets a parameter to its built-in default. Not all parameters have defaults
  • Help Parameters (Command)
    Syntax: help parameters

     You are authorized to access the following parameters in this region:

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

deny_bots
    Enable/disable estate-level access for identified scripted agents.
    Read/Write

dynamic_pathfinding
    Enable/Disable pathfinding behaviors and navmesh updates. Requires a restart.
    Read/Write

lures_obey_telehubs
    If true, teleport lures obey telehubs if they exist.
    Read/Write

optimize_terrain
    Allows estate managers to disable certain terrain optimizations and is provided only for backward compatibility. Defaults to true (optimization enabled). Requires a terrain edit or sim restart to take effect.
    Read/Write

population_bonusfactor
    The percentage of the region population reserved for premium accounts.
    Read-only

population_limit
    Sets the number of agents allowed into the region at one time.
    Read/Write

population_reserved
    The number of reserved avatar spaces available to premium accounts on this region.
    Read-only

population_status
    Display the population status 
    Read-only

population_unreserved
    The number of unreseverd avatar spaces available on this region.
    Read-only

Note : The above commands are subject to change, so use 'help parameters' to determine the active ccommands for the current region.

  • 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)


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.

To open the console

CTRL + SHIFT + `  (CTRL + SHIFT + backtick) {{ENTER}}
( on a Keyboard with a UK Keymap use: CTRL + SHIFT + @ )

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

Capability Documentation

Post to Capability: "SimConsole"

Post:

   <llsd><string>help</string></llsd>

Response:

   <llsd><string>Response</string></llsd>

Turn on/off Pathfinding

Must be estate power to do this: set dynamic_pathfinding [enabled|disabled]

  • Turn off Pathfinding:
set dynamic_pathfinding disabled {{ENTER}}
restart {{ENTER}}
  • Turn on Pathfinding:
 
set dynamic_pathfinding enabled {{ENTER}}
restart {{ENTER}}

Schedule region restarts

Private region owners and estate managers may schedule recurring restarts for their regions from the Region Debug Console. Restarts will occur on the scheduled days within a 10 minute window at the specified scheduled time. All scheduled times and days of the week are in the UTC (Coordinated Universal Time) timezone to match server time. (Included in simulator version 2024-03-18.8333615621 - earlier simulator versions will not support this command at this time.)

As with most Region Debug Console commands, help region_schedule entered in the Region Debug console window will show a list of command variables available and a basic explanation of how to use the command.

region_schedule {{ENTER}}
    Shows the currently scheduled region restarts for the specified region.

region_schedule set restart daily <HH:MM>    
    Sets the region to restart daily at the specified hour (HH) and minute (MM).

region_schedule set restart weekly <days> <HH:MM>    
    Sets the region to restart daily at the specified hour (HH) and minute (MM) on specific days of the week <days>. The days of the week are represented by a single letter abbreviation, as follows, and should be entered without spaces (ie, SMT for Sunday, Monday and Tuesday) or brackets:
        S = Sunday
        M = Monday
        T = Tuesday
        W = Wednesday
        R = Thursday
        F = Friday
        A = Saturday

region_schedule unset restart
    Clears any future scheduled restarts from the region.

Beta_Server_Office_Hours/Minutes/2010-10-07