This function adds an object to the given ACL group. An object can be a player's account, specified as user.. Or a resource, specified as resource.. Objects are specified as strings. The ACL groups work for the user accounts and the resources that are specified in them.

OOP Syntax Help! I don't understand this!

• Method:aclgroup:addObject(...)

Syntax

​bool aclGroupAddObject ( ​aclgroup theGroup, ​string theObject )

Required arguments

• theGroup: The group to add the object name string too.
• theObject: The object string to add to the given ACL.

Returns

Returns true if the object was successfully added to the ACL, false if it already existed in the list.

• bool: result

Code Examples

Example 1 Example 2 (OOP)

server

This example makes every player able to use a command named giveAccountAdminRights that will add a specific accountname as an ACL object to the Admin group.

local function giveAdminRights(playerSource, commandName, accountName) -- add the function giveAdminRights and specify its arguments
    if (accountName) then -- if there was an accountName entered then
        aclGroupAddObject(aclGetGroup("Admin"), "user." .. accountName) -- add an ACL object using the form "user.[accountName]" to the ACL group "Admin"
        outputChatBox("Account '" .. accountName .."' succesfully added to the admin group", playerSource) -- output a notification to the player who entered the command that the acocunt was successfully added
    else -- else output an error message and the correct syntax of the command to the player who entered it
        outputChatBox("No account name specified.", playerSource)
        outputChatBox("Correct syntax: /giveAccountAdminRights [accountName]", playerSource)
    end
end
addCommandHandler("giveAccountAdminRights", giveAdminRights) -- add a command "giveAccountAdminRights" and attch the function "giveAdminRights" to it

server

OOP Required

This example makes every player able to use a command named giveAccountAdminRights that will add a specific accountname as an ACL object to the Admin group.

local function giveAdminRights(playerSource, commandName, accountName) -- add the function giveAdminRights and specify its arguments
    if (accountName) then -- if there was an accountName entered then
        local adminGroup = ACLGroup.get("Admin")
        if (adminGroup) then
            adminGroup:addObject("user." .. accountName)
            playerSource:outputChat("Account '" .. accountName .."' succesfully added to the admin group") -- output a notification to the player who entered the command that the acocunt was successfully added
        end
    else -- else output an error message and the correct syntax of the command to the player who entered it
        playerSource:outputChat("No account name specified.")
        playerSource:outputChat("Correct syntax: /giveAccountAdminRights [accountName]")
    end
end
addCommandHandler("giveAccountAdminRights", giveAdminRights) -- add a command "giveAccountAdminRights" and attch the function "giveAdminRights" to it

See Also

ACL Functions

• aclCreate
• aclCreateGroup
• aclDestroy
• aclDestroyGroup
• aclGet
• aclGetGroup
• aclGetName
• aclGetRight
• aclGroupAddACL
• aclGroupAddObject
• aclGroupGetName
• aclGroupList
• aclGroupListACL
• aclGroupListObjects
• aclGroupRemoveACL
• aclGroupRemoveObject
• aclList
• aclListRights
• aclObjectGetGroupsNew
• aclReload
• aclRemoveRight
• aclSave
• aclSetRight
• hasObjectPermissionTo
• isObjectInACLGroup

ACL Elements

• acl
• aclgroup

Reference

• Scripting Functions