Camera & View Commands

Commands controlling camera behavior and view restrictions.

Source

Based on Camera Commands from the Catznip Wiki and RLV API Specification.

Icon Legend

🧪 Experimental in RLVa — requires RLVaExperimentalCommands setting (enabled by default in Firestorm/Alchemy). Standard in RLV (Kokua). · ⚠️ Deprecated — will be removed in future versions · Version info shown inline after each heading.

@setcam — Camera Lock

@setcam=<n|y>

RLVa-only

Only one object can hold this lock at a time. When an object holds the lock, all camera commands from all other objects are ignored. When released, all other camera behaviors are restored.

Debug output shows "locked" as the failure message on subsequent attempts.

Camera Positioning (RLVa)

@setcam_eyeoffset

@setcam_eyeoffset[:<vector3>]=force

RLVa-only

Changes the default camera offset (same effect as changing the CameraOffsetRearView debug setting, but without modifying the setting).

Example: Move camera further back and slightly up:

@setcam_eyeoffset:-2/-0.4/-0.2=force

Restore default:

@setcam_eyeoffset=force

@setcam_focus 🧪

@setcam_focus<agent|object|position>[;<distance>;<direction>]=force

RLVa — requires RLVaExperimentalCommands (Firestorm 7.2.5.81383).

Moves the camera and focus to the specified position. The user can still change focus afterwards.

Parameters:

Parameter	Type	Description
UUID or position	string	UUID of object/agent to focus on, OR a position vector (region coordinates)
distance	float	Optional. Camera distance to focus. If omitted, calculated from object size
direction	vector	Optional. Normalized directional vector. If omitted, uses current camera

Examples:

Focus on an agent from 20m away:

@setcam_focus:<agent_uuid>;20;=force

Focus on an object (camera looks along negative X):

@setcam_focus:<object_uuid>;;1/0/0=force

Focus on a location (camera at <128,128,75> looking down):

@setcam_focus:128/128/75;;0/0/1=force

@setcam_focusoffset

@setcam_focusoffset[:<vector3>]=force

RLVa-only

Changes the default camera focus offset (same effect as changing the FocusOffsetRearView debug setting).

Example:

@setcam_focusoffset:0.9/-0.7/0.2=force

Restore default:

@setcam_focusoffset=force

@setcam_eyeoffsetscale

@setcam_eyeoffsetscale=<y/n>
@setcam_eyeoffsetscale=<value>=force

RLVa-only

Controls the eye offset scale parameter.

Camera Zoom

@camzoommax ⚠️

@camzoommax:<max_multiplier>=<y/n>

v2.9 — deprecated in Firestorm 7.2.5.81383. Use @setcam_fovmax instead.

Prevents zooming in beyond <max_multiplier> (default: 1.0). Multiple objects: retains smallest value.

@camzoommin ⚠️

@camzoommin:<min_multiplier>=<y/n>

v2.9 — deprecated in Firestorm 7.2.5.81383. Use @setcam_fovmin instead.

Prevents zooming out beyond <min_multiplier> (default: 1.0). Multiple objects: retains highest value.

@setcam_fovmin

@setcam_fovmin:<angle>=<n|y>

v2.9.20

Limit the user's FOV angle to a minimum value (angle in radians). Setting @setcam_fovmin and @setcam_fovmax to the same value locks the FOV.

Example: Set minimum FOV to 45°:

@setcam_fovmin:0.780=n

@setcam_fovmax

@setcam_fovmax:<angle>=<n|y>

v2.9.20

Limit the user's FOV angle to a maximum value (angle in radians). Setting @setcam_fovmin and @setcam_fovmax to the same value locks the FOV.

Example: Set maximum FOV to 90°:

@setcam_fovmax:1.57=n

@setcam_fov 🧪

@setcam_fov:<angle>=force

v2.9.20 — requires RLVaExperimentalCommands (Firestorm 7.2.5.81383).

Forces the camera to zoom to a specific FOV value (angle in radians). Does not restrict further zooming.

Camera Distance

@camdistmax

@camdistmax:<max_distance>=<y/n>

v2.9

Prevents moving the camera too far from the avatar. Setting to 0 forces mouselook. Multiple objects: retains smallest value.

@setcam_avdistmax

@setcam_avdistmax:<max_distance>=<y/n>

