LSL Protocol

From Second Life Wiki
Revision as of 10:13, 26 February 2010 by Marine Kelley (Talk | contribs)

Jump to: navigation, search

Script protocols and known chat channels

Some times, scripts in Second Life send messages to one another to exchange information or coordinate behavior. The rules for that conversation are a protocol. Being able to say "/1show" or "/1hug lee" are examples.

Such protocols use a common chat channel. The examples above use channel 1. They could just as easily have used any other number, but a user (and other objects) have to have some way to find the correct number.

Some protocols, such as combat systems, are quite complicated and could be better documented. This page can be used to help prevent conflicts and allow multiple programmers to coordinate the protocol definitions.

Protocols can also be note card systems and systems that use object names.

Protocol list

Add a protocol here if it is widely used, or might be sometime in the future.

A protocol in this list should also have its own pages where the protocol is defined in some detail.

Name Creator Description
Cool Hud Henri Beauchamp Universal Hud protocol.
ListMessage Anonymous Send and receive lists, non-lists, non-results, verb-not-found, and partially evaluated Polish expressions.
LockMeister System Kyrah Abattoir Used to coordinate different parts of bondage toys.
LSL Protocol/EasyTalk Salahzar Stenvaag |Very Easy and simple communication protocol. Use it to simply coordinate llSay/llRegionSay/llListen objects, as well as linked set
RestrainedLove viewer API Marine Kelley Use the features of the RestrainedLove viewer through llOwnerSay() calls.
RestrainedLove viewer relay spec Marine Kelley Allow your furniture or cages to issue commands to the user's RestrainedLove viewer
RestrainedLife viewer open relay spec Open Relay Group A superset of the RestrainedLife viewer relay spec with useful extensions created and maintained by the community.
P Vendor Linked Messages API & Environment Zep Palen Allows an owner of the P Vendor system to develope custom vendors and use the API for input/output
Script API Nexii Malthus A protocol to provide a useful communication layer between LSL scripts and supported clients, as well as a useful and purposeful feature set. (Vertical Life and Plywood clients currently)

Known chat channels

This list is intended to reduce the number of scripts using the same chat channel number. Please try and keep them in sequence.

Channel Creator Description Messages
1, 4, 5, 9 Unknown Very common in poseballs "hide", "show"
4 Mo Noel Default channel for chat redirection like in gags or other voice manipulating tools
5 Psistorm Ikura PsiCorp Products
6 grumble Loudon pre-appended text and say it. "/6 hello" becomes "/me Lion says: hello"
8 Henri Beauchamp Cool Collar command channel
9 DCS And Most Modern SLRPG Frame Works Command channel for user commands for Combat Systems/ SLRPG Frameworks like DCS /9on /9 reset /9<power> etc
10 ACE BnT/IntLibber Brautigan Ancapistan Capital Exchange ATM user interface channel "balance","withdraw","help"
11 Mo Noel Default channel of chat command interface of MoDesign products
12 Unknown title and status of damage meter (combat system)
20 Unknown SafeZone interface (combat system)
22 Henri Beauchamp Cool Cuffs command channel
22 unknown OOC Textiness. Says what you type.
22 Corvan Nansen Chat Enhancer. Out Of Character speech.
33 Henri Beauchamp Cool Nipples command channel
33 unknown Collar
35 Corvan Nansen Chat Enhancer Command channel.
36 Corvan Nansen Ultimate Titler Command channel.
42 unknown Common channel used by wiki example scripts
42, 55, 66, 77 Psistorm Ikura Aventity avatar scripts
44 Corvan Nansen Chat Enhancer. In Character speech.
45, 54 Ilobmirt Tenk FOSSL Vending System Client/Server default command channel
55 Henri Beauchamp Cool Chastity Belt command channel
63 FlipperPA Peregrine FlipTitle and "Flip mod" Franimation commands
66 Travis Lambert BanLink default chat command channel
66 Henri Beauchamp Cool Diaper command channel
66 Corvan Nansen Chat Enhancer. In Character emotes.
69 Henri Beauchamp Cool Penis & Cool Pussy command channel
77 Marine Kelley Real Restraints and similar BDSM equipment
77 Xarrk Dagger KAIIA Systems devices default chat command channel
88 Cadroe Murphy Used by ShapeGen and other building tools
88 Corvan Nansen Chat Enhancer. Narration channel.
88 Sharie Criss Owners plugin for Marine Kelley's Real Restraint equipment. Chat command channel.
99 unknown Dance Bracelets
100 Mo Noel Channel used to ask the user for chat line entries from within usual dialog sessions
100-999 (Randomly chosen periodically) Corvan Nansen Ultimate Titler. Title setting channel.
-666 Dimentox Travanti DCS: Unit to Hud Status Update Channel
777 Hank Ramos Universal Translator: channel to allow users to open a dialog-box using a chat command on channel #777. Only accepted command on this channel is "translator" and all other chat is ignored. Allows user to silently bring up dialog by hiding command as "/777 translator".
888 Xarrk Dagger KAIIA Systems device identification channel
2776 Tdub Dowler, Riden Blaisdale Used for transmitting a csv list of keys for use in sim wide radars
9001, 908070 Mystical Cookie MystiTool gesture commands, patch installers
10748, -10748 Lee Ponzu Commonly used in scripts by Ponzu
31984 Coraa Prior ACME interface (combat system)
-8888 Kyrah Abattoir LockMeister communications channel
-9119 Lillani Lowell LockGuard communications channel
-426956 Ganymede Ceriaptrix Ganymedia Open Cryptographic Exchange Protocol (GOCEP): Key Exchange Channel. Used primarily by Ganymedia Kryptonaut for most operations. Exchanges are in undelimited hexadecimal octets, in RFC 791 Appendix B network byte order. RFC 2631/RFC 4419 Diffie-Hellman Key Encryption Key (KEK) client-server and peer-to-peer public key exchange. Content Encryption Keys (CEKs) are wrap-encrypted via a RFC 4345 compliant IETF-ID Kaukonen ARCFOUR cipher implementation. Blocks split across n messages, where 0 <= n < 256; sequence number n is declared in the first bytefield of each message. The payload of each message is 256 octets (512 hex characters) in maximum length. Note: Region-wide messages used.
-426957 Ganymede Ceriaptrix Ganymedia Open Cryptographic Exchange Protocol (GOCEP): Encrypted Messaging Channel. Used primarily by Ganymedia Kryptonaut during SecureMessage (2-participant cryptstream chat), SecureGroupMessage (multi-participant cryptstream chat), ServerRelay (shared cryptstream server-side relay) and NotInZindra (Adult Content Policy circumvention bus encrypt/decrypt) modes of the state model. Exchanges are in undelimited hexadecimal octets, in RFC 791 Appendix B network byte order. Once a Content Encryption Key (CEK) has been negotiated via the RFC 2631/RFC 4419 Diffie-Hellman protocol on channel -426956, message data is exchanged client-server and/or peer-to-peer, via a RFC 4345 compliant IETF-ID Kaukonen ARCFOUR cipher implementation. Blocks split across n messages, where 0 <= n < 256; sequence number n is declared in the first bytefield of each message. The payload of each message is 256 octets (512 hex characters) in maximum length. Note: Region-wide messages used.
-504xxx Gal Canning only whispered inter-prim communication
-888888 Henri Beauchamp Cool Hud communications channel
-2766532 Hank Ramos Universal Translator: "back-channel" for inter-translator communications. This is an encrypted channel that passes translation and command-control messages between translators that are linked together to spread the translation load and HTTP communications.
-23000xxxx Cyphr Bellic Default BelliCorp public safety communications. Typically encrypted. UsesRegionSay. User may change some channels, however some are hardcoded.
-1812221819 Marine Kelley RestrainedLife relay communications channel