AR/banPlayer: Difference between revisions

Revision as of 18:53, 1 September 2012

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

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() ( الحد الأقصى 30 حرف )

reason: سبب تبنيد الاعب من السيرفر
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
+هذه الوظيفة سـ تبند الاعب المحدد عن طريق كلٍٍ من الاي بي او السيريال او اسم الاعب
 }}
@@ Line 24: / Line 24: @@
 ===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.
+( الحد الأقصى 30 حرف )
+*'''reason:''' سبب تبنيد الاعب من السيرفر
+*'''seconds:''' عدد الثواني الذي سيتم بها تبنيد الاعب , 0 اذا كان الباند دائم
 ===Returns===
 {{Deprecated_feature|3|1.0|
@@ Line 49: / Line 53: @@
 }}
-==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 75: @@
 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]]