v2.9.20

Synonym for @camdistmax.

@camdistmin

@camdistmin:<min_distance>=<y/n>

v2.9

Prevents moving the camera too close to the avatar. Values > 0 force mouselook exit. Multiple objects: retains highest value.

@setcam_avdistmin

@setcam_avdistmin:<min_distance>=<y/n>

v2.9.20

Synonym for @camdistmin.

Visual Effects (RLV)

@camdrawmin / @camdrawmax

@camdrawmin:<min_distance>=<y/n>
@camdrawmax:<max_distance>=<y/n>

v2.9

Creates concentric spheres with increasing opacity from @camdrawmin to @camdrawmax.

Note

For better visual effects, consider using @setsphere instead — see Visual Effects (@setsphere).

@camdrawalphamin / @camdrawalphamax

@camdrawalphamin:<min_alpha>=<y/n>
@camdrawalphamax:<max_alpha>=<y/n>

v2.9

Controls opacity range for the visual fog effect.

@camdrawcolor

@camdrawcolor:<red>;<green>;<blue>=<y/n>

v2.9

Sets the fog color (values 0.0-1.0). Multiple objects: colors are mixed.

Camera Lock

@camunlock

@camunlock=<y/n>

v2.9

Prevents unlocking the camera from the avatar (no Alt focus or orbit).

@setcam_unlock

@setcam_unlock=<y/n>

v2.9.20

Synonym for @camunlock.

Other Camera Commands

@setcam_avdist

@setcam_avdist:<distance>=<y/n>

RLVa

Sets the silhouette distance — the distance at which nearby avatars turn into pitch-black silhouettes. This is a modifier that can be stacked (highest value wins).

@camavdist

@camavdist:<distance>=<y/n>

v2.9

Makes avatars beyond specified distance appear visually muted (pitch black).

@camtextures

@camtextures[:texture_uuid]=<y/n>

v2.9 (UUID parameter added in v2.9.20)

Ignores all world textures except avatar attachments, skins, and clothes. Materials are untouched. Optional UUID displays that texture everywhere instead of gray.

@setcam_textures

@setcam_textures[:texture_uuid]=<y/n>

v2.9.20

Synonym for @camtextures.

Camera Queries 🧪

All camera query commands require RLVaExperimentalCommands (Firestorm 7.2.5.81383). Commands marked RLV-only are not available in RLVa viewers.

Command	Description
`@getcam_avdistmin=<channel>`	Get minimum camera distance
`@getcam_avdistmax=<channel>`	Get maximum camera distance
`@getcam_fovmin=<channel>`	Get minimum FOV
`@getcam_fovmax=<channel>`	Get maximum FOV
`@getcam_fov=<channel>`	Get current FOV
`@getcam_avdist=<channel>`	Get current camera-avatar distance
`@getcam_textures=<channel>`	Get current forced texture UUID
`@getcam_zoommin=<channel>`	Get minimum zoom level (RLV only — Kokua)
`@getcam_zoommax=<channel>`	Get maximum zoom level (RLV only — Kokua)
`@getcam_zoom=<channel>`	Get current zoom level (RLV only — Kokua)

RLVa-Specific Camera Commands

RLVa-specific

These commands are unique to RLVa and not available in standard RLV (Kokua).

@setcam_mouselook

@setcam_mouselook=<y/n>

Controls mouselook behavior.

@setcam_mode 🧪

@setcam_mode=<y/n>
@setcam_mode=<value>=force

RLVa — requires RLVaExperimentalCommands (Firestorm 7.2.5.81383).

Controls the camera mode.

@setcam_origindistmin / @setcam_origindistmax 🧪

@setcam_origindistmin=<y/n>
@setcam_origindistmax=<y/n>

RLVa — requires RLVaExperimentalCommands (Firestorm 7.2.5.81383).

Controls the focus distance limits.

Examples

Change 3rd Person Camera Position

Move camera further back and slightly up (as detailed in Penny Patton's A Matter of Perspective):

@setcam_eyeoffset:-2/-0.4/-0.2=force
@setcam_focusoffset:0.9/-0.7/0.2=force

Restore Default Camera

@setcam_eyeoffset=force
@setcam_focusoffset=force

Or if using @setcam lock:

@setcam=y