AR/addBan: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Server function}}
{{Server function}}
This function will add a ban for the specified IP/username/serial to the server.
هذه الوظيفة ستضيف باند للـ أسم/الايبي/السيريال إلى السيرفر


==Syntax==  
==Syntax==  
Line 7: Line 7:
ban addBan ( [ string IP, string Username, string Serial, player responsibleElement, string reason, int seconds = 0 ] )         
ban addBan ( [ string IP, string Username, string Serial, player responsibleElement, string reason, int seconds = 0 ] )         
</syntaxhighlight>
</syntaxhighlight>
'''Note:''' One of the three: IP, Username or Serial have to be specified.
'''ملاحظة :''' n يجب اختيار '''واحد''' من الثلاثة , الايبي او اسم اللاعب او سيريال اللاعب


===Required Arguments===  
===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.'''
''' or any combination.'''


===Optional Arguments===  
===Optional Arguments===  
{{OptionalArg}}  
{{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===
Returns ''true'' if the IP/username/serial was banned succesfully, ''false'' if invalid arguments are specified.
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">
<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
end
addCommandHandler ( "ban-me", banMe ) -- Make it trigger when a player types "/ban-me"
addCommandHandler ( "ban-me", banMe ) -- سوف يحصل كل هذا عند كتابة اللاعب كلمة
-- ban-me
</syntaxhighlight>
</syntaxhighlight>


==Example 2==
==مثال 2==
This example add command to ban player serial.
هذا المثال يضع كلمة
 
ban-serial
 
وعند كتابتها في اف 8
 
ban-serial
 
او في الشات كـ
 
/ban-serial
 
سوف يحدث الآتي
<syntaxhighlight lang="lua">
<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
   end
end
end
addCommandHandler( "ban-serial", banSerial )
addCommandHandler( "ban-serial", banSerial ) -- سوف يحدث كل هذا عند كتابة
-- ban-serial
</syntaxhighlight>
</syntaxhighlight>


==See Also==
==أنظر ايضاً==
{{AR/Admin functions}}
{{AR/Admin functions}}
[[en:addBan]]
[[en:addBan]]

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

أنظر ايضاً