AR/banPlayer: Difference between revisions

Latest revision as of 21:03, 14 June 2021

هذه الوظيفة سـ تبند الاعب المحدد عن طريق كل من الاي بي او السيريال او اسم الاعب

Syntax

ban banPlayer ( player bannedPlayer, [ bool IP = true, bool Username = false, bool Serial = false, 
player responsiblePlayer = nil, string reason = nil, int seconds = 0 ] )

Required Arguments

bannedPlayer: الاعب الذي سيتم تحظر دخوله من السيرفر.

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

IP: هل سيكون الحظر عن طريق الاي بي ؟
Username: هل سيكون الحظر عن طريق الاسم ؟
Serial: هل سيكون الحظر عن طريق السيريال

ملاحظة: t للتبنيد عن طريق الاسم او السيريال

verifyserials

يجب ان تكون مفتوحة في ملف ترتيب السيرفر

responsibleElement: الشيء الذي سيكون مسؤل عن الحظر , يمكنه ان يكون لاعب , ويمكنه ان يكون

getRootElement()

reason: ( الحد الاقصى 30 حرف )t سبب حظر اللاعب من السيرفر
seconds: عدد الثواني الذي سيتم بها الحظر الاعب , 0 اذا كان الباند دائم

Returns

Returns a ban object if banned successfully, or false if unsuccessful.

مثال

المثال يدع الاعبين يبندون كما يشاؤن اذا كان لهم صلاحية الادمن في ملف اي اس ال

ACL

 -- السبب, اسم الباند ,اسم الكلمة التي سيتم بها تبنيد الاعب , الاعب
function banPlayerCommand ( theClient, commandName, bannedName, reason )
	-- يعطي الاعب خطاء اذا لم يكن له الصلاحية لفعل ذلك
	if ( hasObjectPermissionTo ( theClient, "function.banPlayer" ) ) then
		-- يتحقق من اسم الاعب الذي سيتم تبنيده من قبل الادمن الذي سيكتب الكلمة واسمه
		local bannedPlayer = getPlayerFromName ( bannedName )
		-- تبنيد الاعب
		banPlayer ( bannedPlayer, theClient, reason )
                -- يخبر بالشات بآنه تم تبنيد هذا الاعب بنجاح
		outputChatBox ( "ban: " .. bannedName .. " successfully banned", theClient )
                -- اذا ليس كذلك
	else
                -- يخرج بالشات بآن الاعب الذي كتب الكلمة ليس معه الصلاحية الكافية للتبنيد
		outputChatBox ( "ban: You don't have enough permissions", theClient )
	end

end
addCommandHandler ( "ban", banPlayerCommand )
--[[ لقد جعلنا كلمة
ban
تفعل كل ما كتبناه فوق
]]

انظر أيضاً

reloadBans

@@ Line 2: / Line 2: @@
 {{Server function}}
 {{New feature|3|1.0|
-This function will ban the specified player by either IP, [[serial]] or username
+هذه الوظيفة سـ تبند الاعب المحدد عن طريق كل من الاي بي او السيريال او اسم الاعب
 }}
 {{Deprecated_feature|3|1.0|
-This function will ban the specified player from the server by IP.
+This function will ban the specified player from the server by IP.|AR
 }}
@@ Line 20: / Line 20: @@
 <syntaxhighlight lang="lua">
 bool banPlayer ( player bannedPlayer , [ element responsibleElement, string reason ] )
-</syntaxhighlight>
+</syntaxhighlight>|AR
 }}
 ===Required Arguments===
-*'''bannedPlayer:''' The player that will be banned from the server.
+*'''bannedPlayer:''' الاعب الذي سيتم تحظر دخوله من السيرفر.
 ===Optional Arguments===
 {{OptionalArg}}
 {{New feature|3|1.0|
-*'''IP:''' Will player be banned by IP?
+*'''IP:''' هل سيكون الحظر عن طريق الاي بي ؟
-*'''Username:''' Will player be banned by username?
+*'''Username:''' هل سيكون الحظر عن طريق الاسم ؟
-*'''Serial:''' Will player be banned by serial?
+*'''Serial:''' هل سيكون الحظر عن طريق السيريال
-:'''Note:''' to ban by username or serial, ''verifyserials'' must be enabled in the server configuration file.
+:'''ملاحظة:''' t للتبنيد عن طريق الاسم او السيريال
+''verifyserials''
+يجب ان تكون مفتوحة في ملف ترتيب السيرفر
 }}
-*'''responsibleElement:''' The element that is responsible for banning the player. This can be a player or the root ([[getRootElement]]()) (Maximum 30 characters if using a string).
+*'''responsibleElement:''' الشيء الذي سيكون مسؤل عن الحظر , يمكنه ان يكون لاعب , ويمكنه ان يكون
-*'''reason:''' The reason the player will be banned from the server.
+getRootElement()
-*'''seconds:''' The amount of seconds the player will be banned from the server for. This can be 0 for an infinite amount of time.
+*'''reason:''' ( الحد الاقصى 30 حرف )t سبب حظر اللاعب من السيرفر
+*'''seconds:''' عدد الثواني الذي سيتم بها الحظر الاعب , 0 اذا كان الباند دائم
 ===Returns===
 {{Deprecated_feature|3|1.0|
-Returns ''true'' if the player was banned succesfully, ''false'' if invalid arguments are specified.
+Returns ''true'' if the player was banned succesfully, ''false'' if invalid arguments are specified.|AR
 }}
@@ Line 49: / Line 54: @@
 }}
-==Example==
+==مثال==
-This example lets a player ban anyone if he has ACL rights.
+المثال يدع الاعبين يبندون كما يشاؤن اذا كان لهم صلاحية الادمن في ملف اي اس ال
-<syntaxhighlight lang="lua">
---Add the "ban" command handler
+ACL
--- Example with the player
+<syntaxhighlight lang="lua"> -- السبب, اسم الباند ,اسم الكلمة التي سيتم بها تبنيد الاعب , الاعب
 function banPlayerCommand ( theClient, commandName, bannedName, reason )
+	-- يعطي الاعب خطاء اذا لم يكن له الصلاحية لفعل ذلك
-	-- Give the player a nice error if he doesn't have rights
 	if ( hasObjectPermissionTo ( theClient, "function.banPlayer" ) ) then
-		--Get player element from the name
+		-- يتحقق من اسم الاعب الذي سيتم تبنيده من قبل الادمن الذي سيكتب الكلمة واسمه
 		local bannedPlayer = getPlayerFromName ( bannedName )
+		-- تبنيد الاعب
-		--Ban the player
 		banPlayer ( bannedPlayer, theClient, reason )
+                -- يخبر بالشات بآنه تم تبنيد هذا الاعب بنجاح
 		outputChatBox ( "ban: " .. bannedName .. " successfully banned", theClient )
+                -- اذا ليس كذلك
 	else
+                -- يخرج بالشات بآن الاعب الذي كتب الكلمة ليس معه الصلاحية الكافية للتبنيد
 		outputChatBox ( "ban: You don't have enough permissions", theClient )
 	end
@@ Line 71: / Line 76: @@
 end
 addCommandHandler ( "ban", banPlayerCommand )
+--[[ لقد جعلنا كلمة
--- Example function with the root element. Here you would pass a player element to the function.
+ban
-function banCheater(theCheater)
+تفعل كل ما كتبناه فوق
-	banPlayer(theCheater, getRootElement(), "You are banned because of cheating.")
+]]
-end
 </syntaxhighlight>
-==See Also==
+==انظر أيضاً==
 {{AR/Admin_functions}}
 [[es:banPlayer]]
 [[ru:BanPlayer]]