AclCreateGroup: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(6 intermediate revisions by 5 users not shown)
Line 7: Line 7:
aclgroup aclCreateGroup ( string groupName )
aclgroup aclCreateGroup ( string groupName )
</syntaxhighlight>  
</syntaxhighlight>  
 
{{OOP||[[aclgroup|ACLGroup]]||}}
===Required Arguments===  
===Required Arguments===  
*'''groupName:''' The name of the group to create
*'''groupName:''' The name of the group to create
Line 27: Line 27:
     if not objectName then
     if not objectName then
         -- print out message to chatbox
         -- print out message to chatbox
         outputChatBox ( "You need to specify the object!", thePlayer )
         return outputChatBox ( "You need to specify the object!", thePlayer )
        -- exit function
return
     end
     end


Line 42: Line 40:
==See Also==
==See Also==
{{ACL_functions}}
{{ACL_functions}}
[[ar:aclCreateGroup]]
[[en:aclCreateGroup]]
[[zh-cn:AclCreateGroup]]

Latest revision as of 18:08, 21 February 2021

This function creates a group in the ACL. An ACL group can contain objects like players and resources. They specify who has access to the ACL's in this group.

Syntax

aclgroup aclCreateGroup ( string groupName )

OOP Syntax Help! I don't understand this!

Method: ACLGroup(...)


Required Arguments

  • groupName: The name of the group to create

Returns

Returns the pointer to the created aclgroup if successful. Returns false if failed.

Example

This example adds a command addobjecttogroup with which you can easily add new objects to specified access control list groups.

function addACLGroupObject ( thePlayer, commandName, groupName, objectName )
    local ourGroup = aclGetGroup ( groupName )
    -- if there is no previous group with this name, we need to create one
    if not ourGroup then
        ourGroup = aclCreateGroup ( groupName )
    end

    -- if object name wasn't given
    if not objectName then
        -- print out message to chatbox
        return outputChatBox ( "You need to specify the object!", thePlayer )
    end

    -- and finally let's add the object to it's group
    aclGroupAddObject ( ourGroup, objectName )
    -- don't forget to save the ACL after it has been modified
    aclSave ()
end
addCommandHandler ( "addobjecttogroup", addACLGroupObject )

See Also