Avatar Communication

Send messages and present interactive prompts to avatars.

Feature: Communications

What do you want to do?

llDialog(key agent, string msg, list buttons, integer channel)Shows a dialog box on the screen of the specified agent, displaying msg along with up to 12 choice buttons. Clicking a button chats its label on channel. The chat originates at the object's position, but uses the agent's name and UUID, so it can be heard as long as the agent is still in the region.llInstantMessage(key agent, string msg)Sends an instant message containing msg to the agent identified by their key.llTextBox(key agent, string msg, integer channel)Opens an input text box dialog displaying msg to the agent. Submitting text chats the input string on channel as if said by the agent. The chat originates at the object's position, but uses the agent's name and UUID, so it can be heard as long as the agent is still in the region.

Reference

Find topic entries

19 topic entries

• llDialog(key agent, string msg, list buttons, integer channel)function

  Shows a dialog box on the screen of the specified agent, displaying msg along with up to 12 choice buttons. Clicking a button chats its label on channel. The chat originates at the object's position, but uses the agent's name and UUID, so it can be heard as long as the agent is still in the region.

• llEmail(string address, string subject, string msg)function

  Sends an email with the given destination address, subject, and body msg. The email will be sent from `{ll.GetKey()}@lsl.secondlife.com`. This can be used for script communication; see llGetNextEmail()

• llInstantMessage(key agent, string msg)function

  Sends an instant message containing msg to the agent identified by their key.

• integer llListen(integer channel, string name, key id, string msg)function

  Creates a listener on channel from name and id for msg. Returns an integer listener handle used to control or remove the listener. Empty strings or NULL_KEY filters do not filter on those parameters.

• llListenControl(integer handle, integer active)function

  Enables or disables the listener specified by the integer handle. If active is TRUE, the listener is activated; if FALSE, it is deactivated.

• llListenRemove(integer handle)function

  Completely removes the listener specified by the integer handle.

• llLoadURL(key avatar, string message, string url)function

  Shows a dialog box displaying message to the avatar avatar offering to open the specified url. Clicking yes launches the URL in their default web browser.

• llMapBeacon(string region_name, vector pos, list options)function

  Displays an in-world beacon and optionally opens the world map for the avatar touching or wearing the object, centered on region_name with pos highlighted. Only works for attached scripts or during touch events.

• llMapDestination(string simname, vector pos, vector look_at)function

  Opens the world map for the avatar touching or wearing the object, centered on simname with pos highlighted. Only works for attached scripts or during touch events. Note: look_at currently has no effect.

• integer llOpenFloater(string floater_name, string url, list params)function

  Opens the specified viewer floater_name loaded with url and configured via params. Returns an integer error code, or 0 if successful.

• llOwnerSay(string msg)function

  Sends the chat message msg privately to the object owner (the owner must be currently in the same region for the message to be received).

• llRegionSayTo(key target, integer channel, string msg)function

  Sends the message msg on Channel privately to the targeted agent or object (if within the region). If target is an agent and channel is non-zero, the message can also be heard by any attachments worn by the avatar.

• llSay(integer channel, string msg)function

  Broadcasts the message msg to all scripts or agents listening on channel within llGetEnv("chat_range"), which is 20m on most regions. Agents listen on PUBLIC_CHANNEL (0) and DEBUG_CHANNEL (2147483647). All other channels are for script-to-script communication.

• llSetText(string text, vector color, float alpha)function

  Displays floating text above the prim with the specified color vector and transparency alpha.

• llShout(integer channel, string msg)function

  Broadcasts the message msg to all scripts or agents listening on channel within llGetEnv("shout_range"), which is 100m on most regions. Agents listen on PUBLIC_CHANNEL (0) and DEBUG_CHANNEL (2147483647). All other channels are for script-to-script communication.

• llTargetedEmail(integer target, string subject, string msg)function

  Sends an email to with the given subject subject and body msg to the target (which can designate the owner or creator of the object). The email will be sent from `{ll.GetKey()}@lsl.secondlife.com`.

• llTextBox(key agent, string msg, integer channel)function

  Opens an input text box dialog displaying msg to the agent. Submitting text chats the input string on channel as if said by the agent. The chat originates at the object's position, but uses the agent's name and UUID, so it can be heard as long as the agent is still in the region.

• llWhisper(integer channel, string msg)function

  Broadcasts the message msg to all scripts or agents listening on channel within llGetEnv("whisper_range"), which is 10m on most regions. Agents listen on PUBLIC_CHANNEL (0) and DEBUG_CHANNEL (2147483647). All other channels are for script-to-script communication.

• listen(integer channel, string name, key id, string msg)event

  Triggered when a chat message matching active llListen filters is received on channel. Passes the sender's name and UUID key id, along with the spoken string msg.