IsPlayerStaff - Revision history

Dutchman101 at 10:56, 31 October 2023

2023-10-31T10:56:15Z

← Older revision		Revision as of 10:56, 31 October 2023
Line 43:		Line 43:
	This example adds a command to speed up your vehicle's handling, but only when you're in a staff ACL.		This example adds a command to speed up your vehicle's handling, but only when you're in a staff ACL.

	'''Beginners note''': By adding "'''if not isPlayerAllowed(p) then return end'''" before execution of the code, you will limit its usage to only server admins and staff.		'''Beginners note''': By adding "'''if not isPlayerAllowed(client) then return end'''" before execution of the code, you will limit its usage to only server admins and staff.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function speedUpHandling(client)		function speedUpHandling(client)

Dutchman101 at 10:55, 31 October 2023

2023-10-31T10:55:36Z

← Older revision		Revision as of 10:55, 31 October 2023
Line 45:		Line 45:
	'''Beginners note''': By adding "'''if not isPlayerAllowed(p) then return end'''" before execution of the code, you will limit its usage to only server admins and staff.		'''Beginners note''': By adding "'''if not isPlayerAllowed(p) then return end'''" before execution of the code, you will limit its usage to only server admins and staff.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function speedUpHandling(p)		function speedUpHandling(client)
	if not isPlayerStaff(p) then return end -- check if the player is part of a staff ACL, if not then we won't execute (allow them to use it)		if not isPlayerStaff(client) then return end -- check if the player is part of a staff ACL, if not then we won't execute (allow them to use it)
	local vehicle = getPedOccupiedVehicle(p)		local vehicle = getPedOccupiedVehicle(client)
	if vehicle then		if vehicle then
	setVehicleHandling(vehicle,"engineAcceleration",17)		setVehicleHandling(vehicle,"engineAcceleration",17)
