The ACL XML file is automatically saved whenever the ACL is modified, but the automatic save can be delayed by up to 10 seconds for performance reasons. Calling this function will force an immediate save.

OOP Syntax Help! I don't understand this!

• Method: ACL.save(...)

Syntax

bool aclSave ( )

Returns

• bool: result

Returns true if the ACL was successfully changed, false or nil if it could not be saved for some reason, ie. file in use.

Code Examples

Example 1 Example 2 (OOP)

server

This example saves the ACL when somebody types /save-acl.

local function saveACL(thePlayer, command) -- Function header. Also where thePlayer is defined.
  local saved = aclSave() -- Save the ACL
  if (saved) then -- If it was successfully saved then...
    outputChatBox("ACL was successfully saved.", thePlayer, 255, 0, 0) -- Output it saved
  else -- If it wasn't saved for whatever reason then...
    outputChatBox("An unexpected error occured.", thePlayer, 255, 0, 0) -- Output it didn't save
  end
end
addCommandHandler("save-acl", saveACL) -- Make it trigger for "/save-acl".

server

OOP Required

This example saves the ACL when somebody types /save-acl.

local function saveACL(thePlayer, command) -- Function header. Also where thePlayer is defined.
  local saved = ACL.save() -- Save the ACL
  if (saved) then -- If it was successfully saved then...
    thePlayer:outputChat("ACL was successfully saved.", 255, 0, 0) -- Output it saved
  else -- If it wasn't saved for whatever reason then...
    thePlayer:outputChat("An unexpected error occured.", 255, 0, 0) -- Output it didn't save
  end
end
addCommandHandler("save-acl", saveACL) -- Make it trigger for "/save-acl".

See Also

ACL Functions

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

ACL Elements

• acl
• aclgroup

Reference

• Scripting Functions