Skip to content
lsl.devlsl.devLSL Dev

llManageEstateAccess

View as MarkdownThis page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page
function
Function syntax
integer llManageEstateAccess(
  1. integer action,// An ESTATE_ACCESS_* action flag specifying the operation to perform. Values: EstateAccessParam
  2. key avatar// UUID of the avatar or group to add or remove.
);
Returns
integer
Energy
10

Use to add or remove agents from the estate’s agent access or ban lists or groups from the estate’s group access list.

Only works for objects owned by the Estate Owner or an Estate Manager. By default, the object owner is notified of every change made using this function. But if the owner grants PERMISSION_SILENT_ESTATE_MANAGEMENT to the script, the owner will not be notified.

Returns an integer TRUE if the call was successful; FALSE if throttled, invalid action, invalid or null id or object owner is not allowed to manage the estate.

How to use
integer result = llManageEstateAccess(0, NULL_KEY);

Specification

Section titled “Specification”
action flagVDescription
ESTATE_ACCESS_ALLOWED_AGENT_ADD0x4Add the agent to this estate’s Allowed Residents list.
ESTATE_ACCESS_ALLOWED_AGENT_REMOVE0x8Remove the agent from this estate’s Allowed Residents list.
ESTATE_ACCESS_ALLOWED_GROUP_ADD0x10Add the group to this estate’s Allowed groups list.
ESTATE_ACCESS_ALLOWED_GROUP_REMOVE0x20Remove the group from this estate’s Allowed groups list.
ESTATE_ACCESS_BANNED_AGENT_ADD0x40Add the agent to this estate’s Banned residents list.
ESTATE_ACCESS_BANNED_AGENT_REMOVE0x80Remove the agent from this estate’s Banned residents list.

Caveats

Section titled “Caveats”
  • Calls are throttled at a rate of 30 calls per 30 seconds.
  • FALSE will be returned…
  • if throttled,
  • if object owner doesn’t have power to perform action,
  • if avatar is invalid or null
  • If used on mainland the message “llManageEstateAccess does not work on mainland” is shouted on DEBUG_CHANNEL.
  • If the object owner is not allowed to manage the estate the message “llManageEstateAccess object owner must manage estate.” is shouted on DEBUG_CHANNEL. — SRC-233
  • If a legit estate manager tries to exceed the max number of entries in the list the call will return TRUE but the operation be truncated at the limit.

History

Section titled “History”

Date of Release 18/10/2011

Known issues

Section titled “Known issues”

From the issue templates included by the wiki article:

  • SCR-293 (bug): ESTATE_ACCESS_BANNED_AGENT_ADD can ban estate owner!

See also

Section titled “See also”

Functions

Section titled “Functions”
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.