Skip to content

Viewer Control Commands

Commands controlling viewer settings and environment.

Debug Settings

@setdebug

@setdebug=<y/n>

Version: v1.16

Prevents changing viewer debug settings. Uses a whitelist approach — only a few settings are locked.

@setdebug

@setdebug_<setting>:<value>=force

Version: v1.16

Forces a specific debug setting to a value.

Available settings:

Setting Values Description
AvatarSex 0 (Female), 1 (Male) Gender at creation
RenderResolutionDivisor 1+ Screen "blurriness" (Windlight only)

@getdebug

@getdebug_<setting>=<channel_number>

Version: v1.16

Returns the value of a debug setting.

Queryable settings:

Setting Description
AvatarSex Gender at creation
RenderResolutionDivisor Screen blurriness
RestrainedLoveForbidGiveToRLV Forbid give to #RLV
RestrainedLoveNoSetEnv Disable @setenv
WindLightUseAtmosShaders Windlight atmospheric shaders

Environment Settings

@setenv

@setenv=<y/n>

Version: v1.14

Prevents changing viewer environment settings (World > Environment Settings).

@setenv

@setenv_<setting>:<value>=force

Version: v1.14

Forces a specific environment setting. Silently discarded if @setenv restriction is active (but ignored if issued by the same object).

Available settings:

Setting Values Description
daytime 0.0-1.0, <0 for default Time of day
preset String Preset environment name
asset String Synonym for preset (v2.9.29)
reset - Reset to region default
ambientr/g/b 0.0-1.0 Ambient light RGB
ambientsi 0.0-1.0 Ambient light intensity
bluedensityr/g/b 0.0-1.0 Blue density RGB
bluehorizonr/g/b 0.0-1.0 Blue horizon RGB
cloudcolorr/g/b 0.0-1.0 Cloud color RGB
cloudcoverage 0.0-1.0 Cloud coverage
cloudx/y/d 0.0-1.0 Cloud offset and density
densitymultiplier 0.0-0.9 Fog density multiplier
distancemultiplier 0.0-100.0 Fog distance multiplier
hazedensity 0.0-1.0 Haze density
hazehorizon 0.0-1.0 Haze at horizon
maxaltitude 0.0-4000.0 Maximum fog altitude
moonazim 0.0-PI*2 Moon azimuth (radians)
moonelev -PI/2 to PI/2 Moon elevation (radians)
scenegamma 0.0-10.0 Overall gamma
starbrightness 0.0-2.0 Star brightness
sunazim 0.0-PI*2 Sun azimuth (radians)
sunelev -PI/2 to PI/2 Sun elevation (radians)
sunglowfocus 0.0-0.5 Sun glow focus
sunglowsize 1.0-2.0 Sun glow size
sunmooncolorr/g/b 0.0-1.0 Sun/moon color RGB

Synonyms (v2.9.29):

Original Synonym
asset preset
suntexture sunimage
sunazimuth sunazim
sunelevation sunelev
moontexture moonimage
moonazimuth moonazim
moonelevation moonelev
sunlightcolor sunmooncolor

@getenv

@getenv_<setting>=<channel_number>

Version: v1.15

Returns the value of an environment setting.

Note

Only @getenv_daytime is supported by v1.19.0 or older viewers. Other settings require Windlight.


Other Viewer Commands

@notify

@notify:<channel_number>[;word]=<rem/add>

Version: v1.20 (improved v2.2 / v1.24)

Repeats restriction changes on the specified channel. Optional ;word filters notifications.

Notification types:

Type Format Description
Restriction /restriction=n or /restriction=y Restriction applied/lifted
Inventory offer /accepted_in_rlv inv_offer <folder> Folder accepted and shared
Inventory offer /accepted_in_inv inv_offer <folder> Folder accepted but not shared
Inventory offer /declined inv_offer <folder> Folder declined
Wear /worn legally <layer> Clothing worn on layer
Unwear /unworn legally <layer> Clothing removed from layer
Attach /attached legally <attach_point> Object attached
Attach illegal /attached illegally <attach_point> Object attached but will be detached
Detach /detached legally <attach_point> Object detached
Detach illegal /detached illegally <attach_point> Object detached but will be reattached
Sit /sat object legally <UUID> Avatar sat on object
Unsit /unsat object legally <UUID> Avatar stood from object
Ground /sat ground legally Avatar sat on ground

@permissive

@permissive=<y/n>

Version: v1.21

When denied, all restrictions turn into secure counterparts. Exceptions from other objects are ignored.

@clear

@clear

Version: v1.0a (working since v1.04a)

Clears all restrictions and exceptions for the calling object's UUID.

@clear

@clear=<string>

Version: v1.0a (working since v1.04a)

Clears restrictions and exceptions containing the specified string.

@getstatus / @getstatusall

@getstatus[:<part_of_rule>[;<custom_separator>]]=<channel>
@getstatusall[:<part_of_rule>[;<custom_separator>]]=<channel>

Version: v1.10 (@getstatusall v1.15)

Returns current restrictions. @getstatus returns only restrictions from the calling object. @getstatusall returns all restrictions.


See also: Configuration | FAQ