https://wiki.multitheftauto.com/api.php?action=feedcontributions&feedformat=atom&user=JustBoyMulti Theft Auto: Wiki - User contributions [en]2026-04-16T07:58:06ZUser contributionsMediaWiki 1.39.3https://wiki.multitheftauto.com/index.php?title=AclGroupAddObject&diff=44824AclGroupAddObject2015-03-31T15:41:19Z<p>JustBoy: /* Required Arguments */</p>
<hr />
<div>__NOTOC__ <br />
{{Server function}}<br />
<!-- Describe in plain english what this function does. Don't go into details, just give an overview --><br />
This function adds an object to the given ACL group. An object can be a player's account, specified as:<br />
''user.<accountname>''<br />
<br />
Or a resource, specified as:<br />
''resource.<resourcename>''<br />
<br />
Objects are specified as strings. The ACL groups work for the user accounts and the resources that are specified in them.<br />
<br />
==Syntax== <br />
<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writing things like 'player player, vehicle vehicle', instead write something like 'player thePlayer, vehicle vehicleToGetInto'. This is less confusing and prevents the syntax highlighting being odd --><br />
<syntaxhighlight lang="lua"><br />
bool aclGroupAddObject ( aclgroup theGroup, string theObjectName )<br />
</syntaxhighlight> <br />
{{OOP||[[aclgroup]]:addObject||}}<br />
===Required Arguments=== <br />
<!-- List each argument one per line. This should be the argument's name as in the argument list above, NOT the argument's data type --><br />
*'''theGroup:''' The group to add the object name string too.<br />
*'''theObjectName:''' The object string to add to the given ACL.<br />
<br />
===Returns===<br />
<!-- Make this descriptive. Explain what cases will return false. If you're unsure, add a tag to it so we can check --><br />
Returns ''true'' if the object was successfully added to the ACL, ''false'' if it already existed in the list.<br />
<br />
==Example== <br />
<!-- Explain what the example is in a single sentance --><br />
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.<br />
<!-- Add the code below, an emphasis should be on making it clear, not optimized. You could provide two versions if you wish, one clear and well commented, the other optimized --><br />
<syntaxhighlight lang="lua"><br />
function giveAdminRights (playerSource, commandName, accountName) --add the function giveAdminRights and specify its arguments<br />
if accountName then --if there was an accountName entered then<br />
aclGroupAddObject (aclGetGroup("Admin"), "user."..accountName) --add an ACL object using the form "user.[accountName]" to the ACL group "Admin"<br />
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<br />
else --else output an error message and the correct syntax of the command to the player who entered it<br />
outputChatBox ("No account name specified.", playerSource)<br />
outputChatBox ("Correct syntax: /giveAccountAdminRights [accountName]", playerSource)<br />
end<br />
end<br />
<br />
addCommandHandler ("giveAccountAdminRights", giveAdminRights) --add a command "giveAccountAdminRights" and attch the function "giveAdminRights" to it <br />
</syntaxhighlight><br />
<br />
==See Also==<br />
<!-- Change FunctionArea to the area that this function is in on the main function list page, e.g. Server, Player, Vehicle etc --><br />
{{ACL_functions}}</div>JustBoy