The Kid at 15:47, 17 February 2011

2011-02-17T15:47:17Z

← Older revision		Revision as of 15:47, 17 February 2011
Line 8:		Line 8:
	{{New feature\|3\|1.0\|		{{New feature\|3\|1.0\|
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	ban banPlayer ( player jugadorABanear, [ bool IP = true, bool ~~Nombre~~ = false, bool ~~Serial~~ = false,		ban banPlayer ( player jugadorABanear, [ bool IP = true, bool nombre = false, bool serial = false,
	player ~~jugadorResponsable~~ = nil, string razón = nil, int segundos = 0 ] )		player responsable = nil, string razón = nil, int segundos = 0 ] )
	</syntaxhighlight>		</syntaxhighlight>
	}}		}}

	===Argumentos Requeridos===		===Argumentos Requeridos===
	*'''jugadorABanear:''' El jugador que se quiere banear ~~del~~ servidor.		*'''jugadorABanear:''' El jugador al que se quiere banear de un servidor.

	===Argumentos Opcionales===		===Argumentos Opcionales===
	{{OptionalArg}}		{{OptionalArg}}
	{{New feature\|3\|1.0\|		{{New feature\|3\|1.0\|
	*'''IP:''' ~~Banear~~ la IP del jugador?		*'''IP:''' Un valor lógico que representa si se banea la IP del jugador.
	*'''Username:''' ~~Banear~~ el nombre del jugador?		*'''Username:''' Un valor lógico que representa si se banea el nombre del jugador.
	*'''Serial:''' ~~Banear~~ la serial del jugador?		*'''Serial:''' Un valor lógico que representa si se banea la serial del jugador.

	:'''Note:''' Para banear por nombre o por serial, ''verifyserials'' tiene que estar habilitado en el archivo de configuración del servidor.		:'''Note:''' Para banear por nombre o por serial, ''verifyserials'' tiene que estar habilitado en el archivo de configuración del servidor (mtaserver.conf).

	}}		}}
	*'''~~jugadorResponsable~~:''' El jugador responsable del baneo. Puede ser un jugador o el ~~root~~ ([[getRootElement]])		*'''responsable:''' El jugador responsable del baneo. Puede ser un jugador o el elemento raíz ([[getRootElement]])
	*'''razón:''' La razón por la cual el jugador fue baneado.		*'''razón:''' La razón por la cual el jugador fue baneado.
	*'''segundos:''' El tiempo(en segundos) que va a estar baneado el jugador. ~~Usar~~ 0 ~~para~~ una cantidad indefinida de tiempo.		*'''segundos:''' El tiempo(en segundos) que va a estar baneado el jugador. Si se usa 0 entonces es una cantidad indefinida de tiempo.

	===Devuelve===		===Devuelve===
	{{New feature\|3\|1.0\|		{{New feature\|3\|1.0\|
	Devuelve un ~~puntero~~ [[ban]] si el jugador fue ~~baneado~~ satisfactoriamente, de lo contrario devuelve ''false''.		Devuelve un elemento [[ban]] si el jugador fue banneado satisfactoriamente, de lo contrario devuelve ''false''.
	}}		}}

	==Ejemplos==		==Ejemplos==
	Este ejemplo permite a un jugador banear a cualquiera si tiene los permisos ACL.		Este ejemplo permite a un jugador banear a cualquiera si tiene los permisos en el ACL.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	--Add the "ban" command handler		--Add the "ban" command handler

Sukha: Created page with "NOTOC {{Server function}} {{New feature|3|1.0| Esta función banea a un jugador por su IP, serial o nombre. }} ==Sintaxis== {{New feature|3|1.0| ban banP..."

2011-02-17T15:39:46Z

Created page with "__NOTOC__ {{Server function}} {{New feature|3|1.0| Esta función banea a un jugador por su IP, serial o nombre. }} ==Sintaxis== {{New feature|3|1.0| <syntaxhighlight lang="lua"> ban banP..."

New page

__NOTOC__
{{Server function}}
{{New feature|3|1.0|
Esta función banea a un jugador por su IP, [[serial]] o nombre.
}}

==Sintaxis==
{{New feature|3|1.0|
<syntaxhighlight lang="lua">
ban banPlayer ( player jugadorABanear, [ bool IP = true, bool Nombre = false, bool Serial = false,
player jugadorResponsable = nil, string razón = nil, int segundos = 0 ] )
</syntaxhighlight>
}}

===Argumentos Requeridos===
*'''jugadorABanear:''' El jugador que se quiere banear del servidor.

===Argumentos Opcionales===
{{OptionalArg}}
{{New feature|3|1.0|
*'''IP:''' Banear la IP del jugador?
*'''Username:''' Banear el nombre del jugador?
*'''Serial:''' Banear la serial del jugador?

:'''Note:''' Para banear por nombre o por serial, ''verifyserials'' tiene que estar habilitado en el archivo de configuración del servidor.

}}
*'''jugadorResponsable:''' El jugador responsable del baneo. Puede ser un jugador o el root ([[getRootElement]])
*'''razón:''' La razón por la cual el jugador fue baneado.
*'''segundos:''' El tiempo(en segundos) que va a estar baneado el jugador. Usar 0 para una cantidad indefinida de tiempo.

===Devuelve===
{{New feature|3|1.0|
Devuelve un puntero [[ban]] si el jugador fue baneado satisfactoriamente, de lo contrario devuelve ''false''.
}}

==Ejemplos==
Este ejemplo permite a un jugador banear a cualquiera si tiene los permisos ACL.
<syntaxhighlight lang="lua">
--Add the "ban" command handler
-- Example with the player
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 = getPlayerFromNick ( 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

end
addCommandHandler ( "ban", banPlayerCommand )

-- Example function with the root element. Here you would pass a player element to the function.
function banCheater(theCheater)
banPlayer(theCheater, getRootElement(), "You are banned because of cheating.")
end
</syntaxhighlight>

==See Also==
{{Funciones_Administrativas}}
[[en:BanPlayer]]
[[ru:BanPlayer]]

ES/banPlayer - Revision history

The Kid at 15:47, 17 February 2011

Sukha: Created page with "__NOTOC__ {{Server function}} {{New feature|3|1.0| Esta función banea a un jugador por su IP, serial o nombre. }} ==Sintaxis== {{New feature|3|1.0| ban banP..."

Sukha: Created page with "NOTOC {{Server function}} {{New feature|3|1.0| Esta función banea a un jugador por su IP, serial o nombre. }} ==Sintaxis== {{New feature|3|1.0| ban banP..."