Frequently Asked Questions
General
What is RLVa?
RLVa is an extended implementation of the RestrainedLove API (RLV) for Second Life, written by Kitty Barnett for the Catznip viewer. It provides all standard RLV functionality plus additional features.
What is the difference between RLV and RLVa?
RLV is the original implementation by Marine Kelley. RLVa is an extended implementation by Kitty Barnett. RLVa supports all RLV commands plus additional commands and features not found in standard RLV.
Which viewers support RLVa?
RLVa is supported by: Catznip, Alchemy, Black Dragon, Firestorm, Genesis, and Singularity.
Which viewers support RLV?
RLV is supported by: RestrainedLove, Cool VL Viewer, and Kokua.
Commands
How do I check if RLVa is active?
Use the version command: /2048 /version
If RLVa is active, you should see a response like: RestrainedLove viewer v2.9.29 (SL 7.1.10.757794)
How do I check my RLVa version?
Use: /2048 /versionnew
This returns the current version in the format RestrainedLove viewer v...
How do I check my RLVa version number?
Use: /2048 /versionnum
This returns the version as an integer (e.g., 2092900 for v2.9.29).
How do I clear all restrictions?
Use: @clear=force
This clears all restrictions and exceptions for the calling object.
How do I check current restrictions?
Use: @getstatus=2048
This returns a list of active restrictions from the calling object.
How do I check all restrictions?
Use: @getstatusall=2048
This returns all active restrictions from all objects.
Shared Folders
How do I set up shared folders?
- Create a folder named
#RLVdirectly under My Inventory - Place items in sub-folders under
#RLV - Rename items to include the attachment point name
Why can't I list items in #RLV?
Check that:
- The
#RLVfolder exists directly under My Inventory - Items are in sub-folders (not directly in
#RLV) - Folder names don't start with
.
Why can't I wear items from #RLV?
Check that:
- Items are in the
#RLVfolder - Item names contain the attachment point name
- The folder name is correct
- No
@unsharedwearrestrictions are active
How do I give items to someone's #RLV?
Use llGiveInventoryList() with the target folder:
llGiveInventoryList(target_id, "#RLV/~subfolder_name", list_of_items);
Camera Commands
How do I lock the camera to the avatar?
Use: @camunlock=n
This prevents the user from unlocking the camera from the avatar.
How do I set the camera distance?
Use: @camdistmax:n=n to set maximum distance, or @camdistmin:n=n to set minimum distance.
How do I force a specific FOV?
Use: @setcam_fov:n.n=force
This forces the camera to zoom to the specified FOV in radians.
Troubleshooting
RLVa commands are not working
- Ensure RLVa is enabled in Preferences > General
- Restart the viewer after enabling/disabling
- Check that the viewer supports RLVa
- Verify no
@setdebugrestrictions are blocking commands
Restrictions are not applying
- Check the command syntax (no spaces around
=) - Ensure the object is an attachment
- Verify the object is not nostrip
- Check for conflicting restrictions
Restrictions are not clearing
- Use
@clearto manually clear all restrictions - Check if another object has the same restriction
- Restart the viewer if issues persist
Camera commands are not working
- Check if
@camunlock=nis active - Ensure the viewer supports the specific camera command
- Verify the command syntax
See also: Configuration | Viewers