AR/addBan: Difference between revisions

Latest revision as of 04:55, 11 December 2012

هذه الوظيفة ستضيف باند للـ أسم/الايبي/السيريال إلى السيرفر

Syntax

ban addBan ( [ string IP, string Username, string Serial, player responsibleElement, string reason, int seconds = 0 ] )

ملاحظة : n يجب اختيار واحد من الثلاثة , الايبي او اسم اللاعب او سيريال اللاعب

Required Arguments

IP: nil الايبي الذي تريد تبنيده , اذا لم تشأ ان الباند يكون اي بي ثم اكتب في مكان الاي بي

أو

Username: nil الأسم الذي تريد تبنيده (حتى الآن لا يعمل) , اذا لم تشأ ان الباند يكون بالاسم ثم اكتب في مكان الاسم

أو

Serial: nil السيريال الذي تريد تبنيده , اذا لم تشأ ان الباند يكون بالسيريال ثم اكتب في مكان السيريال

or any combination.

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.

responsibleElement: root الشيء المسؤل عن الباند , يمكنه ان يكون لاعب أو
reason: سبب تبنيد الـ ايبي/اسم/سيريال من السيرفر
seconds: عدد الثواني اللذي سيكون الباند عليه أو 0 اذا الباند دائم

Returns

Returns true if the IP/username/serial was banned succesfully, false if invalid arguments are specified.

مثال

هذا المثال سوف يبند اي بي كاتب كلمة

ban-me

في اف 8

او في الشات كـ

/ban-me

مع السبب

function banMe ( player, command ) -- بلاير هو اللاعب اللذي كتب الكلمة وكوماند هي الكلمة المكتوبة
	local ipToBan = getPlayerIP ( player ) -- يحضر اي بي اللاعب اللذي كتب الكلمة
	addBan ( ipToBan, nil, nil, player, "Requested" ) -- ثم يبنده مع كلمة Requested
end
addCommandHandler ( "ban-me", banMe ) -- سوف يحصل كل هذا عند كتابة اللاعب كلمة
-- ban-me

مثال 2

هذا المثال يضع كلمة

ban-serial

وعند كتابتها في اف 8

ban-serial

او في الشات كـ

/ban-serial

سوف يحدث الآتي

function banSerial( player, command, banned, reason )
   if ( banned ) then -- اذا كتب اسم اللاعب المراد تبنيده
      local theBanned = getPlayerFromName( banned ) -- يبحث عن اسم هذا اللاعب
      if ( theBanned ) then -- اذا ووجد
         local theBannedSerial = getPlayerSerial( theBanned ) -- يحضر سيرياله
         addBan( nil, nil, theBannedSerial , player, reason ) -- ثم يضعه هنا
      end
   end
end
addCommandHandler( "ban-serial", banSerial ) -- سوف يحدث كل هذا عند كتابة
-- ban-serial

أنظر ايضاً

reloadBans

@@ Line 1: / Line 1: @@
 __NOTOC__
 {{Server function}}
-This function will add a ban for the specified IP/username/serial to the server.
+هذه الوظيفة ستضيف باند للـ أسم/الايبي/السيريال إلى السيرفر
 ==Syntax==
@@ Line 7: / Line 7: @@
 ban addBan ( [ string IP, string Username, string Serial, player responsibleElement, string reason, int seconds = 0 ] )
 </syntaxhighlight>
-'''Note:''' One of the three: IP, Username or Serial have to be specified.
+'''ملاحظة :''' n يجب اختيار '''واحد''' من الثلاثة , الايبي او اسم اللاعب او سيريال اللاعب
 ===Required Arguments===
