restraint
ARES System Manual: restraint RLV Relay

NOTE: This help page describes a free add-on that must be downloaded and installed first. See http://support.nanite-systems.com/restraint for more information.

restraint on|off|toggle: Sets RLV relay behavior.
restraint auto on|off|toggle: Sets RLV relay autoaccept behavior.
restraint safeword <device UUID>: End an RLV session mediated by the relay.

The restraint RLV relay is the standard RLV relay for ARES units. It is a multi-source relay that respects system security settings.

The RLV relay uses the non-standard security rule restrain, which defaults to level 2 (consent required). For an explanation of how security in ARES works, see rules.

Note: if the unit has been self-banned, it will not be able to access most commands, including restraint safeword. Instead, use @safeword, a shortcut built into input.


Why use an RLV relay?

RLV is a viewer technology that allows objects owned by an avatar to directly affect that avatar's grid client in ways that are not supported by traditional viewers.

These effects (known as 'restrictions') generally involve loss of control on the part of the user. For example, while normal SL viewers can position the camera at a given set of coordinates, only RLV can prevent the user from moving the camera.

On its own, RLV works best with attachments worn by the avatar being restrained. However, with an RLV relay acting as an intermediary, devices such as furniture can also take advantage of RLV, enabling a much wider range of user experiences.


Unimplemented Features

restraint is not yet complete. In particular:

- It does not yet apply chat restrictions to the unit's captured speech (chat redirect) or captured hearing (see vox).
- Safewording cannot be disabled.

This entry will be updated as development progresses.

A variant package, restraint-debug, is available; this is the same code but with debug messages enabled. Do not install both at once.