Region Debug Console
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
chat_range
View or change the region's chat range.
Read-only
damage_limit
Maximum damage per damage event.
Read/Write
damage_throttle
The maximum number of points of damage a single source may inflict on a target per second.
Read/Write
death_action
Set the action to take when an avatar dies in the region.
0 = Teleport home
1 = Teleport to parcel landing point.
2 = Teleport to region telehub.
3 = No action
Read/Write
deny_bots
Set the estate 'deny bots' access option on or off.
Read/Write
dynamic_pathfinding
Enable/Disable pathfinding behaviors and navmesh updates. Requires a restart.
Read/Write
health_regen_rate
The speed of health regeneration in hitpoints per second.
Read/Write
invulnerability_time
Invulnerablity time applied after avatar death.
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
parcel_daylength
View or change the parcel's environmental day length (in minutes)
Read-only
parcel_dayoffset
View or change the parcel's environmental day offset (in minutes)
Read-only
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 unreserved avatar spaces available on this region.
Read-only
region_daylength
View or change the region environmental day length (in minutes)
Read-only
region_dayoffset
View or change the region environmental day offset (in minutes.)
Read-only
restore_health
Health is reset to 100 on death.
Read/Write
restrict_combat_log
Scripts are allowed to write to combat log.
Read/Write
shout_range
View or change the region's chat shout range.
Read-only
whisper_range
View or change the region's chat whisper range.
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.