AR/kickPlayer: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Server function}}
{{Server function}}
__NOTOC__
__NOTOC__
This function will kick the specified player from the server.
هذه الوظيفة سـ تطرد الاعب المحدد من السيرفر


==Syntax==  
==Syntax==  
Line 13: Line 13:


===Required Arguments===  
===Required Arguments===  
*'''kickedPlayer:''' The player that will be kicked from the server
*'''kickedPlayer:''' الاعب الذي سيتم طرده من السيرفر
 
===Optional Arguments===  
===Optional Arguments===  
{{OptionalArg}}  
{{OptionalArg}}  
*'''responsiblePlayer:''' The player that is responsible for the event. '''Note''': If left out as in the second syntax, responsible player for the kick will be "Console" (Maximum 30 characters if using a string).
*'''responsiblePlayer:''' console الاعب او الشيء الذي سيتحمل مسؤلية طرد الاعب المحدد , يمكنه ان يكون من الـ
*'''reason:''' The reason for the kick.
( اقصى عدد للحروف 30 )
*'''reason:''' سبب الطرد


===Returns===
===Returns===
Returns ''true'' if the player was kicked succesfully, ''false'' if invalid arguments are specified.
ادا كانت
"true"
يستطيع طرد اللاعب
ادا كانت
"false"
كادبه لا يستطيع طرد اللاعب


==Example==  
==مثال==  
This example lets a player kick anyone who has a lower level.
هذا المثال سـ يطرد كل من معه مال اكبر من 999999 عند دخول الاعب حسابه
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function kickPlayerHandler ( sourcePlayer, commandname, kickedname, reason )
function kickCheater( )
-- Get player element from the name
    -- اذا رآى ان الاعب لديه أكثر من 999999 سيطرده
local kicked = getPlayerFromName ( kickedname )
if ( getPlayerMoney( source ) > 999999 ) then
-- If the client who sent the command has a higher level
        -- طرد الاعب
if ( hasObjectPermissionTo ( sourcePlayer, "function.kickPlayer" ) ) then
        kickPlayer( source )
-- Kick the player
kickPlayer ( kicked, sourcePlayer, reason )
end
end
end
end
-- Add the "kick" command handler
-- سـ تقوم الوظيفة بالعمل عند دخول الاعب
addCommandHandler ( "kick", kickPlayerHandler )
addEventHandler("onPlayerLogin", root, kickCheater)
</syntaxhighlight>
</syntaxhighlight>


==See Also==
==انظر أيضاً==
{{AR/Admin_functions}}
{{AR/Admin_functions}}
[[es:kickPlayer]]
[[es:kickPlayer]]
[[ru:kickPlayer]]
[[ru:kickPlayer]]

Latest revision as of 16:59, 27 September 2016

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

Syntax

bool kickPlayer ( player kickedPlayer, [ player responsiblePlayer, string reason = "" ] )         

or

bool kickPlayer ( player kickedPlayer, [ string reason = "" ] )

Required Arguments

  • kickedPlayer: الاعب الذي سيتم طرده من السيرفر

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.

  • responsiblePlayer: console الاعب او الشيء الذي سيتحمل مسؤلية طرد الاعب المحدد , يمكنه ان يكون من الـ

( اقصى عدد للحروف 30 )

  • reason: سبب الطرد

Returns

ادا كانت "true" يستطيع طرد اللاعب ادا كانت "false" كادبه لا يستطيع طرد اللاعب

مثال

هذا المثال سـ يطرد كل من معه مال اكبر من 999999 عند دخول الاعب حسابه

function kickCheater( )
    -- اذا رآى ان الاعب لديه أكثر من 999999 سيطرده
	if ( getPlayerMoney( source ) > 999999 ) then
        -- طرد الاعب
        kickPlayer( source )
	end
end
-- سـ تقوم الوظيفة بالعمل عند دخول الاعب
addEventHandler("onPlayerLogin", root, kickCheater)

انظر أيضاً