RLVa 2.0 Release Notes

From Catznip
Revision as of 19:25, 21 June 2016 by Trinity Dejavu (talk | contribs) (Created page with " ==Legacy RLVa command formalization== * @findfolders:<filter>[;<separator>]=<channel> - Similar to {{RLVaCommand|@findfolders||}} but will return all matches rather only the...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Legacy RLVa command formalization

  • @findfolders:<filter>[;<separator>]=<channel> - Similar to @@findfolders but will return all matches rather only the first
  • @getcommand[:<behaviour>[;<type>[;<separator>]]]=<channel> - Can be used to query whether a command is supported and currently enabled (see documentation for more details)
  • @getdebug - Can be used to query (but not set) the following additional debug settings: RestrainedLoveforbidGiveToRLV, RestrainedLoveNoSetEnv and WindLightUseAtmosShaders.
  • @interact=<n|y> - Blocks world interaction but allows drag-drop, the camera tool, mouse steering and access to the "self" context menu
  • @sharedwear=<n|y> - Counterpart to @unsharedwear wear locks the shared ♯RLV Folder
  • @unsharedwear=<n|y> - Counterpart to @unsharedunwear remove locks the shared ♯RLV Folder
  • @touchhud[:<object>]=<n|y> - Prevents the user from being able to touch their worn HUD attachments (with exceptions)
  • @tprequest[:<agent>]=<n|y> - Prevents the user from requesting teleports from anyone except those that are on the exception list (has strict variant)
  • @accepttprequest[:<agent>]=<n|y> - When used without an option all incoming teleport requests will be auto-accept; when used with a specific key that person's incoming teleport requests will be auto-accepted (has strict variant)

New commands

  • @sendgestures=<n|y> - Blocks the user from sending/playing gestures
  • @sendchannel_except[:<channel>]=<n|y> - Similar to @sendchannel[:<channel>] allows the user to chat on all channels except those defined as exceptions (cumulative with @sendchannel)
  • @showself=<n|y> - Hides the user's avatar and all their attachments (only on their screen); intended to be used alongside camera origin locking
  • @showselfhead=<n|y> - Hides only the user's avatar's head and all its attachments (only on their screen); intended to be used alongside camera origin locking
  • @tplocal=<n|y> - Restricts local teleports (though double click or location teleports) without impacting sit distance

Command extensions

  • @detachthis:<uuid>=force - Force-detaches an attachment (and its containing folder) by UUID (if it's contained under the shared #RLV folder)
  • @fartouch:<dist>=n|y - @fartouch restricts the user with the specified distance (rather than the default 1.5m)
  • @recvim:<min-dist>[;<max-dist>]=n|y - User can only receive IMs from people that are within the specified range (see documentation for examples)
  • @remattach:<uuid>=force - Force-detaches an attachment by UUID
  • @sendim:<min-dist>[;<max-dist>]=n|y - User can only send IMs to people that are within the specified range (see documentation for examples)
  • @startim:<min-dist>[;<max-dist>]=n|y - User can only start IM sessions with people that are within the specified range (see documentation for examples)
  • @sittp:<dist>=n|y - @sittp restricts the user with the specified distance (rather than the default 1.5m)
  • @shownames:<uuid>=n|y - Allows @shownames exceptions (all names are anonymized except those on the exception list)
  • @shownametags:<uuid>=n|y - Allows @shownametags exceptions (all tags are hidden except those on the exception list)
  • @tplocal:<dist>=n|y - allows local teleports only within the specified distance (256m by default)
  • @tpto:<position>;<lookat>=force - Teleports the user to the specified global coordinates with the specified rotation on arrival (in radians)
  • @tpto:<region>/<vector3>[;<lookat>]=force - Teleports the user to the specified coordinates on the region (alternative to providing global coordinates)

Camera commands

  • @setcam=<n|y> - Gives an object exclusive control over the camera (only this object's restrictions or limits will be enforced)
  • @setcam_avdistmin[:<distance>]=<n|y> - Enforces a minimum distance between the camera position and the user's avatar (in m)
  • @setcam_avdistmax[:<distance>]=<n|y> - Enforces a maximum distance between the camera position and the user's avatar (in m)
  • @setcam_origindistmin[:<distance>]=<n|y> - Enforces a minimum distance between the (default) camera origin and the camera position (see documentation)
  • @setcam_origindistmax[:<distance>]=<n|y> - Enforces a maximum distance between the (default) camera origin and the camera position (see documentation
  • @setcam_eyeoffset[:<vector3>]=<n|y> - Sets the default camera origin offset (see documentation)
  • @setcam_focusoffset[:<vector3>]=<n|y> - Sets the default camera focus offset (see documentation)
  • @setcam_focus:<uuid>|<position>[;<dist>[;<direction>]]=force - Moves the camera focus and origin to the specified position (by object/avatar UUID or coordinates) - see documentation for more information
  • @setcam_fov[:<angle>]=force - Sets the camera's (vertical) field of view to the specified angle (in radians)
  • @setcam_fovmin[:<angle>]=<n|y> - Enforces a minimum angle (in radians) for the camera's (vertical) field of view
  • @setcam_fovmax[:<angle>]=<n|y> - Enforces a maximum angle (in radians) for the camera's (vertical) field of view
  • @setcam_mode[:<mouselook>|<thirdperson>|<reset>]=force - Switches the current mode to mouselook, third person or resets it to the default view (same as user hitting <esc>)
  • @setcam_mouselook=<n|y> - Prevents the user from going into mouselook
  • @setcam_textures[:<uuid>]=<n|y> - Replaces all textures with the specified texture (or the default grey texture if unspecified)
  • @setcam_unlock=n - Locks the camera origin to the user's avatar (same as @setcam_origin:<uuid>=n)
  • @getcam_avdistmin=<channel> ; @getcam_avdistmax=<channel> ; @getcam_fovmin=<channel> ; @getcam_fovmax=<channel> and @getcam_textures=<channel> - Returns the respecitive actively imposed limit (or blank if no limit)
  • @getcam_avdist=<channel> - Returns the current distance between the camera position and the user's avatar (in m)
  • @getcam_fov=<channel> - Returns the camera's current (vertical) field of (in radians)

Miscellanaeous

  • RLVa / Console - command console for RLV (note: closing the floater clears all set restrictions and exceptions); use 0 as the channel to output to the console (e.g. @version=0)

Formalized RLVa changes (not necessarily new to this version):

  • force wear commands will activate/deactivate gestures as well
  • force wear commands will collect from folder links as well
  • double click teleporting is subject to @sittp (and the new @tplocal command)

Bug fixes

  • fixed : Location on incoming teleport requests isn't censored when @showloc restricted
  • fixed : Message on outgoing teleport offers isn't censored when @startim restricted
  • fixed : Message on outgoing teleport requests isn't censored when @sendim or @startim restricted
  • fixed : Can't buy objects when @edit restricted
  • fixed : RlvAttachmentLocks::updateLockedHUD() isn't disabling wireframe mode properly
  • fixed : Exception shows an avatar's UUID rather than their name if they're nearby
  • fixed : Auto-pilot isn't subject to local teleport restrictions
  • fixed : "Pay" isn't disabled on the avatar context menu when @shownames restricted

Compatibility shims (@setcam_xxx variants are preferred)

  • @camdistmin maps to @setcam_avdistmin
  • @camdistmax maps to @setcam_avdistmax
  • @camtextures maps to @setcam_textures
  • @camunlock maps to @setcam_unlock
  • @camzoommin maps to @setcam_fovmin with angle = 60° / multiplier
  • @camzoommax maps to @setcam_fovmax with angle = 60° / multiplier