From b780ceee6261304c0649e95318481afa9fd2ee2d Mon Sep 17 00:00:00 2001 From: Suzanna Linn Date: Tue, 21 Jul 2026 16:45:35 +0200 Subject: [PATCH 1/2] Adding dataserver return data Adding dataserver return data for the asynchronous functions. --- lsl_definitions.yaml | 158 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 158 insertions(+) diff --git a/lsl_definitions.yaml b/lsl_definitions.yaml index 433fe153..43fefe9d 100644 --- a/lsl_definitions.yaml +++ b/lsl_definitions.yaml @@ -1692,11 +1692,18 @@ constants: Pacific Time (not UTC). type: integer value: 3 + dataserver-semantics: + value-type: string + tooltip: Account creation/"born on" date as a string in an ISO 8601 format of + YYYY-MM-DD. DATA_NAME: member-of: [AgentData] tooltip: Used with llRequestAgentData to return the requested agent's legacy name. type: integer value: 2 + dataserver-semantics: + value-type: string + tooltip: Requested agent's legacy name. DATA_ONLINE: member-of: [AgentData] tooltip: "Used with llRequestAgentData to return whether the requested agent is @@ -1704,6 +1711,9 @@ constants: offline)." type: integer value: 1 + dataserver-semantics: + value-type: boolean + tooltip: If the requested agent is online. DATA_PAYINFO: member-of: [AgentData] tooltip: Used with llRequestAgentData to return a string containing the integer @@ -1711,6 +1721,10 @@ constants: PAYMENT_INFO_USED, or both). type: integer value: 8 + dataserver-semantics: + value-type: integer + enum: AgentDataPaymentInfo + tooltip: Mask flag for payment status. DATA_RATING: member-of: [AgentData] tooltip: Deprecated. Used with llRequestAgentData to return the string '0, 0, 0, @@ -1719,6 +1733,13 @@ constants: removed from SL. type: integer value: 4 + deprecated: + reason: Ratings were removed from SL. + dataserver-semantics: + value-type: string-csv + tooltip: "Returns [0, 0, 0, 0, 0, 0]. Used to return: [pos_behavior, + neg_behavior, pos_appearance, neg_appearance, pos_building, + neg_building]." DATA_RESERVED_0: member-of: [AgentData] tooltip: Reserved for Linden use. @@ -1730,18 +1751,29 @@ constants: as a vector. type: integer value: 5 + dataserver-semantics: + value-type: vector + tooltip: Region's global position. DATA_SIM_RATING: member-of: [SimulatorData] tooltip: Used with llRequestSimulatorData to return the simulator rating string ('PG', 'MATURE', 'ADULT', or 'UNKNOWN'). type: integer value: 7 + dataserver-semantics: + value-type: string + enum: SimulatorDataRating + tooltip: Simulator rating. DATA_SIM_STATUS: member-of: [SimulatorData] tooltip: Used with llRequestSimulatorData to return the simulator status as a string. type: integer value: 6 + dataserver-semantics: + value-type: string + enum: SimulatorDataStatus + tooltip: Simulator status. DEBUG_CHANNEL: member-of: [Channel, ChannelNonPublic] tooltip: A chat channel reserved for script debugging and error messages. @@ -9374,6 +9406,20 @@ functions: - dataserver - experience - experience_data + dataserver-semantics: + value-type: string-csv + error-semantics: true + values: + - name: success + value-type: boolean + tooltip: A boolean specifying if the transaction succeeded or not. + - name: value + value-type: string + tooltip: Value for the key-value pair. Maximum 4095 characters, or 2047 if using + LSO2. Note! This value may contain commas. + - name: error + value-type: ExperienceError + tooltip: An XP_ERROR_* flag that describes why the operation failed. llCreateLink: arguments: - target: @@ -9431,6 +9477,22 @@ functions: - dataserver - experience - experience_data + dataserver-semantics: + value-type: string-csv + error-semantics: true + values: + - name: success + value-type: boolean + tooltip: A boolean specifying if the transaction succeeded or not. + - name: used + value-type: integer + tooltip: Number of bytes used. + - name: quota + value-type: integer + tooltip: Number of bytes the key-store can utilize. + - name: error + value-type: ExperienceError + tooltip: An XP_ERROR_* flag that describes why the operation failed. llDeleteCharacter: arguments: [] energy: 10.0 @@ -9459,6 +9521,20 @@ functions: - dataserver - experience - experience_data + dataserver-semantics: + value-type: string-csv + error-semantics: true + values: + - name: success + value-type: boolean + tooltip: A boolean specifying if the transaction succeeded or not. + - name: value + value-type: string + tooltip: Value for the key-value pair. Maximum 4095 characters, or 2047 if using + LSO2. Note! This value may contain commas. + - name: error + value-type: ExperienceError + tooltip: An XP_ERROR_* flag that describes why the operation failed. llDeleteSubList: type-arguments: [T] arguments: @@ -10097,6 +10173,9 @@ functions: - data_storage - dataserver - notecard + dataserver-semantics: + value-type: integer + tooltip: Number of matches found for the given pattern. llFindNotecardTextSync: arguments: - name: @@ -11267,6 +11346,10 @@ functions: - data_storage - dataserver - notecard + dataserver-semantics: + value-type: string + tooltip: Line in the requested notecard, limited to 255 bytes. If EOF the line + requested is past the end of the notecard. llGetNotecardLineSync: arguments: - name: @@ -11304,6 +11387,9 @@ functions: - data_storage - dataserver - notecard + dataserver-semantics: + value-type: integer + tooltip: Number of lines in the notecard requested. llGetNumberOfPrims: arguments: [] energy: 10.0 @@ -12805,6 +12891,19 @@ functions: - dataserver - experience - experience_data + dataserver-semantics: + value-type: string-csv + error-semantics: true + values: + - name: success + value-type: boolean + tooltip: A boolean specifying if the transaction succeeded or not. + - name: pairs + value-type: integer + tooltip: Number of keys-value pairs in the key-value store. + - name: error + value-type: ExperienceError + tooltip: An XP_ERROR_* flag that describes why the operation failed. llKeysKeyValue: arguments: - first: @@ -12828,6 +12927,19 @@ functions: - dataserver - experience - experience_data + dataserver-semantics: + value-type: string-csv + error-semantics: true + values: + - name: success + value-type: boolean + tooltip: A boolean specifying if the transaction succeeded or not. + - name: keys + value-type: string-csv + tooltip: A list of keys (strings) used in the key-value store. + - name: error + value-type: ExperienceError + tooltip: An XP_ERROR_* flag that describes why the operation failed. llLinear2sRGB: arguments: - color: @@ -14710,6 +14822,20 @@ functions: - dataserver - experience - experience_data + dataserver-semantics: + value-type: string-csv + error-semantics: true + values: + - name: success + value-type: boolean + tooltip: A boolean specifying if the transaction succeeded or not. + - name: value + value-type: string + tooltip: Value for the key-value pair. Maximum 4095 characters, or 2047 if using + LSO2. Note! This value may contain commas. + - name: error + value-type: ExperienceError + tooltip: An XP_ERROR_* flag that describes why the operation failed. llRefreshPrimURL: arguments: [] deprecated: @@ -15063,6 +15189,8 @@ functions: categories: - avatar - dataserver + dataserver-semantics: + value-type: AgentData llRequestDisplayName: arguments: - id: @@ -15078,6 +15206,9 @@ functions: categories: - avatar - dataserver + dataserver-semantics: + value-type: string + tooltip: Agent's display name. llRequestExperiencePermissions: arguments: - agent: @@ -15115,6 +15246,11 @@ functions: categories: - dataserver - prim_inventory + dataserver-semantics: + value-type: vector + tooltip: A global position as an offset from the current region's origin + (<0,0,0>). To obtain the absolute global position of a landmark, add + llGetRegionCorner() to the vector. llRequestPermissions: arguments: - agent: @@ -15164,6 +15300,8 @@ functions: categories: - dataserver - region + dataserver-semantics: + value-type: SimulatorData llRequestURL: arguments: [] energy: 10.0 @@ -15192,6 +15330,9 @@ functions: - avatar - dataserver - uuid + dataserver-semantics: + value-type: key + tooltip: Agent's unique ID. llRequestUsername: arguments: - id: @@ -15207,6 +15348,9 @@ functions: categories: - avatar - dataserver + dataserver-semantics: + value-type: string + tooltip: "Agent's username (legacy format: \"first.last\")." llResetAnimationOverride: arguments: - anim_state: @@ -17979,6 +18123,20 @@ functions: - dataserver - experience - experience_data + dataserver-semantics: + value-type: string-csv + error-semantics: true + values: + - name: success + value-type: boolean + tooltip: A boolean specifying if the transaction succeeded or not. + - name: value + value-type: string + tooltip: Value for the key-value pair. Maximum 4095 characters, or 2047 if using + LSO2. Note! This value may contain commas. + - name: error + value-type: ExperienceError + tooltip: An XP_ERROR_* flag that describes why the operation failed. llVecDist: arguments: - vec_a: From 99e0592cd4169cee2c493cc718f957d63a38c8c8 Mon Sep 17 00:00:00 2001 From: Suzanna Linn Date: Wed, 22 Jul 2026 16:54:36 +0200 Subject: [PATCH 2/2] Moved "dataserver-semantics" right after "return" --- lsl_definitions.yaml | 186 +++++++++++++++++++++---------------------- 1 file changed, 93 insertions(+), 93 deletions(-) diff --git a/lsl_definitions.yaml b/lsl_definitions.yaml index 43fefe9d..9073efcc 100644 --- a/lsl_definitions.yaml +++ b/lsl_definitions.yaml @@ -9396,16 +9396,6 @@ functions: experience: true func-id: 387 return: key - sleep: 0.0 - tooltip: Starts an asynchronous transaction to create a key-value pair (k and v) - associated with the script's experience. Returns a key query handle for - the dataserver event. Fails with XP_ERROR_STORAGE_EXCEPTION if the key - already exists. - categories: - - data_storage - - dataserver - - experience - - experience_data dataserver-semantics: value-type: string-csv error-semantics: true @@ -9420,6 +9410,16 @@ functions: - name: error value-type: ExperienceError tooltip: An XP_ERROR_* flag that describes why the operation failed. + sleep: 0.0 + tooltip: Starts an asynchronous transaction to create a key-value pair (k and v) + associated with the script's experience. Returns a key query handle for + the dataserver event. Fails with XP_ERROR_STORAGE_EXCEPTION if the key + already exists. + categories: + - data_storage + - dataserver + - experience + - experience_data llCreateLink: arguments: - target: @@ -9468,15 +9468,6 @@ functions: experience: true func-id: 600 return: key - sleep: 0.0 - tooltip: Starts an asynchronous transaction to request the used and total data - storage allocated for the experience. Returns a key query handle for the - dataserver event. - categories: - - data_storage - - dataserver - - experience - - experience_data dataserver-semantics: value-type: string-csv error-semantics: true @@ -9493,6 +9484,15 @@ functions: - name: error value-type: ExperienceError tooltip: An XP_ERROR_* flag that describes why the operation failed. + sleep: 0.0 + tooltip: Starts an asynchronous transaction to request the used and total data + storage allocated for the experience. Returns a key query handle for the + dataserver event. + categories: + - data_storage + - dataserver + - experience + - experience_data llDeleteCharacter: arguments: [] energy: 10.0 @@ -9512,15 +9512,6 @@ functions: experience: true func-id: 390 return: key - sleep: 0.0 - tooltip: Starts an asynchronous transaction to delete the key-value pair - associated with key k in the experience. Returns a key query handle for - the dataserver event. - categories: - - data_storage - - dataserver - - experience - - experience_data dataserver-semantics: value-type: string-csv error-semantics: true @@ -9535,6 +9526,15 @@ functions: - name: error value-type: ExperienceError tooltip: An XP_ERROR_* flag that describes why the operation failed. + sleep: 0.0 + tooltip: Starts an asynchronous transaction to delete the key-value pair + associated with key k in the experience. Returns a key query handle for + the dataserver event. + categories: + - data_storage + - dataserver + - experience + - experience_data llDeleteSubList: type-arguments: [T] arguments: @@ -10165,6 +10165,9 @@ functions: func-id: 507 must-use: true return: key + dataserver-semantics: + value-type: integer + tooltip: Number of matches found for the given pattern. sleep: 0.0 tooltip: Searches the text of a cached notecard for lines containing the given pattern and returns the number of matches found through a dataserver @@ -10173,9 +10176,6 @@ functions: - data_storage - dataserver - notecard - dataserver-semantics: - value-type: integer - tooltip: Number of matches found for the given pattern. llFindNotecardTextSync: arguments: - name: @@ -11338,6 +11338,10 @@ functions: energy: 10.0 func-id: 217 return: key + dataserver-semantics: + value-type: string + tooltip: Line in the requested notecard, limited to 255 bytes. If EOF the line + requested is past the end of the notecard. sleep: 0.1 tooltip: Asynchronously requests the line index line of the notecard name from the dataserver. Returns a key query handle for the dataserver event, which @@ -11346,10 +11350,6 @@ functions: - data_storage - dataserver - notecard - dataserver-semantics: - value-type: string - tooltip: Line in the requested notecard, limited to 255 bytes. If EOF the line - requested is past the end of the notecard. llGetNotecardLineSync: arguments: - name: @@ -11380,6 +11380,9 @@ functions: energy: 10.0 func-id: 276 return: key + dataserver-semantics: + value-type: integer + tooltip: Number of lines in the notecard requested. sleep: 0.1 tooltip: Asynchronously requests the total line count of the notecard name. Returns a key query handle for the dataserver event. @@ -11387,9 +11390,6 @@ functions: - data_storage - dataserver - notecard - dataserver-semantics: - value-type: integer - tooltip: Number of lines in the notecard requested. llGetNumberOfPrims: arguments: [] energy: 10.0 @@ -12882,15 +12882,6 @@ functions: experience: true func-id: 601 return: key - sleep: 0.0 - tooltip: Starts an asynchronous transaction requesting the total count of keys - in the experience data store. Returns a key query handle for the - dataserver event. - categories: - - data_storage - - dataserver - - experience - - experience_data dataserver-semantics: value-type: string-csv error-semantics: true @@ -12904,6 +12895,15 @@ functions: - name: error value-type: ExperienceError tooltip: An XP_ERROR_* flag that describes why the operation failed. + sleep: 0.0 + tooltip: Starts an asynchronous transaction requesting the total count of keys + in the experience data store. Returns a key query handle for the + dataserver event. + categories: + - data_storage + - dataserver + - experience + - experience_data llKeysKeyValue: arguments: - first: @@ -12917,16 +12917,6 @@ functions: experience: true func-id: 602 return: key - sleep: 0.0 - tooltip: Starts an asynchronous transaction to retrieve count keys from the - experience data store starting at the zero-based index first. Returns a - key query handle for the dataserver event. Fails with - XP_ERROR_KEY_NOT_FOUND if out of bounds. - categories: - - data_storage - - dataserver - - experience - - experience_data dataserver-semantics: value-type: string-csv error-semantics: true @@ -12940,6 +12930,16 @@ functions: - name: error value-type: ExperienceError tooltip: An XP_ERROR_* flag that describes why the operation failed. + sleep: 0.0 + tooltip: Starts an asynchronous transaction to retrieve count keys from the + experience data store starting at the zero-based index first. Returns a + key query handle for the dataserver event. Fails with + XP_ERROR_KEY_NOT_FOUND if out of bounds. + categories: + - data_storage + - dataserver + - experience + - experience_data llLinear2sRGB: arguments: - color: @@ -14813,15 +14813,6 @@ functions: experience: true func-id: 388 return: key - sleep: 0.0 - tooltip: Starts an asynchronous transaction to read the value associated with - key k in the experience. Returns a key query handle for the dataserver - event. Fails with XP_ERROR_KEY_NOT_FOUND if the key does not exist. - categories: - - data_storage - - dataserver - - experience - - experience_data dataserver-semantics: value-type: string-csv error-semantics: true @@ -14836,6 +14827,15 @@ functions: - name: error value-type: ExperienceError tooltip: An XP_ERROR_* flag that describes why the operation failed. + sleep: 0.0 + tooltip: Starts an asynchronous transaction to read the value associated with + key k in the experience. Returns a key query handle for the dataserver + event. Fails with XP_ERROR_KEY_NOT_FOUND if the key does not exist. + categories: + - data_storage + - dataserver + - experience + - experience_data llRefreshPrimURL: arguments: [] deprecated: @@ -15182,6 +15182,8 @@ functions: energy: 10.0 func-id: 155 return: key + dataserver-semantics: + value-type: AgentData sleep: 0.1 tooltip: Asynchronously requests the specified data category (DATA_*) about the agent id. Triggers a dataserver event with the results and returns a key @@ -15189,8 +15191,6 @@ functions: categories: - avatar - dataserver - dataserver-semantics: - value-type: AgentData llRequestDisplayName: arguments: - id: @@ -15199,6 +15199,9 @@ functions: energy: 10.0 func-id: 361 return: key + dataserver-semantics: + value-type: string + tooltip: Agent's display name. sleep: 0.0 tooltip: Asynchronously requests the display name of the agent specified by id, triggering a dataserver event with the results. The agent does not need to @@ -15206,9 +15209,6 @@ functions: categories: - avatar - dataserver - dataserver-semantics: - value-type: string - tooltip: Agent's display name. llRequestExperiencePermissions: arguments: - agent: @@ -15238,6 +15238,11 @@ functions: energy: 10.0 func-id: 156 return: key + dataserver-semantics: + value-type: vector + tooltip: A global position as an offset from the current region's origin + (<0,0,0>). To obtain the absolute global position of a landmark, add + llGetRegionCorner() to the vector. sleep: 1.0 tooltip: Asynchronously requests data for the named inventory item, triggering a dataserver event. Currently, only landmark items are @@ -15246,11 +15251,6 @@ functions: categories: - dataserver - prim_inventory - dataserver-semantics: - value-type: vector - tooltip: A global position as an offset from the current region's origin - (<0,0,0>). To obtain the absolute global position of a landmark, add - llGetRegionCorner() to the vector. llRequestPermissions: arguments: - agent: @@ -15294,14 +15294,14 @@ functions: energy: 10.0 func-id: 293 return: key + dataserver-semantics: + value-type: SimulatorData sleep: 1.0 tooltip: Asynchronously requests data (using a DATA_SIM_* constant) about the region. Triggers a dataserver event and returns a key query handle. categories: - dataserver - region - dataserver-semantics: - value-type: SimulatorData llRequestURL: arguments: [] energy: 10.0 @@ -15322,6 +15322,9 @@ functions: energy: 10.0 func-id: 525 return: key + dataserver-semantics: + value-type: key + tooltip: Agent's unique ID. sleep: 0.0 tooltip: Asynchronously requests the Agent ID key (UUID) for the agent specified by their current or historical username, returning NULL_KEY if not found. @@ -15330,9 +15333,6 @@ functions: - avatar - dataserver - uuid - dataserver-semantics: - value-type: key - tooltip: Agent's unique ID. llRequestUsername: arguments: - id: @@ -15341,6 +15341,9 @@ functions: energy: 10.0 func-id: 359 return: key + dataserver-semantics: + value-type: string + tooltip: "Agent's username (legacy format: \"first.last\")." sleep: 0.0 tooltip: Asynchronously requests the unique single-word username of the agent identified by id, triggering a dataserver event. The agent does not need @@ -15348,9 +15351,6 @@ functions: categories: - avatar - dataserver - dataserver-semantics: - value-type: string - tooltip: "Agent's username (legacy format: \"first.last\")." llResetAnimationOverride: arguments: - anim_state: @@ -18114,15 +18114,6 @@ functions: experience: true func-id: 389 return: key - sleep: 0.0 - tooltip: Starts an asynchronous transaction to update the key k to value v - inside the experience datastore. If checked is TRUE, the update fails with - XP_ERROR_RETRY_UPDATE unless the existing value matches original_value. - categories: - - data_storage - - dataserver - - experience - - experience_data dataserver-semantics: value-type: string-csv error-semantics: true @@ -18137,6 +18128,15 @@ functions: - name: error value-type: ExperienceError tooltip: An XP_ERROR_* flag that describes why the operation failed. + sleep: 0.0 + tooltip: Starts an asynchronous transaction to update the key k to value v + inside the experience datastore. If checked is TRUE, the update fails with + XP_ERROR_RETRY_UPDATE unless the existing value matches original_value. + categories: + - data_storage + - dataserver + - experience + - experience_data llVecDist: arguments: - vec_a: