Multi Theft Auto: Wiki - User contributions [en]

KickPlayer

2011-02-17T15:50:30Z

Sukha: /* See Also */

{{Server function}}
__NOTOC__
This function will kick the specified player from the server.

==Syntax==
<syntaxhighlight lang="lua">
bool kickPlayer ( player kickedPlayer, [ player responsiblePlayer, string reason = "" ] )
</syntaxhighlight>
''or''
<syntaxhighlight lang="lua">
bool kickPlayer ( player kickedPlayer, [ string reason = "" ] )
</syntaxhighlight>

===Required Arguments===
*'''kickedPlayer:''' The player that will be kicked from the server

===Optional Arguments===
{{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".
*'''reason:''' The reason for the kick.

===Returns===
Returns ''true'' if the player was kicked succesfully, ''false'' if invalid arguments are specified.

==Example==
This example lets a player kick anyone who has a lower level.
<syntaxhighlight lang="lua">
function kickPlayerHandler ( sourcePlayer, commandname, kickedname, reason )
-- Get player element from the name
local kicked = getPlayerFromNick ( kickedname )
-- If the client who sent the command has a higher level
if ( hasObjectPermissionTo ( sourcePlayer, "function.kickPlayer" ) ) then
-- Kick the player
kickPlayer ( kicked, sourcePlayer, reason )
end
end
-- Add the "kick" command handler
addCommandHandler ( "kick", kickPlayerHandler )
</syntaxhighlight>

==See Also==
{{Admin_functions}}
[[es:kickPlayer]]
[[ru:kickPlayer]]

KickPlayer

2011-02-17T15:49:59Z

Sukha:

ES/kickPlayer

2011-02-17T15:48:59Z

Sukha: /* Sintaxis */

{{Server function}}
__NOTOC__
Esta función kickea(desconecta) a un jugador del servidor.

==Sintaxis==
<syntaxhighlight lang="lua">
bool kickPlayer ( player jugadorAKickear, [ player jugadorResponsable, string razón = "" ] )
</syntaxhighlight>
''o''
<syntaxhighlight lang="lua">
bool kickPlayer ( player jugadorAKickear, [ string razón = "" ] )
</syntaxhighlight>

===Argumentos Requeridos===
*'''jugadorAKickear:''' El player que se quiere kickear del servidor.

===Argumentos Opcionales===
{{OptionalArg}}
*'''jugadorResponsable:''' El jugador responsable de la acción. '''Nota''': Si usas la segunda sintaxis, el jugador responsable va a ser "Console"(consola).
*'''razón:''' La razón del kickeo.

===Devuelve===
Devuelve ''true'' si el jugador fue kickeado satisfactoriamente, ''false'' si fueron ingresados argumentos inválidos.

==Ejemplos==
Este ejemplo permite a un jugador kickear a cualquier otro que tenga un nivel inferior.
<syntaxhighlight lang="lua">
function kickPlayerHandler ( sourcePlayer, commandname, kickedname, reason )
-- Get player element from the name
local kicked = getPlayerFromNick ( kickedname )
-- If the client who sent the command has a higher level
if ( hasObjectPermissionTo ( sourcePlayer, "function.kickPlayer" ) ) then
-- Kick the player
kickPlayer ( kicked, sourcePlayer, reason )
end
end
-- Add the "kick" command handler
addCommandHandler ( "kick", kickPlayerHandler )
</syntaxhighlight>

==Ver También==
{{Funciones_Administrativas}}
[[en:kickPlayer]]
[[ru:kickPlayer]]

ES/kickPlayer

2011-02-17T15:48:40Z

Sukha: Created page with "{{Server function}} __NOTOC__ Esta función kickea(desconecta) a un jugador del servidor. ==Sintaxis== <syntaxhighlight lang="lua"> bool kickPlayer ( player jugadorAKickear, [ player jugadorR..."

{{Server function}}
__NOTOC__
Esta función kickea(desconecta) a un jugador del servidor.

==Sintaxis==
<syntaxhighlight lang="lua">
bool kickPlayer ( player jugadorAKickear, [ player jugadorResponsable, string razón = "" ] )
</syntaxhighlight>
''or''
<syntaxhighlight lang="lua">
bool kickPlayer ( player jugadorAKickear, [ string razón = "" ] )
</syntaxhighlight>

===Argumentos Requeridos===
*'''jugadorAKickear:''' El player que se quiere kickear del servidor.

===Argumentos Opcionales===
{{OptionalArg}}
*'''jugadorResponsable:''' El jugador responsable de la acción. '''Nota''': Si usas la segunda sintaxis, el jugador responsable va a ser "Console"(consola).
*'''razón:''' La razón del kickeo.

===Devuelve===
Devuelve ''true'' si el jugador fue kickeado satisfactoriamente, ''false'' si fueron ingresados argumentos inválidos.

==Ejemplos==
Este ejemplo permite a un jugador kickear a cualquier otro que tenga un nivel inferior.
<syntaxhighlight lang="lua">
function kickPlayerHandler ( sourcePlayer, commandname, kickedname, reason )
-- Get player element from the name
local kicked = getPlayerFromNick ( kickedname )
-- If the client who sent the command has a higher level
if ( hasObjectPermissionTo ( sourcePlayer, "function.kickPlayer" ) ) then
-- Kick the player
kickPlayer ( kicked, sourcePlayer, reason )
end
end
-- Add the "kick" command handler
addCommandHandler ( "kick", kickPlayerHandler )
</syntaxhighlight>

==Ver También==
{{Funciones_Administrativas}}
[[en:kickPlayer]]
[[ru:kickPlayer]]

BanPlayer

2011-02-17T15:40:38Z

Sukha:

__NOTOC__
{{Server function}}
{{New feature|3|1.0|
This function will ban the specified player by either IP, [[serial]] or username
}}

{{Deprecated_feature|3|1.0|
This function will ban the specified player from the server by IP.
}}

==Syntax==
{{New feature|3|1.0|
<syntaxhighlight lang="lua">
ban banPlayer ( player bannedPlayer, [ bool IP = true, bool Username = false, bool Serial = false,
player responsiblePlayer = nil, string reason = nil, int seconds = 0 ] )
</syntaxhighlight>
}}

{{Deprecated_feature|3|1.0|
<syntaxhighlight lang="lua">
bool banPlayer ( player bannedPlayer , [ element responsibleElement, string reason ] )
</syntaxhighlight>
}}

===Required Arguments===
*'''bannedPlayer:''' The player that will be banned from the server.

===Optional Arguments===
{{OptionalArg}}
{{New feature|3|1.0|
*'''IP:''' Will player be banned by IP?
*'''Username:''' Will player be banned by username?
*'''Serial:''' Will player be banned by serial?

:'''Note:''' to ban by username or serial, ''verifyserials'' must be enabled in the server configuration file.

}}
*'''responsibleElement:''' The element that is responsible for banning the player. This can be a player or the root ([[getRootElement]]()).
*'''reason:''' The reason the player will be banned from the server.
*'''seconds:''' The amount of seconds the player will be banned from the server for. This can be 0 for an infinite amount of time.

===Returns===
{{Deprecated_feature|3|1.0|
Returns ''true'' if the player was banned succesfully, ''false'' if invalid arguments are specified.
}}

{{New feature|3|1.0|
Returns a [[ban]] pointer if banned successfully, or ''false'' if unsuccessful.
}}

==Example==
This example lets a player ban anyone if he has ACL rights.
<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==
{{Admin_functions}}
[[es:banPlayer]]
[[ru:BanPlayer]]

ES/banPlayer

2011-02-17T15:39:46Z

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| <syntaxhighlight lang="lua"> ban banP..."

__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/Funciones de Servidor

2011-02-16T20:32:32Z

Sukha: /* Funciones Administrativas */

<pageclass class="server"></pageclass>
Esta pagina muestra todas las funciones del '''servidor''' que han sido implementadas y disponibles como funciones nativas. Para pedir una función o un evento, usa [[Requested Functions and Events|pedido de funciones y eventos]] o http://bugs.mtasa.com.

Por favor ten en cuenta que las funciones se pueden también extender cargando un modulo dinámico que entregue una nueva funcionalidad, como el MySQL database access. Estas funciones no son nativas y requieren que el modulo este cargado para funcionar.

Vea [[Modules|Modulos]] para una lista de funciones de servidor no-nativas y módulos que están disponibles.

Para mas funciones, vea la pagina de [[Useful_Functions|funciones útiles]].

'''Las funciones de cliente se pueden encontrar aqui: [[Client Scripting Functions|Funciones de cliente]].'''

'''Tenga en cuenta que casi todas las funciones presentes no presentan una traducción en su definición'''

==Funciones de cuenta==
{{Funciones_de_Cuenta}}

==Funciones de ACL==
{{Funciones_de_ACL}}

==Funciones Administrativas==
{{Funciones_Administrativas}}

==Funciones de audio==
{{Audio_functions}}

==Funciones de anuncio==
{{Announce_functions}}

==Funciones de blip==
{{Blip_functions}}

==Funciones de cámara==
{{Camera functions}}

==Funciones de colisión==
{{Collision shape functions}}

==Funciones de ropa y cuerpo==
{{Clothes and body functions}}

==Funciones de cursor==
{{Cursor_functions}}

==Funciones de elemento==
{{Element functions}}

==Funciones de evento==
{{Event_functions}}

==Funciones explosivas==
{{Explosion_functions}}

==Funciones de archivos==
{{File_functions}}

==Funciones de HTTP==
{{HTTP_functions}}

==Funciones de Input==
{{Input_functions}}

==Funciones de mapa==
{{Map_functions}}

==Funciones de marcadores==
{{Marker functions}}

==Funciones de modulos==
{{Module functions}}

==Funciones de objetos==
{{Object functions}}

==Funciones de peds==
{{Ped_functions}}

==Funciones de pickup==
{{Pickup functions}}

==Funciones de jugadores==
{{Player functions}}

==Funciones de area de radar==
{{Radar area functions}}

==Funciones de recursos==
{{Resource functions}}

==Funciones de serial==
{{Serial functions}}

==Funciones de servidor==
{{Server functions}}

==Funciones de registro de propiedades==
{{Settings registry functions}}

==Funciones de SQL==
{{SQL_functions}}

==Funciones de equipo==
{{Team functions}}

==Funciones de texto==
{{Text functions}}

==Funciones de utilidad==
{{Utility functions}}

==Funciones de vehiculos==
{{Vehicle functions}}

==Funciones de agua==
{{Water functions}}

==Funciones de arma==
{{Weapon functions}}

==Funciones del mundo==
{{World functions}}

==Funciones de XML==
{{XML functions}}

[[ru:Server Scripting Functions]]
[[en:Server Scripting Functions]]

Template:Funciones Administrativas

2011-02-16T20:31:35Z

Sukha: Created page with "*banPlayer *kickPlayer {{New feature|3|1.0| *addBan *getBanAdmin *getBanIP *[[ES/getBanNick|ge..."

*[[ES/banPlayer|banPlayer]]
*[[ES/kickPlayer|kickPlayer]]
{{New feature|3|1.0|
*[[ES/addBan|addBan]]
*[[ES/getBanAdmin|getBanAdmin]]
*[[ES/getBanIP|getBanIP]]
*[[ES/getBanNick|getBanNick]]
*[[ES/getBanReason|getBanReason]]
*[[ES/getBans|getBans]]
*[[ES/getBanSerial|getBanSerial]]
*[[ES/getBanTime|getBanTime]]
*[[ES/getBanUsername|getBanUsername]]
*[[ES/getUnbanTime|getUnbanTime]]
*[[ES/removeBan|removeBan]]
}}
{{Deprecated_feature|3|1.0|
*[[ES/banIP|banIP]]
*[[ES/banSerial|banSerial]]
*[[ES/getBansXML|getBansXML]]
*[[ES/unbanIP|unbanIP]]
*[[ES/unbanSerial|unbanSerial]]
}}

ES/Funciones de Servidor

2011-02-16T20:27:55Z

Sukha: /* Funciones de ACL */

<pageclass class="server"></pageclass>
Esta pagina muestra todas las funciones del '''servidor''' que han sido implementadas y disponibles como funciones nativas. Para pedir una función o un evento, usa [[Requested Functions and Events|pedido de funciones y eventos]] o http://bugs.mtasa.com.

Por favor ten en cuenta que las funciones se pueden también extender cargando un modulo dinámico que entregue una nueva funcionalidad, como el MySQL database access. Estas funciones no son nativas y requieren que el modulo este cargado para funcionar.

Vea [[Modules|Modulos]] para una lista de funciones de servidor no-nativas y módulos que están disponibles.

Para mas funciones, vea la pagina de [[Useful_Functions|funciones útiles]].

'''Las funciones de cliente se pueden encontrar aqui: [[Client Scripting Functions|Funciones de cliente]].'''

'''Tenga en cuenta que casi todas las funciones presentes no presentan una traducción en su definición'''

==Funciones de cuenta==
{{Funciones_de_Cuenta}}

==Funciones de ACL==
{{Funciones_de_ACL}}

==Funciones Administrativas==
{{Admin_functions}}

==Funciones de audio==
{{Audio_functions}}

==Funciones de anuncio==
{{Announce_functions}}

==Funciones de blip==
{{Blip_functions}}

==Funciones de cámara==
{{Camera functions}}

==Funciones de colisión==
{{Collision shape functions}}

==Funciones de ropa y cuerpo==
{{Clothes and body functions}}

==Funciones de cursor==
{{Cursor_functions}}

==Funciones de elemento==
{{Element functions}}

==Funciones de evento==
{{Event_functions}}

==Funciones explosivas==
{{Explosion_functions}}

==Funciones de archivos==
{{File_functions}}

==Funciones de HTTP==
{{HTTP_functions}}

==Funciones de Input==
{{Input_functions}}

==Funciones de mapa==
{{Map_functions}}

==Funciones de marcadores==
{{Marker functions}}

==Funciones de modulos==
{{Module functions}}

==Funciones de objetos==
{{Object functions}}

==Funciones de peds==
{{Ped_functions}}

==Funciones de pickup==
{{Pickup functions}}

==Funciones de jugadores==
{{Player functions}}

==Funciones de area de radar==
{{Radar area functions}}

==Funciones de recursos==
{{Resource functions}}

==Funciones de serial==
{{Serial functions}}

==Funciones de servidor==
{{Server functions}}

==Funciones de registro de propiedades==
{{Settings registry functions}}

==Funciones de SQL==
{{SQL_functions}}

==Funciones de equipo==
{{Team functions}}

==Funciones de texto==
{{Text functions}}

==Funciones de utilidad==
{{Utility functions}}

==Funciones de vehiculos==
{{Vehicle functions}}

==Funciones de agua==
{{Water functions}}

==Funciones de arma==
{{Weapon functions}}

==Funciones del mundo==
{{World functions}}

==Funciones de XML==
{{XML functions}}

[[ru:Server Scripting Functions]]
[[en:Server Scripting Functions]]

Template:Funciones de ACL

2011-02-16T20:27:24Z

Sukha: Created page with "*aclCreate *aclCreateGroup *aclDestroy *aclDestroyGroup *aclGet *[[ES/aclGetGroup|ac..."

*[[ES/aclCreate|aclCreate]]
*[[ES/aclCreateGroup|aclCreateGroup]]
*[[ES/aclDestroy|aclDestroy]]
*[[ES/aclDestroyGroup|aclDestroyGroup]]
*[[ES/aclGet|aclGet]]
*[[ES/aclGetGroup|aclGetGroup]]
*[[ES/aclGetName|aclGetName]]
*[[ES/aclGetRight|aclGetRight]]
*[[ES/aclGroupList|aclGroupList]]
*[[ES/aclGroupAddACL|aclGroupAddACL]]
*[[ES/aclGroupAddObject|aclGroupAddObject]]
*[[ES/aclGroupGetName|aclGroupGetName]]
*[[ES/aclGroupListACL|aclGroupListACL]]
*[[ES/aclGroupListObjects|aclGroupListObjects]]
*[[ES/aclGroupRemoveACL|aclGroupRemoveACL]]
*[[ES/aclGroupRemoveObject|aclGroupRemoveObject]]
*[[ES/aclList|aclList]]
*[[ES/aclListRights|aclListRights]]
*[[ES/aclReload|aclReload]]
*[[ES/aclRemoveRight|aclRemoveRight]]
*[[ES/aclSave|aclSave]]
*[[ES/aclSetRight|aclSetRight]]
*[[ES/hasObjectPermissionTo|hasObjectPermissionTo]]
{{New feature|3|1.0|
*[[ES/isObjectInACLGroup|isObjectInACLGroup]]
}}

ES/getAccountData

2011-02-16T20:15:34Z

Sukha:

{{Server function}}
__NOTOC__
{{Note_box|Es muy importante que nombres tus claves de la forma ''modulo.clave'', como se muestra en el ejemplo. Esto previene interferencias con otros scripts.}}
Esta función obtiene la información que fue guardada en una cuenta usando [[ES/setAccountData|setAccountData]]. La información guardada en una cuenta no se borra cuando el jugador deja el servidor o cambia de mapa.

==Sintaxis==
<syntaxhighlight lang="lua">
string getAccountData ( account laCuenta, string laClave)
</syntaxhighlight>

===Argumentos Requeridos===
*'''laCuenta:''' La cuenta de la cual quieres obtener información.
*'''laClave:''' La clave bajo la cual esta guardada la información.

===Devuelve===
Devuelve una [[ES/string|string]](cadena de texto) con la información requerida o ''false'' si no hay información guardada bajo esa clave.

==Ejemplos==
For a pirate roleplaying gametype, the amount of money a player has is made persistent by storing it in his account. Note the code uses "piraterpg.money" as key instead of just "money", as the player may be participating in other gametypes that also save his money amount to his account. If both gametypes would use "money" as the account key, they'd overwrite each other's data.
<syntaxhighlight lang="lua">
function onPlayerQuit ( )
-- when a player leaves, store his current money amount in his account data
local playeraccount = getPlayerAccount ( source )
if ( playeraccount ) then
local playermoney = getPlayerMoney ( source )
setAccountData ( playeraccount, "piraterpg.money", playermoney )
end
end

function onPlayerJoin ( )
-- when a player joins, retrieve his money amount from his account data and set it
local playeraccount = getPlayerAccount ( source )
if ( playeraccount ) then
local playermoney = getAccountData ( playeraccount, "piraterpg.money" )
-- make sure there was actually a value saved under this key (check if playermoney is not false).
-- this will for example not be the case when a player plays the gametype for the first time
if ( playermoney ) then
setPlayerMoney ( source, playermoney )
end
end
end

addEventHandler ( "onPlayerQuit", getRootElement ( ), onPlayerQuit )
addEventHandler ( "onPlayerJoin", getRootElement ( ), onPlayerJoin )
</syntaxhighlight>

==See Also==
{{Funciones_de_Cuenta}}

[[en:GetAccountData]]

ES/getAccountData

2011-02-16T20:14:32Z

Sukha:

{{Server function}}
__NOTOC__
{{Note_box|Es muy importante que nombres tus claves de la forma ''modulo.clave'', como se muestra en el ejemplo. Esto previene interferencias con otros scripts.}}
Esta función obtiene la información que fue guardada en una cuenta usando [[ES/setAccountData]]. La información guardada en una cuenta no se borra cuando el jugador deja el servidor o cambia de mapa.

==Sintaxis==
<syntaxhighlight lang="lua">
string getAccountData ( account laCuenta, string laClave)
</syntaxhighlight>

===Argumentos Requeridos===
*'''laCuenta:''' La cuenta de la cual quieres obtener información.
*'''laClave:''' La clave bajo la cual esta guardada la información.

===Devuelve===
Devuelve una [[string]](cadena de texto) con la información requerida o ''false'' si no hay información guardada bajo esa clave.

==Ejemplos==
For a pirate roleplaying gametype, the amount of money a player has is made persistent by storing it in his account. Note the code uses "piraterpg.money" as key instead of just "money", as the player may be participating in other gametypes that also save his money amount to his account. If both gametypes would use "money" as the account key, they'd overwrite each other's data.
<syntaxhighlight lang="lua">
function onPlayerQuit ( )
-- when a player leaves, store his current money amount in his account data
local playeraccount = getPlayerAccount ( source )
if ( playeraccount ) then
local playermoney = getPlayerMoney ( source )
setAccountData ( playeraccount, "piraterpg.money", playermoney )
end
end

function onPlayerJoin ( )
-- when a player joins, retrieve his money amount from his account data and set it
local playeraccount = getPlayerAccount ( source )
if ( playeraccount ) then
local playermoney = getAccountData ( playeraccount, "piraterpg.money" )
-- make sure there was actually a value saved under this key (check if playermoney is not false).
-- this will for example not be the case when a player plays the gametype for the first time
if ( playermoney ) then
setPlayerMoney ( source, playermoney )
end
end
end

addEventHandler ( "onPlayerQuit", getRootElement ( ), onPlayerQuit )
addEventHandler ( "onPlayerJoin", getRootElement ( ), onPlayerJoin )
</syntaxhighlight>

==See Also==
{{Funciones_de_Cuenta}}

[[en:GetAccountData]]

ES/getAccountData

2011-02-16T20:13:55Z

Sukha:

{{Server function}}
__NOTOC__
{{Note_box|Es muy importante que nombres tus claves de la forma ''modulo.clave'', como se muestra en el ejemplo. Esto previene interferencias con otros scripts.}}
Esta función obtiene la información que fue guardada en una cuenta usando [[setAccountData]]. La información guardada en una cuenta no se borra cuando el jugador deja el servidor o cambia de mapa.

==Sintaxis==
<syntaxhighlight lang="lua">
string getAccountData ( account laCuenta, string laClave)
</syntaxhighlight>

===Argumentos Requeridos===
*'''laCuenta:''' La cuenta de la cual quieres obtener información.
*'''laClave:''' La clave bajo la cual esta guardada la información.

===Devuelve===
Devuelve una [[string]](cadena de texto) con la información requerida o ''false'' si no hay información guardada bajo esa clave.

==Ejemplos==
For a pirate roleplaying gametype, the amount of money a player has is made persistent by storing it in his account. Note the code uses "piraterpg.money" as key instead of just "money", as the player may be participating in other gametypes that also save his money amount to his account. If both gametypes would use "money" as the account key, they'd overwrite each other's data.
<syntaxhighlight lang="lua">
function onPlayerQuit ( )
-- when a player leaves, store his current money amount in his account data
local playeraccount = getPlayerAccount ( source )
if ( playeraccount ) then
local playermoney = getPlayerMoney ( source )
setAccountData ( playeraccount, "piraterpg.money", playermoney )
end
end

function onPlayerJoin ( )
-- when a player joins, retrieve his money amount from his account data and set it
local playeraccount = getPlayerAccount ( source )
if ( playeraccount ) then
local playermoney = getAccountData ( playeraccount, "piraterpg.money" )
-- make sure there was actually a value saved under this key (check if playermoney is not false).
-- this will for example not be the case when a player plays the gametype for the first time
if ( playermoney ) then
setPlayerMoney ( source, playermoney )
end
end
end

addEventHandler ( "onPlayerQuit", getRootElement ( ), onPlayerQuit )
addEventHandler ( "onPlayerJoin", getRootElement ( ), onPlayerJoin )
</syntaxhighlight>

==See Also==
{{Funciones_de_Cuenta}}

[[en:GetAccountData]]

ES/getAccountData

2011-02-16T20:13:12Z

Sukha:

{{Server function}}
__NOTOC__
{{Note_box|Es muy importante que nombres tus claves de la forma ''modulo.clave'', como se muestra en el ejemplo. Esto previene interferencias con otros scripts.}}
Esta función obtiene la información que fue guardada en una cuenta usando [[es:setAccountData]]. La información guardada en una cuenta no se borra cuando el jugador deja el servidor o cambia de mapa.

==Sintaxis==
<syntaxhighlight lang="lua">
string getAccountData ( account laCuenta, string laClave)
</syntaxhighlight>

===Argumentos Requeridos===
*'''laCuenta:''' La cuenta de la cual quieres obtener información.
*'''laClave:''' La clave bajo la cual esta guardada la información.

===Devuelve===
Devuelve una [[string]](cadena de texto) con la información requerida o ''false'' si no hay información guardada bajo esa clave.

==Ejemplos==
For a pirate roleplaying gametype, the amount of money a player has is made persistent by storing it in his account. Note the code uses "piraterpg.money" as key instead of just "money", as the player may be participating in other gametypes that also save his money amount to his account. If both gametypes would use "money" as the account key, they'd overwrite each other's data.
<syntaxhighlight lang="lua">
function onPlayerQuit ( )
-- when a player leaves, store his current money amount in his account data
local playeraccount = getPlayerAccount ( source )
if ( playeraccount ) then
local playermoney = getPlayerMoney ( source )
setAccountData ( playeraccount, "piraterpg.money", playermoney )
end
end

function onPlayerJoin ( )
-- when a player joins, retrieve his money amount from his account data and set it
local playeraccount = getPlayerAccount ( source )
if ( playeraccount ) then
local playermoney = getAccountData ( playeraccount, "piraterpg.money" )
-- make sure there was actually a value saved under this key (check if playermoney is not false).
-- this will for example not be the case when a player plays the gametype for the first time
if ( playermoney ) then
setPlayerMoney ( source, playermoney )
end
end
end

addEventHandler ( "onPlayerQuit", getRootElement ( ), onPlayerQuit )
addEventHandler ( "onPlayerJoin", getRootElement ( ), onPlayerJoin )
</syntaxhighlight>

==See Also==
{{Funciones_de_Cuenta}}

[[en:GetAccountData]]

ES/getAccountData

2011-02-16T20:12:27Z

Sukha: Created page with "{{Server function}} __NOTOC__ {{Note_box|Es muy importante que nombres tus claves de la forma ''modulo.clave'', como se muestra en el ejemplo. Esto previene interferencias con ot..."

{{Server function}}
__NOTOC__
{{Note_box|Es muy importante que nombres tus claves de la forma ''modulo.clave'', como se muestra en el ejemplo. Esto previene interferencias con otros scripts.}}
Esta función obtiene la información que fue guardada en una cuenta usando [[es:setAccountData]]. La información guardada en una cuenta no se borra cuando el jugador deja el servidor o cambia de mapa.

==Sintaxis==
<syntaxhighlight lang="lua">
string getAccountData ( account laCuenta, string laClave)
</syntaxhighlight>

===Argumentos Requeridos===
*'''laCuenta:''' La cuenta de la cual quieres obtener información.
*'''laClave:''' La clave bajo la cual esta guardada la información.

===Devuelve===
Devuelve una [[es:string]](cadena de texto) con la información requerida o ''false'' si no hay información guardada bajo esa clave.

==Ejemplos==
For a pirate roleplaying gametype, the amount of money a player has is made persistent by storing it in his account. Note the code uses "piraterpg.money" as key instead of just "money", as the player may be participating in other gametypes that also save his money amount to his account. If both gametypes would use "money" as the account key, they'd overwrite each other's data.
<syntaxhighlight lang="lua">
function onPlayerQuit ( )
-- when a player leaves, store his current money amount in his account data
local playeraccount = getPlayerAccount ( source )
if ( playeraccount ) then
local playermoney = getPlayerMoney ( source )
setAccountData ( playeraccount, "piraterpg.money", playermoney )
end
end

function onPlayerJoin ( )
-- when a player joins, retrieve his money amount from his account data and set it
local playeraccount = getPlayerAccount ( source )
if ( playeraccount ) then
local playermoney = getAccountData ( playeraccount, "piraterpg.money" )
-- make sure there was actually a value saved under this key (check if playermoney is not false).
-- this will for example not be the case when a player plays the gametype for the first time
if ( playermoney ) then
setPlayerMoney ( source, playermoney )
end
end
end

addEventHandler ( "onPlayerQuit", getRootElement ( ), onPlayerQuit )
addEventHandler ( "onPlayerJoin", getRootElement ( ), onPlayerJoin )
</syntaxhighlight>

==See Also==
{{Funciones_de_Cuenta}}

[[en:GetAccountData]]

GetAccount

2011-02-16T19:53:11Z

Sukha:

__NOTOC__
{{Server function}}
This function returns an account for a specific user.
==Syntax==
<syntaxhighlight lang="lua">
account getAccount ( string username, [ string password ] )
</syntaxhighlight>

===Required Arguments===
*'''username:''' The username of the account you want to retrieve

===Optional Arguments===
{{OptionalArg}}
*'''password:''' The password for the account. If this argument is not specified, you can get the account whatever password it is, otherwise the password must match the account's.

===Returns===
An ''account'' value or ''false'' if an account matching the username specified (and password, if specified) could not be found.

==Example==
<syntaxhighlight lang="lua">
function retAccount ( username, password ) --both arguements are strings
if getAccount( username, password ) then
return getAccount( username, password )
else
return false
end
end
</syntaxhighlight>

==See Also==
{{Account functions}}

[[es:getAccount]]
[[pl:GetAccount]]

ES/getAccount

2011-02-16T19:51:54Z

Sukha: Created page with "__NOTOC__ {{Server function}} Esta función obtiene una cuenta a partir de su nombre. ==Sintaxis== <syntaxhighlight lang="lua"> account getAccount ( string nombreCuenta, [ string contraseña ] ) ..."

__NOTOC__
{{Server function}}
Esta función obtiene una cuenta a partir de su nombre.
==Sintaxis==
<syntaxhighlight lang="lua">
account getAccount ( string nombreCuenta, [ string contraseña ] )
</syntaxhighlight>

===Argumentos Requeridos===
*'''nombreCuenta:''' El nombre de la cuenta que quieres obtener.

===Argumentos Opcionales===
{{OptionalArg}}
*'''contraseña:''' La contraseña de la cuenta. Si no especificas este argumento podras obtener la cuenta sea cual sea la contraseña, de lo contrario la contraseña debe coincidir con la de la cuenta.

===Devuelve===
Devuelve el elemento ''account''(la cuenta) o ''false'' si no se pudo encontrar ninguna cuenta que coincida con los datos introducidos(nombre y contraseña).

==Ejemplos==
<syntaxhighlight lang="lua">
function retAccount ( username, password ) --both arguements are strings
if getAccount( username, password ) then
return getAccount( username, password )
else
return false
end
end
</syntaxhighlight>

==See Also==
{{Funciones_de_Cuenta}}

[[en:GetAccount]]
[[pl:GetAccount]]

ES/AddAccount

2011-02-16T19:41:09Z

Sukha: /* Ver También */

{{Server function}}
__NOTOC__
Esta función agrega una cuenta a la lista de cuentas registradas del servidor.

==Sintaxis==
{{New feature|3|1.0 r848|
<syntaxhighlight lang="lua">
account addAccount ( string nombre, string contraseña )
</syntaxhighlight>
}}

===Argumentos Requeridos===
*'''nombre:''' El nombre de la cuenta que deseas crear, normalmente se hace coincidir con el nombre del jugador(no es obligatorio que coincida).
*'''contraseña:''' La contraseña con la cual se va a acceder a la cuenta.

===Devuelve===
{{New feature|3|1.0 r848|
Devuelve el elemento ''account'' (cuenta) si la cuenta fue creada satisfactoriamente, ''false'' si la cuenta ya existía o si ocurrió un error.
}}

==Ejemplo==
<section name="Server" class="server" show="true">
'''Ejemplo 1:''' Esto permite que los jugadores se registren usando el comando /register <contraseña>.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, password )
-- Revisar si el campo de contraseña es válido
if ( password ~= "" and password ~= nil ) then
-- Crear una cuenta, y guardar la variable cuenta de forma local.
local accountAdded = addAccount( getPlayerName(source), password )
if ( accountAdded ) then
-- Si todo funcionó, entonces al jugador se le anuncia.
outputChatBox ( "Gracias, " .. getPlayerName(source) .. ", ahora que estas registrado, logueate con /login", source )
else
-- Si algo salió mal, al jugador se le anuncia también.
outputChatBox ( "Error creando cuenta, contacta al administrador del servidor.", source )
end
else
-- Si hubo error en el sintaxis, anunciarlo también.
outputChatBox ( "Error creando cuenta, sintaxis correcto: /register <contrasena>", source )
end
end
addCommandHandler ( "register", registerPlayer ) -- Agrega un comando para registrarse.
</syntaxhighlight>

'''A diferencia del primero, el código siguiente permite a los jugadores crear una cuenta con un nombre distinto a su actual nick.'''

'''Ejemplo 2:''' Esto permite a los jugadores registrarse en el servidor usando el comando /register <nombre> <contraseña>.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Gracias, " .. getPlayerName(source) .. ", ahora que estas registrado, logueate con /login",source)
else
outputChatBox("Error creando cuenta, contacta al administrador del servidor.",source)
end
else
outputChatBox("Error creando cuenta, sintaxis correcto: /register <nombre> <contrasena>",source)
end
end
addCommandHandler ( "register", registerPlayer ) -- Agrega un comando para registrarse.
</syntaxhighlight>

'''Ejemplo 3:''' Este código permite a los jugadores registrarse(crear una cuenta) sólo una sola vez usando /register <nombre> <contraseña>.
<syntaxhighlight lang="lua">
local bRegisteredOnce = false

function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil and bRegisteredOnce == false) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Gracias, " .. getPlayerName(source) .. ", ahora que estas registrado, logueate con /login",source)
bRegisteredOnce = true
else
outputChatBox("Error creando cuenta, contacta al administrador del servidor.",source)
end
else
if bRegisteredOnce == true then
outputChatBox("Ya registraste una cuenta en este servidor!",source)
else
outputChatBox("Error creando cuenta, sintaxis correcto: /register <nombre> <contrasena>",source)
end
end
end
addCommandHandler ( "register", registerPlayer ) -- Agrega un comando para registrarse.
</syntaxhighlight>
</section>

==Ver También==

{{Funciones_de_Cuenta}}

[[en:AddAccount]]

ES/copyAccountData

2011-02-16T19:36:46Z

Sukha: Created page with "__NOTOC__ {{Server function}} Esta función copia toda la información de una cuenta en otra. ==Sintaxis== <syntaxhighlight lang="lua"> bool copyAccountData ( account laCuentaCopiada, accoun..."

__NOTOC__
{{Server function}}
Esta función copia toda la información de una cuenta en otra.

==Sintaxis==
<syntaxhighlight lang="lua">
bool copyAccountData ( account laCuentaCopiada, account laCuentaDestino )
</syntaxhighlight>

===Argumentos Requeridos===
*'''laCuentaCopiada:''' La cuenta de la cual quieres copiar la información.
*'''laCuentaDestino:''' La cuenta cuenta que va a recibir la información copiada.

===Devuelve===
Devuelve ''true'' si las cuentas son validas, de lo contrario devuelve ''false''.

==Ejemplos==
This example copies the account data from the 'guest' to a registered account when they login
<syntaxhighlight lang="lua">
function copyDataOnLogin ( previousAccount, currentAccount, autoLogin)
copyAccountData ( currentAccount, previousAccount )
end
addEventHandler ( "onPlayerLogin", getRootElement(), copyDataOnLogin )

</syntaxhighlight>

==See Also==
{{Funciones_de_Cuenta}}

ES/AddAccount

2011-02-16T19:24:12Z

Sukha: /* Devuelve */

ES/Funciones de Servidor

2011-02-16T17:23:32Z

Sukha: /* Funciones de cuenta */

<pageclass class="server"></pageclass>
Esta pagina muestra todas las funciones del '''servidor''' que han sido implementadas y disponibles como funciones nativas. Para pedir una función o un evento, usa [[Requested Functions and Events|pedido de funciones y eventos]] o http://bugs.mtasa.com.

Por favor ten en cuenta que las funciones se pueden también extender cargando un modulo dinámico que entregue una nueva funcionalidad, como el MySQL database access. Estas funciones no son nativas y requieren que el modulo este cargado para funcionar.

Vea [[Modules|Modulos]] para una lista de funciones de servidor no-nativas y módulos que están disponibles.

Para mas funciones, vea la pagina de [[Useful_Functions|funciones útiles]].

'''Las funciones de cliente se pueden encontrar aqui: [[Client Scripting Functions|Funciones de cliente]].'''

'''Tenga en cuenta que casi todas las funciones presentes no presentan una traducción en su definición'''

==Funciones de cuenta==
{{Funciones_de_Cuenta}}

==Funciones de ACL==
{{ACL_functions}}

==Funciones Administrativas==
{{Admin_functions}}

==Funciones de audio==
{{Audio_functions}}

==Funciones de anuncio==
{{Announce_functions}}

==Funciones de blip==
{{Blip_functions}}

==Funciones de cámara==
{{Camera functions}}

==Funciones de colisión==
{{Collision shape functions}}

==Funciones de ropa y cuerpo==
{{Clothes and body functions}}

==Funciones de cursor==
{{Cursor_functions}}

==Funciones de elemento==
{{Element functions}}

==Funciones de evento==
{{Event_functions}}

==Funciones explosivas==
{{Explosion_functions}}

==Funciones de archivos==
{{File_functions}}

==Funciones de HTTP==
{{HTTP_functions}}

==Funciones de Input==
{{Input_functions}}

==Funciones de mapa==
{{Map_functions}}

==Funciones de marcadores==
{{Marker functions}}

==Funciones de modulos==
{{Module functions}}

==Funciones de objetos==
{{Object functions}}

==Funciones de peds==
{{Ped_functions}}

==Funciones de pickup==
{{Pickup functions}}

==Funciones de jugadores==
{{Player functions}}

==Funciones de area de radar==
{{Radar area functions}}

==Funciones de recursos==
{{Resource functions}}

==Funciones de serial==
{{Serial functions}}

==Funciones de servidor==
{{Server functions}}

==Funciones de registro de propiedades==
{{Settings registry functions}}

==Funciones de SQL==
{{SQL_functions}}

==Funciones de equipo==
{{Team functions}}

==Funciones de texto==
{{Text functions}}

==Funciones de utilidad==
{{Utility functions}}

==Funciones de vehiculos==
{{Vehicle functions}}

==Funciones de agua==
{{Water functions}}

==Funciones de arma==
{{Weapon functions}}

==Funciones del mundo==
{{World functions}}

==Funciones de XML==
{{XML functions}}

[[ru:Server Scripting Functions]]
[[en:Server Scripting Functions]]

Template:Funciones de Cuenta

2011-02-16T17:21:39Z

Sukha:

*[[ES/addAccount|addAccount]]
*[[ES/copyAccountData|copyAccountData]]
*[[ES/getAccount|getAccount]]
*[[ES/getAccountData|getAccountData]]
*[[ES/getAccountName|getAccountName]]
{{New feature|3|1.0|
*[[ES/getAccountPlayer|getAccountPlayer]]
}}
*[[ES/getAccounts|getAccounts]]
*[[ES/isGuestAccount|isGuestAccount]]
*[[ES/logIn|logIn]]
*[[ES/logOut|logOut]]
*[[ES/removeAccount|removeAccount]]
*[[ES/setAccountData|setAccountData]]
*[[ES/setAccountPassword|setAccountPassword]]
{{Deprecated_feature|3|1.0|
*[[ES/getAccountClient|getAccountClient]]
}}

Template:Funciones de Cuenta

2011-02-16T17:18:39Z

Sukha: Created page with "*ES/addAccount *ES/copyAccountData *ES/getAccount *ES/getAccountData *ES/getAccountName {{New feature|3|1.0| *ES/getAccountPlayer }} *ES/getAccounts *..."

*[[ES/addAccount]]
*[[ES/copyAccountData]]
*[[ES/getAccount]]
*[[ES/getAccountData]]
*[[ES/getAccountName]]
{{New feature|3|1.0|
*[[ES/getAccountPlayer]]
}}
*[[ES/getAccounts]]
*[[ES/isGuestAccount]]
*[[ES/logIn]]
*[[ES/logOut]]
*[[ES/removeAccount]]
*[[ES/setAccountData]]
*[[ES/setAccountPassword]]
{{Deprecated_feature|3|1.0|
*[[ES/getAccountClient]]
}}

AddAccount

2011-02-15T22:45:47Z

Sukha:

{{Server function}}
__NOTOC__
This function adds an account to the list of registered accounts of the current server.

==Syntax==

{{New feature|3|1.0 r848|
<syntaxhighlight lang="lua">
account addAccount ( string name, string pass )
</syntaxhighlight>
}}
{{Deprecated_feature|3|1.0|
<syntaxhighlight lang="lua">
bool addAccount ( string name, string pass )
</syntaxhighlight>
}}

===Required Arguments===

*'''name:''' The name of the account you wish to make, this normally is the player's name.
*'''pass:''' The password to set for this account for future logins.

===Returns===

{{New feature|3|1.0 r848|
Returns the ''account'' element if the account was created, ''false'' if the account already exists or an error occured.
}}
{{Deprecated_feature|3|1.0|
Returns ''true'' if the account was created, ''false'' if the account already exists or an error occured.
}}

==Example==
<section name="Server" class="server" show="true">
'''Example 1:''' This enables players to register on your server by using /register <password> in the chat window.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, password )
-- Check if the password field is blank or not (only blank if they didnt enter one)
if ( password ~= "" and password ~= nil ) then
--Attempt to add the account, and save its value in a var
local accountAdded = addAccount( getPlayerName(source), password )
if ( accountAdded ) then
-- Tell the user all is done
outputChatBox ( "Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login", source )
else
-- There was an error making the account, tell the user
outputChatBox ( "Error creating account, contact the server admin", source )
end
else
-- There was an error in the syntax, tell the user the correct syntax.
outputChatBox ( "Error creating account, correct syntax: /register <password>", source )
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>

'''This code differs by allowing the user to change their username that they wish to use.'''

'''Example 2:''' This enables players to register on your server by using /register <username> <password> in the chat window.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login",source)
else
outputChatBox("Error creating account, contact the server admin.",source)
end
else
outputChatBox("Error creating account, correct syntax: /register <nick> <pass>",source)
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>

'''Example 3:''' This code differs again so the user can only register once /register <username> <password>.
<syntaxhighlight lang="lua">
local bRegisteredOnce = false

function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil and bRegisteredOnce == false) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login",source)
bRegisteredOnce = true
else
outputChatBox("Error creating account, contact the server admin.",source)
end
else
if bRegisteredOnce == true then
outputChatBox("You already registered on this server!",source)
else
outputChatBox("Error creating account, correct syntax: /register <nick> <pass>",source)
end
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>
</section>

==See Also==

{{Account_functions}}

