Skip to content
lsl.devlsl.devLSL Dev

Category:Experience Tools

This is a historical wiki category. Explore the current topic guides →

LSL Header: {{LSL Header|ml=*}}
RightToc: {{RightToc}}Experience Tools provide a way to request persistent permissions across multiple logins and with multiple objects and scripts. In order to use these functions, you must have an experience key. For further information, see Experiences in Second Life in the Second Life Knowledge Base.
The Experience Tools API fall into three categories:

Experience Information

integer — llAgentInExperience(key agent)
list — llGetExperienceDetails(key experience_id)

Experience Permissions

event — experience_permissions(key agent)
event — experience_permissions_denied(key agent, integer reason)
void — llRequestExperiencePermissions(key agent, string name)

Experience Persistent Storage

The persistent storage of experiences can still be used even where the experience is not set up as an allowed experience.
Current limits for Persistent storage:
  • Each key may be a maximum of 1011 bytes
  • Each value may be a maximum of 4095 bytes
  • Total stored data is restricted to 128 MiB
These are all asynchronous functions, they all return a handle that corresponds to a dataserver event.
key — llReadKeyValue(string k)
key — llCreateKeyValue(string k, string v)
key — llUpdateKeyValue(string k, string v, integer checked, string original_value)
key — llDeleteKeyValue(string k)

Debugging

key — llDataSizeKeyValue() — Gets the number of bytes used by the experience along with the experience's byte quote
key — llKeysKeyValue(integer start, integer count) — Gets the names of the keys
key — llKeyCountKeyValue() — Gets the number of keys
string — llGetExperienceErrorMessage(integer value) — Converts an integer error code to a wordy string representation
LSL Constant Message returned via llGetExperienceErrorMessage Description
XP_ERROR_NONE 0 no error No error was detected.
XP_ERROR_THROTTLED 1 exceeded throttle The call failed due to too many recent calls.
XP_ERROR_EXPERIENCES_DISABLED 2 experiences are disabled The region currently has experiences disabled.
XP_ERROR_INVALID_PARAMETERS 3 invalid parameters One of the string arguments was too big to fit in the key-value store.
XP_ERROR_NOT_PERMITTED 4 operation not permitted Experience permissions were denied by the user.
XP_ERROR_NO_EXPERIENCE 5 script not associated with an experience This script is not associated with an experience.
XP_ERROR_NOT_FOUND 6 not found The sim was unable to verify the validity of the experience. Retrying after a short wait is advised.
XP_ERROR_INVALID_EXPERIENCE 7 invalid experience The script is associated with an experience that no longer exists.
XP_ERROR_EXPERIENCE_DISABLED 8 experience is disabled The experience owner has temporarily disabled the experience.
XP_ERROR_EXPERIENCE_SUSPENDED 9 experience is suspended The experience has been suspended by Linden Lab customer support.
XP_ERROR_UNKNOWN_ERROR 10 unknown error An unknown error not covered by any of the other predetermined error states.
XP_ERROR_QUOTA_EXCEEDED 11 experience data quota exceeded An attempt to write data to the key-value store failed due to the data quota being met.
XP_ERROR_STORE_DISABLED 12 key-value store is disabled They key-value store is currently disabled on this region.
XP_ERROR_STORAGE_EXCEPTION 13 key-value store communication failed Unable to communicate with the key-value store, or attempted to create key that already exists
XP_ERROR_KEY_NOT_FOUND 14 key doesn't exist They requested key does not exist.
XP_ERROR_RETRY_UPDATE 15 retry update A checked update failed due to an out of date request.
XP_ERROR_MATURITY_EXCEEDED 16 experience content rating too high The content rating of the experience exceeds that of the region.
XP_ERROR_NOT_PERMITTED_LAND 17 not allowed to run on this land The experience is blocked or not enabled for this land.
XP_ERROR_REQUEST_PERM_TIMEOUT 18 experience permissions request timed out The request for experience permissions was ignored.
Original wiki source

Some wiki templates and tables need their original context. View this article on the Second Life Wiki. Technical wording and examples are retained from the source; historical guidance may differ from current behavior.