-*'''IP:''' The IP to be banned. If you don't want to ban by IP, set this to ''nil''.
+*'''IP:'''            ''nil'' الايبي الذي تريد تبنيده , اذا لم تشأ ان الباند يكون اي بي ثم اكتب في مكان الاي بي
-'''or'''
+'''أو'''
-*'''Username:''' The [http://community.mtasa.com/ MTA Community] username to be banned (now obsolete). If you don't want to ban by username, set this to ''nil''.
+*'''Username:'''      ''nil'' الأسم الذي تريد تبنيده (حتى الآن لا يعمل) , اذا لم تشأ ان الباند يكون بالاسم ثم اكتب في مكان الاسم
-'''or'''
+'''أو'''
-*'''Serial:''' The serial to be banned. If you don't want to ban by serial, set this to ''nil''.
+*'''Serial:''' ''nil'' السيريال الذي تريد تبنيده , اذا لم تشأ ان الباند يكون بالسيريال ثم اكتب في مكان السيريال
 ''' or any combination.'''
 ===Optional Arguments===
 {{OptionalArg}}
-*'''responsibleElement:''' The element that is responsible for banning the IP/username/serial. This can be a player or the root ([[getRootElement]]()).
+*'''responsibleElement:''' [[root]] الشيء المسؤل عن الباند , يمكنه ان يكون لاعب أو
-*'''reason:''' The reason the IP/username/serial will be banned from the server.
+*'''reason:''' سبب تبنيد الـ ايبي/اسم/سيريال من السيرفر
-*'''seconds:''' The amount of seconds the player will be banned from the server for. This can be 0 for an infinite amount of time.
+*'''seconds:''' عدد الثواني اللذي سيكون الباند عليه أو 0 اذا الباند دائم
 ===Returns===
 Returns ''true'' if the IP/username/serial was banned succesfully, ''false'' if invalid arguments are specified.
-==Example==
+==مثال==
-This example bans a player's IP with the reason "Requested" when they type "/ban-me".
+هذا المثال سوف يبند اي بي كاتب كلمة
+ban-me
+في اف 8
+او في الشات كـ
+/ban-me
+مع السبب
 <syntaxhighlight lang="lua">
-function banMe ( source, command ) -- The function header and where source is defined
+function banMe ( player, command ) -- بلاير هو اللاعب اللذي كتب الكلمة وكوماند هي الكلمة المكتوبة
-	local ipToBan = getPlayerIP ( source ) -- Get the player's IP
+	local ipToBan = getPlayerIP ( player ) -- يحضر اي بي اللاعب اللذي كتب الكلمة
-	addBan ( ipToBan, nil, nil, source, "Requested" ) -- Ban him with the reason; Requested
+	addBan ( ipToBan, nil, nil, player, "Requested" ) -- ثم يبنده مع كلمة Requested
 end
-addCommandHandler ( "ban-me", banMe ) -- Make it trigger when a player types "/ban-me"
+addCommandHandler ( "ban-me", banMe ) -- سوف يحصل كل هذا عند كتابة اللاعب كلمة
+-- ban-me
 </syntaxhighlight>
-==Example 2==
+==مثال 2==
-This example add command to ban player serial.
+هذا المثال يضع كلمة
+ban-serial
+وعند كتابتها في اف 8
+ban-serial
+او في الشات كـ
+/ban-serial
+سوف يحدث الآتي
 <syntaxhighlight lang="lua">
-function banSerial( source, command, noob, reason )
+function banSerial( player, command, banned, reason )
-    if ( noob ) then
+    if ( banned ) then -- اذا كتب اسم اللاعب المراد تبنيده
-       local theNoob = getPlayerFromName( noob )
+       local theBanned = getPlayerFromName( banned ) -- يبحث عن اسم هذا اللاعب
-       if ( theNoob ) then
+       if ( theBanned ) then -- اذا ووجد
-          local theNoobSerial = getPlayerSerial( theNoob )
+          local theBannedSerial = getPlayerSerial( theBanned ) -- يحضر سيرياله
-          addBan( nil, nil, theNoobSerial, source, reason )
+          addBan( nil, nil, theBannedSerial , player, reason ) -- ثم يضعه هنا
        end
     end
 end
-addCommandHandler( "ban-serial", banSerial )
+addCommandHandler( "ban-serial", banSerial ) -- سوف يحدث كل هذا عند كتابة
+-- ban-serial
 </syntaxhighlight>
-==See Also==
+==أنظر ايضاً==
 {{AR/Admin functions}}
 [[en:addBan]]