[[es:AddAcount]]

AddAccount

2011-02-15T22:44:10Z

Sukha:

ES/addAccount

2011-02-15T22:41:19Z

Sukha: /* Argumentos requeridos */

{{Server function}}
__NOTOC__
Esta función agrega una cuenta a la lista de cuentas registradas del servidor.

==Sintaxis==

{{New feature|3|1.0 r848|
<syntaxhighlight lang="lua">
account addAccount ( string nombre, string contraseña )
</syntaxhighlight>
}}
{{Deprecated_feature|3|1.0|
<syntaxhighlight lang="lua">
bool addAccount ( string name, string pass )
</syntaxhighlight>
}}

===Argumentos Requeridos===

*'''nombre:''' El nombre de la cuenta que deseas crear, normalmente se hace coincidir con el nombre del jugador(no es obligatorio que coincida).
*'''contraseña:''' La contraseña con la cual se va a acceder a la cuenta.

===Devuelve===

{{New feature|3|1.0 r848|
Devuelve el elemento ''account'' si la cuenta fue creada satisfactoriamente, ''false'' si la cuenta ya existía o si ocurrió un error.
}}
{{Deprecated_feature|3|1.0|
Returns ''true'' if the account was created, ''false'' if the account already exists or an error occured.
}}

==Ejemplo==
<section name="Server" class="server" show="true">
'''Ejemplo 1:''' Esto permite que los jugadores se registren usando el comando /register <contraseña>.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, password )
-- Check if the password field is blank or not (only blank if they didnt enter one)
if ( password ~= "" and password ~= nil ) then
--Attempt to add the account, and save its value in a var
local accountAdded = addAccount( getPlayerName(source), password )
if ( accountAdded ) then
-- Tell the user all is done
outputChatBox ( "Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login", source )
else
-- There was an error making the account, tell the user
outputChatBox ( "Error creating account, contact the server admin", source )
end
else
-- There was an error in the syntax, tell the user the correct syntax.
outputChatBox ( "Error creating account, correct syntax: /register <password>", source )
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>

'''A diferencia del primero, el código siguiente permite a los jugadores crear una cuenta con un nombre distinto a su actual nick.'''

'''Ejemplo 2:''' Esto permite a los jugadores registrarse en el servidor usando el comando /register <nombre> <contraseña>.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login",source)
else
outputChatBox("Error creating account, contact the server admin.",source)
end
else
outputChatBox("Error creating account, correct syntax: /register <nick> <pass>",source)
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>

'''Ejemplo 3:''' Este código permite a los jugadores registrarse(crear una cuenta) sólo una sola vez usando /register <nombre> <contraseña>.
<syntaxhighlight lang="lua">
local bRegisteredOnce = false

function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil and bRegisteredOnce == false) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login",source)
bRegisteredOnce = true
else
outputChatBox("Error creating account, contact the server admin.",source)
end
else
if bRegisteredOnce == true then
outputChatBox("You already registered on this server!",source)
else
outputChatBox("Error creating account, correct syntax: /register <nick> <pass>",source)
end
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>
</section>

==Ver También==

{{Account_functions}}

ES/addAccount

2011-02-15T22:30:00Z

Sukha: Created page with "{{Server function}} __NOTOC__ Esta función agrega una cuenta a la lista de cuentas registradas del servidor. ==Sintaxis== <!-- NOTE: don't use 'special' names for variable nam..."

{{Server function}}
__NOTOC__
Esta función agrega una cuenta a la lista de cuentas registradas del servidor.

==Sintaxis==

{{New feature|3|1.0 r848|
<syntaxhighlight lang="lua">
account addAccount ( string nombre, string contraseña )
</syntaxhighlight>
}}
{{Deprecated_feature|3|1.0|
<syntaxhighlight lang="lua">
bool addAccount ( string name, string pass )
</syntaxhighlight>
}}

===Argumentos requeridos===

*'''nombre:''' El nombre de la cuenta que deseas crear, normalmente se hace coincidir con el nombre del jugador(no es obligatorio que coincida).
*'''contraseña:''' La contraseña con la cual se va a acceder a la cuenta.

===Devuelve===

{{New feature|3|1.0 r848|
Devuelve el elemento ''account'' si la cuenta fue creada satisfactoriamente, ''false'' si la cuenta ya existía o si ocurrió un error.
}}
{{Deprecated_feature|3|1.0|
Returns ''true'' if the account was created, ''false'' if the account already exists or an error occured.
}}

==Ejemplo==
<section name="Server" class="server" show="true">
'''Ejemplo 1:''' Esto permite que los jugadores se registren usando el comando /register <contraseña>.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, password )
-- Check if the password field is blank or not (only blank if they didnt enter one)
if ( password ~= "" and password ~= nil ) then
--Attempt to add the account, and save its value in a var
local accountAdded = addAccount( getPlayerName(source), password )
if ( accountAdded ) then
-- Tell the user all is done
outputChatBox ( "Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login", source )
else
-- There was an error making the account, tell the user
outputChatBox ( "Error creating account, contact the server admin", source )
end
else
-- There was an error in the syntax, tell the user the correct syntax.
outputChatBox ( "Error creating account, correct syntax: /register <password>", source )
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>

'''A diferencia del primero, el código siguiente permite a los jugadores crear una cuenta con un nombre distinto a su actual nick.'''

'''Ejemplo 2:''' Esto permite a los jugadores registrarse en el servidor usando el comando /register <nombre> <contraseña>.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login",source)
else
outputChatBox("Error creating account, contact the server admin.",source)
end
else
outputChatBox("Error creating account, correct syntax: /register <nick> <pass>",source)
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>

'''Ejemplo 3:''' Este código permite a los jugadores registrarse(crear una cuenta) sólo una sola vez usando /register <nombre> <contraseña>.
<syntaxhighlight lang="lua">
local bRegisteredOnce = false

function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil and bRegisteredOnce == false) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login",source)
bRegisteredOnce = true
else
outputChatBox("Error creating account, contact the server admin.",source)
end
else
if bRegisteredOnce == true then
outputChatBox("You already registered on this server!",source)
else
outputChatBox("Error creating account, correct syntax: /register <nick> <pass>",source)
end
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>
</section>

==Ver También==

{{Account_functions}}