Line 58:		Line 58:
	addCommandHandler("tunevehicle",speedUpHandling)		addCommandHandler("tunevehicle",speedUpHandling)

	-- Now, we'll add the custom function code to the file, so that the call to 'isPlayerStaff(p)' actually works (in the script that needs access check, like above)		-- Now, we'll add the custom function code to the file, so that the call to 'isPlayerStaff(client)' actually works (in the script that needs access check, like above)
	local staffACLs =		local staffACLs =
	{		{

Dutchman101: formatting

2019-07-30T10:00:23Z

formatting

← Older revision		Revision as of 10:00, 30 July 2019
Line 19:		Line 19:
	<section name="Function source" class="server" show="true">		<section name="Function source" class="server" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local staffACLs =		local staffACLs = {
	{		aclGetGroup("Admin"),
	aclGetGroup("Admin"),		aclGetGroup("Moderator"),
	aclGetGroup("Moderator"),		aclGetGroup("SuperModerator")
	aclGetGroup("SuperModerator"),
	}		}

	function isPlayerStaff(p)		function isPlayerStaff(p)

	if isElement(p) and getElementType(p) == "player" and not isGuestAccount(getPlayerAccount(p)) then		if isElement(p) and getElementType(p) == "player" and not isGuestAccount(getPlayerAccount(p)) then
	local object = getAccountName(getPlayerAccount(p))		local object = getAccountName(getPlayerAccount(p))

	for _,group in ipairs(staffACLs) do		for _, group in ipairs(staffACLs) do
	if isObjectInACLGroup( "user."..object, group ) then		if isObjectInACLGroup("user." .. object, group) then
	return true		return true
	end		end

Danilo: /* Example */

2019-07-27T01:14:37Z

Example

← Older revision		Revision as of 01:14, 27 July 2019
Line 43:		Line 43:

	==Example==		==Example==
	~~<section name="Server" class="server" show="true">~~
	This example adds a command to speed up your vehicle's handling, but only when you're in a staff ACL.		This example adds a command to speed up your vehicle's handling, but only when you're in a staff ACL.

Line 84:		Line 83:
	return false		return false
	end		end
	</syntaxhighlight~~></section~~>		</syntaxhighlight>

	==See Also==		==See Also==
	{{Useful_Functions}}		{{Useful_Functions}}

Danilo: /* Code */

2019-07-27T01:13:44Z

Code

← Older revision		Revision as of 01:13, 27 July 2019
Line 17:		Line 17:

	==Code==		==Code==
	<section name="Function source" class="~~both~~" show="true">		<section name="Function source" class="server" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local staffACLs =		local staffACLs =

Danilo at 01:13, 27 July 2019

2019-07-27T01:13:24Z

← Older revision		Revision as of 01:13, 27 July 2019
Line 12:		Line 12:
	===Required arguments===		===Required arguments===
	* '''thePlayer''': The player to check rights of		* '''thePlayer''': The player to check rights of

			===Returns===
			Returns ''true'' if the player is in a staff group, ''false'' otherwise.

	==Code==		==Code==
Line 24:		Line 27:

	function isPlayerStaff(p)		function isPlayerStaff(p)
	~~local acc = getPlayerAccount(p)~~

	~~if not acc then return false end~~
	~~if isGuestAccount(acc) then return false end~~

	~~local object = getAccountName(acc)~~

	for _,group in ipairs(staffACLs) do		if isElement(p) and getElementType(p) == "player" and not isGuestAccount(getPlayerAccount(p)) then
	if isObjectInACLGroup("user."..object,group) then		local object = getAccountName(getPlayerAccount(p))
	return true
	end		for _,group in ipairs(staffACLs) do
	end		if isObjectInACLGroup( "user."..object, group ) then
	return false		return true
			end
			end
			end
			return false
	end		end
	</syntaxhighlight>		</syntaxhighlight>

Dutchman101 at 00:12, 16 January 2019

2019-01-16T00:12:08Z

← Older revision		Revision as of 00:12, 16 January 2019
Line 44:		Line 44:
	<section name="Server" class="server" show="true">		<section name="Server" class="server" show="true">
	This example adds a command to speed up your vehicle's handling, but only when you're in a staff ACL.		This example adds a command to speed up your vehicle's handling, but only when you're in a staff ACL.
	'''Beginners note''': By adding "if not isPlayerAllowed(p) then return end" before execution of the code, you will limit its usage to only server admins and staff.
			'''Beginners note''': By adding "'''if not isPlayerAllowed(p) then return end'''" before execution of the code, you will limit its usage to only server admins and staff.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function speedUpHandling(p)		function speedUpHandling(p)

Dutchman101: added isPlayerStaff (written in a beginner-friendly way due to how common usage of something like this is), please don't change the tutorial-ish nature

2019-01-16T00:08:37Z

added isPlayerStaff (written in a beginner-friendly way due to how common usage of something like this is), please don't change the tutorial-ish nature

New page

{{Useful Function}}

This function checks if the player is server staff (for example: Moderator or Admin, by ACL group membership).

It's useful to check if a player is supposed to have access to/be able to use something.

==Syntax==
<syntaxhighlight lang="lua">
bool isPlayerStaff ( element thePlayer )
</syntaxhighlight>

===Required arguments===
* '''thePlayer''': The player to check rights of

==Code==
<section name="Function source" class="both" show="true">
<syntaxhighlight lang="lua">
local staffACLs =
{
aclGetGroup("Admin"),
aclGetGroup("Moderator"),
aclGetGroup("SuperModerator"),
}

function isPlayerStaff(p)
local acc = getPlayerAccount(p)

if not acc then return false end
if isGuestAccount(acc) then return false end

local object = getAccountName(acc)

for _,group in ipairs(staffACLs) do
if isObjectInACLGroup("user."..object,group) then
return true
end
end
return false
end
</syntaxhighlight>
</section>

==Example==
<section name="Server" class="server" show="true">
This example adds a command to speed up your vehicle's handling, but only when you're in a staff ACL.
'''Beginners note''': By adding "if not isPlayerAllowed(p) then return end" before execution of the code, you will limit its usage to only server admins and staff.
<syntaxhighlight lang="lua">
function speedUpHandling(p)
if not isPlayerStaff(p) then return end -- check if the player is part of a staff ACL, if not then we won't execute (allow them to use it)
local vehicle = getPedOccupiedVehicle(p)
if vehicle then
setVehicleHandling(vehicle,"engineAcceleration",17)
setVehicleHandling(vehicle,"tractionMultiplier",0.9)
setVehicleHandling(vehicle,"tractionLoss",1.1)
setVehicleHandling(vehicle,"dragCoeff",0.0)
setVehicleHandling(vehicle,"maxVelocity",750)
end
end
addCommandHandler("tunevehicle",speedUpHandling)

-- Now, we'll add the custom function code to the file, so that the call to 'isPlayerStaff(p)' actually works (in the script that needs access check, like above)
local staffACLs =
{
aclGetGroup("Admin"),
aclGetGroup("Moderator"),
aclGetGroup("SuperModerator"),
}

function isPlayerStaff(p)
local acc = getPlayerAccount(p)

if not acc then return false end
if isGuestAccount(acc) then return false end

local object = getAccountName(acc)

for _,group in ipairs(staffACLs) do
if isObjectInACLGroup("user."..object,group) then
return true
end
end
return false
end
</syntaxhighlight></section>

==See Also==
{{Useful_Functions}}