Difference between revisions of "LSL Protocol/Restrained Love Open Relay Group/speech"
Dahlia Orfan (talk | contribs) (→Caveat) |
Dahlia Orfan (talk | contribs) (→speech) |
||
| Line 4: | Line 4: | ||
STATUS: draft | STATUS: draft | ||
version: | version: 002 | ||
'' | ''version 001 implemented in Dahlia's multirelay 1.3.7 and in AnythingRLV 3.9.30'' | ||
Two new commands !x-speech and !x-rename | Two new commands !x-speech and !x-rename | ||
| Line 17: | Line 17: | ||
The relay must answer "ok" and accepts this command only if the controller sending it is already accepted and if there is no other controller already renaming the wearer of the relay. Otherwise this command has no effect and the relay must answer "ko". | The relay must answer "ok" and accepts this command only if the controller sending it is already accepted and if there is no other controller already renaming the wearer of the relay. Otherwise this command has no effect and the relay must answer "ko". | ||
The string must be escaped using llEscapeURL() in the version 002 of the protocol. | |||
==Description of !x-speech== | ==Description of !x-speech== | ||
| Line 25: | Line 27: | ||
The relay must answer "ok" and accepts this command only if the controller sending it is already accepted. Otherwise this command has no effect and the relay must answer "ko". This setting is to avoid grieffers sending forced speech commands using a wildcard. | The relay must answer "ok" and accepts this command only if the controller sending it is already accepted. Otherwise this command has no effect and the relay must answer "ko". This setting is to avoid grieffers sending forced speech commands using a wildcard. | ||
The strings must be escaped using llEscapeURL() in the version 002 of the protocol. | |||
= Caveat = | = Caveat = | ||
The separators / (slash) and , (comma) are forbidden in the strings in parameters. A workaround is for the controller to escape the string to be sent using llEscapeURL() and for the relay to unescape it using llUnescapeURL(). | The separators / (slash) and , (comma) are forbidden in the strings in parameters. A workaround is for the controller to escape the string to be sent using llEscapeURL() and for the relay to unescape it using llUnescapeURL(). | ||
Revision as of 02:31, 26 September 2011
speech
STATUS: draft
version: 002
version 001 implemented in Dahlia's multirelay 1.3.7 and in AnythingRLV 3.9.30
Two new commands !x-speech and !x-rename
Description of !x-rename
- The syntax is !x-rename[/STRING[/FLOAT]]
The effect of !x-rename is to clear any previous setting (it is equivalent to !x-rename/clear which does not exist for obvious reasons). The effect of the command !x-rename/string is to rename the wearer of the relay for all messages and emotes sent to the local chat. The second optional parameter is the range (default: 20.0m). In a relay simulating several controllers, only one controller at a given time can rename the wearer.
The relay must answer "ok" and accepts this command only if the controller sending it is already accepted and if there is no other controller already renaming the wearer of the relay. Otherwise this command has no effect and the relay must answer "ko".
The string must be escaped using llEscapeURL() in the version 002 of the protocol.
Description of !x-speech
- The syntax is !x-speech/INTEGER/STRING[/FLOAT[/STRING]].
The effect of !x-speech/0/string is to force the avatar wearing the relay to say the string. The effect of !x-speech/1/string is to force the avatar wearing the relay to emote the string. The default range is the say range (default: 20.0m). The third optional parameter is the range. The fourth optional parameter is the name given to the wearer of this avatar for whispering/saying/shouting the string. If no fourth argument is given, the argument given in a previous accepted !x-rename will be taken, or the username of the wearer. Note that it is written username, not displayname. The controller can always force the displayname if necessary by adding it as fourth argument.
The relay must answer "ok" and accepts this command only if the controller sending it is already accepted. Otherwise this command has no effect and the relay must answer "ko". This setting is to avoid grieffers sending forced speech commands using a wildcard.
The strings must be escaped using llEscapeURL() in the version 002 of the protocol.
Caveat
The separators / (slash) and , (comma) are forbidden in the strings in parameters. A workaround is for the controller to escape the string to be sent using llEscapeURL() and for the relay to unescape it using llUnescapeURL().