Multi Theft Auto: Wiki - User contributions [en]

CreateBlip

2011-12-16T20:32:21Z

MarioKartero:

__NOTOC__
{{Server client function}}
This function creates a [[blip]] [[element]], which is displayed as an icon on the client's radar.

==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
blip createBlip ( float x, float y, float z, [int icon=0, int size=2, int r=255, int g=0, int b=0, int a=255,
int ordering=0 *, float visibleDistance=99999.0, visibleTo = getRootElement()] )
</syntaxhighlight>

===Required Arguments===
*'''x:''' The x position of the blip, in world coordinates.
*'''y:''' The y position of the blip, in world coordinates.
*'''z:''' The z position of the blip, in world coordinates.

===Optional Arguments===
{{OptionalArg}}
*'''icon:''' The icon that the radar blips should be. Valid values are:
{{Blip_Icons}}
*'''size:''' The size of the radar blip. Only applicable to the ''Marker'' icon. Default is 2.
*'''r:''' The amount of red in the blip's color (0 - 255). Only applicable to the ''Marker'' icon. Default is 255.
*'''g:''' The amount of green in the blip's color (0 - 255). Only applicable to the ''Marker'' icon. Default is 0.
*'''b:''' The amount of blue in the blip's color (0 - 255). Only applicable to the ''Marker'' icon. Default is 0.
*'''a:''' The amount of alpha in the blip's color (0 - 255). Only applicable to the ''Marker'' icon. Default is 255.
{{New feature/item|3|1.0||
*'''ordering:''' This defines the blip's Z-level ordering (-32768 - 32767). Default is 0.
*'''visibleDistance:''' The maximum distance from the camera at which the blip is still visible
}}
*'''visibleTo:''' What elements can see the blip. Defaults to visible to everyone. See [[visibility]].
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
blip createBlip ( float x, float y, float z, [int icon=0, int size=2, int r=255, int g=0, int b=0, int a=255,
int ordering=0, float visibleDistance ] )
</syntaxhighlight>

===Required Arguments===
*'''x:''' The x position of the blip, in world coordinates.
*'''y:''' The y position of the blip, in world coordinates.
*'''z:''' The z position of the blip, in world coordinates.

===Optional Arguments===
{{OptionalArg}}
*'''icon:''' The icon that the radar blips should be. Valid values are:
{{Blip_Icons}}
*'''size:''' The size of the radar blip. Only applicable to the ''Marker'' icon. Default is 2.
*'''r:''' The amount of red in the blip's color (0 - 255). Only applicable to the ''Marker'' icon. Default is 255.
*'''g:''' The amount of green in the blip's color (0 - 255). Only applicable to the ''Marker'' icon. Default is 0.
*'''b:''' The amount of blue in the blip's color (0 - 255). Only applicable to the ''Marker'' icon. Default is 0.
*'''a:''' The amount of alpha in the blip's color (0 - 255). Only applicable to the ''Marker'' icon. Default is 255.
{{New feature/item|3|1.0||
*'''ordering:''' This defines the blip's Z-level ordering (-32768 - 32767). Default is 0.
*'''visibleDistance:''' The maximum distance from the camera at which the blip is still visible
}}
</section>

==Returns==
Returns an [[element]] of the [[blip]] if it was created successfully, ''false'' otherwise.

==Example==
<section name="Server" class="server" show="true">
'''Example 1:''' This example creates a radar blip at a random player's position and makes it so that it is only visible to that player.
<syntaxhighlight lang="lua">
-- Pick a random player
myPlayer = getRandomPlayer ()
-- Retrieve the player's position and store it in the variables x, y and z
x,y,z = getElementPosition ( myPlayer )
-- Create a radar blip at the player's position, with a 'cash' icon and only visible to the player
myBlip = createBlip ( x, y, z, 51, 0, 0, 0, 255, myPlayer )
</syntaxhighlight>

'''Example 2:''' This example attaches a blip to a player. You can attach a blip to an element by just setting the blip's parent to that element.
<syntaxhighlight lang="lua">
-- Pick a random player
myPlayer = getRandomPlayer ()
-- Create a radar blip in the middle of the map
myBlip = createBlip ( 0, 0, 0 )
-- Make the player the parent of the blip, so that the blip follows the player around
setElementParent ( myBlip, myPlayer )
</syntaxhighlight>

'''Example 3:''' This example creates a blip at 0 , 0 , 0
<syntaxhighlight lang="lua">
--creates a blip at 0 , 0 , 0
createBlip ( 0 , 0 , 0 , 37 )
</syntaxhighlight>
</section>

==See Also==
{{Blip_functions}}

[[es:CreateBlip]]

ES/CreateBlip

2011-12-16T20:30:35Z

MarioKartero: Created page with "__NOTOC__ {{Server client function}} Esta funcion crea un elemento blip, el cual se mostrara en el radar del cliente. ==Sintaxis== <section name="Server" class="server" sho..."

__NOTOC__
{{Server client function}}
Esta funcion crea un elemento [[blip]], el cual se mostrara en el radar del cliente.

==Sintaxis==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
blip createBlip ( float x, float y, float z, [int icono=0, int tamaño=2, int rojo=255, int verde=0, int azul=0, int alfa=255,
int orden=0, float distanciaDeVisibilidad=99999.0, visiblePara = getRootElement()] )
</syntaxhighlight>

===Argumentos Requeridos===
*'''x:''' La posicion x del blip, en coordenadas del mundo.
*'''y:''' La posicion y del blip, en coordenadas del mundo.
*'''z:''' La posicion z del blip, en coordenadas del mundo.

===Argumentos Opcionales===
''NOTA'': Al usar argumentos opcionales, debes suministrar todos los argumentos anteriores al que quieres usar. Para mas informacion de los argumentos opcionales, vease [[Optional Arguments]].
*'''icono:''' El icono del blip para mostrar en el radar. Los valores validos son:
{{Blip_Icons}}
*'''tamaño:''' El tamaño que tendra el blip. Solo aplicable para el blip con el icono ''Marker''. El tamaño por defecto es 2.
*'''rojo:''' La cantidad de rojo en el color del blip (0 - 255). Solo aplicable para el blip con el icono ''Marker''. Valor por defecto es 255.
*'''verde:''' La cantidad de verde en el icono del blip (0 - 255). Solo aplicable para el blip con el icono ''Marker''. Valor por defecto es 0.
*'''azul:''' La cantidada de azul en el color del blip (0 - 255). Solo aplicable para el blip con el icono ''Marker''. Valor por defecto es 0.
*'''alfa:''' La cantidad de alfa en la transparencia del blip (0 - 255). Solo aplicable para el blip con el icono ''Marker''. Valor por defecto es 255.
{{New feature/item|3|1.0||
*'''orden:''' Esto define el nivel-Z en el orden (-32768 - 32767). Valor por defecto es 0.
*'''distanciaDeVisibilidad:''' La distancia maxima desde la camara en la cual el blip seguira siendo visible.
}}
*'''visiblePara:''' Los elementos que pueden ver el blip. Por defecto es visible para todos. Vease [[visibility]].
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
blip createBlip ( float x, float y, float z, [int icono=0, int tamaño=2, int rojo=255, int verde=0, int azul=0, int alfa=255,
int orden=0, float distanciaDeVisibilidad ] )
</syntaxhighlight>

===Argumentos Requeridos===
*'''x:''' La posicion x del blip, en coordenadas del mundo.
*'''y:''' La posicion y del blip, en coordenadas del mundo.
*'''z:''' La posicion z del blip, en coordenadas del mundo.

===Argumentos Opcionales===
''NOTA'': Al usar argumentos opcionales, debes suministrar todos los argumentos anteriores al que quieres usar. Para mas informacion de los argumentos opcionales, vease [[Optional Arguments]].
*'''icono:''' l icono del blip para mostrar en el radar. Los valores validos son:
{{Blip_Icons}}
*'''tamaño:''' El tamaño que tendra el blip. Solo aplicable para el blip con el icono ''Marker''. El tamaño por defecto es 2.
*'''rojo:''' La cantidad de rojo en el color del blip (0 - 255). Solo aplicable para el blip con el icono ''Marker''. Valor por defecto es 255.
*'''verde:''' La cantidad de verde en el icono del blip (0 - 255). Solo aplicable para el blip con el icono ''Marker''. Valor por defecto es 0.
*'''azul:''' La cantidada de azul en el color del blip (0 - 255). Solo aplicable para el blip con el icono ''Marker''. Valor por defecto es 0.
*'''alfa:''' La cantidad de alfa en la transparencia del blip (0 - 255). Solo aplicable para el blip con el icono ''Marker''. Valor por defecto es 255.
{{New feature/item|3|1.0||
*'''orden:''' Esto define el nivel-Z en el orden (-32768 - 32767). Valor por defecto es 0.
*'''distanciaDeVisibilidad:''' La distancia maxima desde la camara en la cual el blip seguira siendo visible.
}}
</section>

==Returns==
Retorna un elemento [[blip]] si fue creado satisfactoriamente, ''false'' de otra manera.

==Ejemplo==
<section name="Server" class="server" show="true">
'''Ejemplo 1:''' En este ejemplo se obtendra a un jugador cualquiera y se le pondra un blip el cual solo el podra ver.
<syntaxhighlight lang="lua">
-- Escoger un jugador al azar
miJugador = getRandomPlayer ()
-- Obtener las coordenadas del jugador y guardarlas en las variables x, y, z
x,y,z = getElementPosition ( miJugador )
-- Creamos un blip en la posicion del jugador con el icono de 'cash' y lo hacemos visible solo para ese jugador
miBlip = createBlip ( x, y, z, 51, 0, 0, 0, 255, miJugador )
</syntaxhighlight>

'''Ejemplo 2:''' En este ejemplo adjuntamos un blip con un jugador. tu puedes adjuntar un blip a cualquier elemento estableciendo el parentezco del blip con ese elemento.
<syntaxhighlight lang="lua">
-- Escoger un jugador al azar
miJugador = getRandomPlayer ()
-- Crear un blip en el medio del map
miBlip = createBlip ( 0, 0, 0 )
-- Establecemos el parentezco del blip con ese jugador, de esta manera el blip lo seguira en el radar.
setElementParent ( miBlip, miJugador )
</syntaxhighlight>

'''Ejemplo 3:''' Este ejemplo crea un blip en las coordenadas 0 , 0 , 0
<syntaxhighlight lang="lua">
createBlip ( 0 , 0 , 0 , 37 )
</syntaxhighlight>
</section>

==Vease Tambien==
{{Blip_functions}}

==Traductores==
- MarioKart

ES/Elemento/Player

2011-12-16T18:39:19Z

MarioKartero:

__NOTOC__
La clase de elemento player reprecenta un ped controlado por un jugador. Un objeto player es creado cuando un cliente se conecta al servidor y es destruido cuando el cliente sale. Los objetos player no pueden ser creados o destruidos de ninguna otra manera.

El tipo de elemento de esta clase es '''"player"'''.

==Funciones Relacionadas==
===Cliente===
{{Client player functions}}
===Servidor===
{{Player functions}}
[[Category:Element Types]]

==Traductores==
- MarioKart

[[it:Elemento Player]]
[[ru:Element/Player]]

Element/Player

2011-12-16T18:38:32Z

MarioKartero:

__NOTOC__
The player class represents pedestrians controlled by clients. A player object is created when a client connects to the server and destroyed when he quits. Players cannot be created or destroyed otherwise.

The element type of this class is '''"player"'''.

==Related scripting functions==
===Client===
{{Client player functions}}
===Server===
{{Player functions}}
[[Category:Element Types]]

[[it:Elemento Player]]
[[ru:Element/Player]]
[[es:Elemento/Player]]

Element/ES/Player

2011-12-16T18:37:17Z

MarioKartero: moved Element/ES/Player to ES/Elemento/Player: I create this page with the wrong name

#REDIRECT [[ES/Elemento/Player]]

ES/Elemento/Player

2011-12-16T18:37:17Z

MarioKartero: moved Element/ES/Player to ES/Elemento/Player: I create this page with the wrong name

ES/Elemento/Player

2011-12-16T18:30:04Z

MarioKartero: Created page with "__NOTOC__ La clase de elemento player reprecenta un ped controlado por un jugador. Un objeto player es creado cuando un cliente se conecta al servidor y es destruido cuando el cl..."

ES/setAccountData

2011-12-16T17:37:32Z

MarioKartero: /* Argumentos Requeridos */

{{Server function}}
__NOTOC__
{{Note_box|Es fuertemente recomendado que uses como estándar ''módulo.clave'' para nombrar a tus claves, como se muestra en el ejemplo más abajo. Esto previene contradicciones con otros scripts.}}
Esta función establece un string para ser guardado en una cuenta. Esta información puede ser obtenida luego, usando la función [[getAccountData]]. Los datos guardados en las cuentas (''account data'') son persistentes a través de sesiones de usuario y cambios de mapa, a menos que los usuarios estén logueados en una cuenta de invitado (''guest account''). Incluso si están logueados en la cuenta de invitado, los datos de cuenta pueden ser útiles como una vía para guardar referencia de tu propio sistema de cuentas, sin embargo sus usos son equivalentes al de [[setElementData]] en el jugador.

==Sintax==
<syntaxhighlight lang="lua">
bool setAccountData ( account laCuenta, string clave, string valor )
</syntaxhighlight>

===Argumentos Requeridos===
*'''laCuenta:''' La cuenta en la cual deseas guardar los datos.
*'''clave:''' La clave en la que deseas almacenar la información.
*'''valor:''' El valor que desees guardar. '''NOTA:''' no se puede guardar tablas en el valor, pero si se pueden usar strings [[toJSON]].

===Regresa===
Regresa ''true'' si los datos fueron establecidos en la cuenta, ''false'' si se especificaron argumentos inválidos.

==Ejemplo==
Para un tipo de juego roleplay pirata, la cantidad de dinero que un jugador posee se mantendrá almacenada guardándola en su cuenta. Se debe notar que el codigo usa ''piraterpg.money'' como la clave en lugar de sólo "money", dado que el jugador podría estar participando en otros tipos de juego que también guardan su cantidad de dinero en las cuentas. Si ambos tipos de juego usaran "money" como la clave, cada uno estaría sobre-escribiendo en los datos del otro.
<syntaxhighlight lang="lua">
function onPlayerQuit ( )
-- cuando un jugador sale, se guarda su cantidad de dinero actual en un dato de cuenta
local cuentaDelJugador = getPlayerAccount ( source )
if ( cuentaDelJugador ) and not isGuestAccount ( cuentaDelJugador ) then -- si el jugador estaba logueado
local dineroDelJugador = getPlayerMoney ( source ) -- obtener el dinero del jugador
setAccountData ( cuentaDelJugador, "piraterpg.money", dineroDelJugador ) -- guardar la cantidad en la cuenta del jugador
end
end

function onPlayerLogin (_, cuentaDelJugador )
-- cuando un jugador logea, se obtiene la cantidad su dinero desde los datos de cuenta y se le da al jugador el dinero
if ( cuentaDelJugador ) then
local dineroDelJugador = getAccountData ( cuentaDelJugador, "piraterpg.money" )
-- hay que estar seguros si de hecho habia un valor guardado bajo esta clave (verificar si dineroDelJugador no es false).
-- Esto seria por ejemplo si es la primera vez que el jugador juega este tipo de juego
if ( dineroDelJugador ) then
setPlayerMoney ( source, dineroDelJugador )
end
end
end

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

==Vease tambien==
{{Account_functions}}

==Traductores==
- MarioKartero

ES/setAccountData

2011-12-16T17:32:55Z

MarioKartero: /* Argumentos Requeridos */

{{Server function}}
__NOTOC__
{{Note_box|Es fuertemente recomendado que uses como estándar ''módulo.clave'' para nombrar a tus claves, como se muestra en el ejemplo más abajo. Esto previene contradicciones con otros scripts.}}
Esta función establece un string para ser guardado en una cuenta. Esta información puede ser obtenida luego, usando la función [[getAccountData]]. Los datos guardados en las cuentas (''account data'') son persistentes a través de sesiones de usuario y cambios de mapa, a menos que los usuarios estén logueados en una cuenta de invitado (''guest account''). Incluso si están logueados en la cuenta de invitado, los datos de cuenta pueden ser útiles como una vía para guardar referencia de tu propio sistema de cuentas, sin embargo sus usos son equivalentes al de [[setElementData]] en el jugador.

==Sintax==
<syntaxhighlight lang="lua">
bool setAccountData ( account laCuenta, string clave, string valor )
</syntaxhighlight>

===Argumentos Requeridos===
*'''laCuenta:''' La cuenta en la cual deseas guardar los datos.
*'''clave:''' La clave en la que deseas almacenar la información.
*'''valor:''' El valor que desees guardar.

===Regresa===
Regresa ''true'' si los datos fueron establecidos en la cuenta, ''false'' si se especificaron argumentos inválidos.

==Ejemplo==
Para un tipo de juego roleplay pirata, la cantidad de dinero que un jugador posee se mantendrá almacenada guardándola en su cuenta. Se debe notar que el codigo usa ''piraterpg.money'' como la clave en lugar de sólo "money", dado que el jugador podría estar participando en otros tipos de juego que también guardan su cantidad de dinero en las cuentas. Si ambos tipos de juego usaran "money" como la clave, cada uno estaría sobre-escribiendo en los datos del otro.
<syntaxhighlight lang="lua">
function onPlayerQuit ( )
-- cuando un jugador sale, se guarda su cantidad de dinero actual en un dato de cuenta
local cuentaDelJugador = getPlayerAccount ( source )
if ( cuentaDelJugador ) and not isGuestAccount ( cuentaDelJugador ) then -- si el jugador estaba logueado
local dineroDelJugador = getPlayerMoney ( source ) -- obtener el dinero del jugador
setAccountData ( cuentaDelJugador, "piraterpg.money", dineroDelJugador ) -- guardar la cantidad en la cuenta del jugador
end
end

function onPlayerLogin (_, cuentaDelJugador )
-- cuando un jugador logea, se obtiene la cantidad su dinero desde los datos de cuenta y se le da al jugador el dinero
if ( cuentaDelJugador ) then
local dineroDelJugador = getAccountData ( cuentaDelJugador, "piraterpg.money" )
-- hay que estar seguros si de hecho habia un valor guardado bajo esta clave (verificar si dineroDelJugador no es false).
-- Esto seria por ejemplo si es la primera vez que el jugador juega este tipo de juego
if ( dineroDelJugador ) then
setPlayerMoney ( source, dineroDelJugador )
end
end
end

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

==Vease tambien==
{{Account_functions}}

==Traductores==
- MarioKartero

ES/setAccountData

2011-12-16T17:31:47Z

MarioKartero:

{{Server function}}
__NOTOC__
{{Note_box|Es fuertemente recomendado que uses como estándar ''módulo.clave'' para nombrar a tus claves, como se muestra en el ejemplo más abajo. Esto previene contradicciones con otros scripts.}}
Esta función establece un string para ser guardado en una cuenta. Esta información puede ser obtenida luego, usando la función [[getAccountData]]. Los datos guardados en las cuentas (''account data'') son persistentes a través de sesiones de usuario y cambios de mapa, a menos que los usuarios estén logueados en una cuenta de invitado (''guest account''). Incluso si están logueados en la cuenta de invitado, los datos de cuenta pueden ser útiles como una vía para guardar referencia de tu propio sistema de cuentas, sin embargo sus usos son equivalentes al de [[setElementData]] en el jugador.

==Sintax==
<syntaxhighlight lang="lua">
bool setAccountData ( account laCuenta, string clave, string valor )
</syntaxhighlight>

===Argumentos Requeridos===
*'''laCuenta:''' La cuenta desde la cual deseas recobrar los datos.
*'''clave:''' La clave en la que deseas almacenar la información.
*'''valor:''' El valor que desees guardar.

===Regresa===
Regresa ''true'' si los datos fueron establecidos en la cuenta, ''false'' si se especificaron argumentos inválidos.

==Ejemplo==
Para un tipo de juego roleplay pirata, la cantidad de dinero que un jugador posee se mantendrá almacenada guardándola en su cuenta. Se debe notar que el codigo usa ''piraterpg.money'' como la clave en lugar de sólo "money", dado que el jugador podría estar participando en otros tipos de juego que también guardan su cantidad de dinero en las cuentas. Si ambos tipos de juego usaran "money" como la clave, cada uno estaría sobre-escribiendo en los datos del otro.
<syntaxhighlight lang="lua">
function onPlayerQuit ( )
-- cuando un jugador sale, se guarda su cantidad de dinero actual en un dato de cuenta
local cuentaDelJugador = getPlayerAccount ( source )
if ( cuentaDelJugador ) and not isGuestAccount ( cuentaDelJugador ) then -- si el jugador estaba logueado
local dineroDelJugador = getPlayerMoney ( source ) -- obtener el dinero del jugador
setAccountData ( cuentaDelJugador, "piraterpg.money", dineroDelJugador ) -- guardar la cantidad en la cuenta del jugador
end
end

function onPlayerLogin (_, cuentaDelJugador )
-- cuando un jugador logea, se obtiene la cantidad su dinero desde los datos de cuenta y se le da al jugador el dinero
if ( cuentaDelJugador ) then
local dineroDelJugador = getAccountData ( cuentaDelJugador, "piraterpg.money" )
-- hay que estar seguros si de hecho habia un valor guardado bajo esta clave (verificar si dineroDelJugador no es false).
-- Esto seria por ejemplo si es la primera vez que el jugador juega este tipo de juego
if ( dineroDelJugador ) then
setPlayerMoney ( source, dineroDelJugador )
end
end
end

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

==Vease tambien==
{{Account_functions}}

==Traductores==
- MarioKartero

SetAccountPassword

2011-09-30T20:59:12Z

MarioKartero:

__NOTOC__
{{Server function}}
This function sets the password of the specified account.

==Syntax==
<syntaxhighlight lang="lua">
bool setAccountPassword ( account theAccount, string password )
</syntaxhighlight>

===Required Arguments===
*'''theAccount:''' the account whos password you want to set
*'''password:''' the password

===Returns===
Returns ''true'' if the password was set correctly, ''false'' otherwise.

==Example==

This example allows a user to change their password with a command.

<syntaxhighlight lang="lua">
function ChangePlayerPassword(player,command,oldpass,newpass)
-- get the account the player is currently logged into
local account = getPlayerAccount(player)
if (account) then
-- if its only a guest account, do not allow the password to be changed
if (isGuestAccount(account)) then
outputChatBox("You must be logged into an account to change your password.",player)
-- end the function
return
end

-- check that the old password is correct
local password_check = getAccount(getPlayerUserName(player),oldpass)
if (oldpass==password_check) then
-- check the length of the new password
if (string.len(newpass)>=5) then
setAccountPassword(account,newpass)
else
outputChatBox("Your new password must be at least 5 characters long.",player)
end
else
outputChatBox("Old password invalid.",player)
end
end

addCommandHandler("changepass",ChangePlayerPassword)
</syntaxhighlight>

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

[[es:setAccountPassword]]

ES/setAccountPassword

2011-09-30T20:58:24Z

MarioKartero: Created page with "__NOTOC__ {{Server function}} Esta funcion establece una contraseña a la cuenta especificada ==Sintax== <syntaxhighlight lang="lua"> bool setAccountPassword ( account laCuenta, string contra..."

__NOTOC__
{{Server function}}
Esta funcion establece una contraseña a la cuenta especificada

==Sintax==
<syntaxhighlight lang="lua">
bool setAccountPassword ( account laCuenta, string contraseña )
</syntaxhighlight>

===Argumentos Requeridos===
*'''laCuenta:''' La cuenta a la cual quieres establecer una contraseña
*'''contraseña:''' la contraseña que va a ser establecida

===Returns===
Devuelve ''true'' si la contraseña es establecida correctamente, ''false'' de otra manera.

==Ejemplo==

Este ejemplo le permite al usuario cambiar su contraseña con un comando.

<syntaxhighlight lang="lua">
function CambiarLaContraseña(elJugador, comando, contraseñaAnterior, contraseñaNueva)
-- Obtener la cuenta en la cual el jugador esta logueado
local cuenta = getPlayerAccount(elJugador)
if (cuenta) then
-- si esta en una cuenta de invitado, no se permitira que la contraseña sea cambiada
if (isGuestAccount(cuenta)) then
outputChatBox("Debes estar logueado para poder cambiar de contraseña.", elJugador)

else -- Si esta logueado en una cuenta
-- verificar que la contraseñaAnterior sea la correcta
local verificar = getAccount(getAccountName(cuenta), contraseñaAnterior)
if (verificar) then
-- Revisar que la contraseñaNueva tenga mas de 5 caracteres
if (string.len(contraseñaNueva) >= 5) then
setAccountPassword(cuenta, contraseñaNueva)
else
outputChatBox("Tu contraseña nueva debe tener por lo menos 5 caracteres.", elJugador)
end
else
outputChatBox("Tu contraseña anterior es invalida.", elJugador)
end
end
end
end
addCommandHandler("cambiarcontraseña", CambiarLaContraseña)
</syntaxhighlight>

==Vease tambien==
{{Account functions}}

ES/setAccountData

2011-09-30T20:16:52Z

MarioKartero: Created page with "{{Server function}} __NOTOC__ {{Note_box|Es fuertemente recomendado que uses como estandar ''modulo.clave'' para nombrar a tus claves, como se muestra en el ejemplo mas abajo. Es..."

{{Server function}}
__NOTOC__
{{Note_box|Es fuertemente recomendado que uses como estandar ''modulo.clave'' para nombrar a tus claves, como se muestra en el ejemplo mas abajo. Esto previene contradicciones con otros scripts.}}
Esta funcion establece un string para ser guardado en una cuenta. Esta informacion puede ser obtenida luego usando la funcion [[getAccountData]]. Los datos guardados en las cuentas (account data) son persistentes através de sesiones de usuario y cambios de mapa, amenos que los usuarios esten logueados en una cuenta de invitado (guest account). Incluso si estan logueados en la cuenta de invitado, los datos de cuenta pueden ser utiles como una via para guardar referencia de tu propio sistema de cuentas, sin embargo sus usos son equivalentes al uso de [[setElementData]] en el jugador.

==Sintax==
<syntaxhighlight lang="lua">
bool setAccountData ( account laCuenta, string clave, string valor )
</syntaxhighlight>

===Argumentos Requeridos===
*'''laCuenta:''' La cuenta desde la cual deseas recobrar los datos.
*'''clave:''' La clave en la que deseas almacenar la informacion.
*'''valor:''' El valor que desees guardar.

===Returns===
Devuelve ''true'' si los datos fueron establecidos en la cuenta, ''false'' si se especificaron argumentos invalidos.

==Ejemplo==
Para un tipo de juego roleplay pirata, la cantidad de dinero que un jugador posee se mantendra almacenada guardandola en su cuenta. Se debe notar que el codigo usa "piraterpg.money" como la clave en lugar de solo "money", dado que el jugador podria estar participando en otros tipos de juego que tambien guardan su cantidad de dinero en las cuentas. Si ambos tipos de juego usan "money" como la clave, estarian sobre escribiendo en los datos de el otro tipo de juego.
<syntaxhighlight lang="lua">
function onPlayerQuit ( )
-- cuando un jugador sale, se guarda su cantidad de dinero actual en un dato de cuenta
local cuentaDelJugador = getPlayerAccount ( source )
if ( cuentaDelJugador ) and not isGuestAccount ( cuentaDelJugador ) then -- si el jugador estaba logueado
local dineroDelJugador = getPlayerMoney ( source ) -- obtener el dinero del jugador
setAccountData ( cuentaDelJugador, "piraterpg.money", dineroDelJugador ) -- guardar la cantidad en la cuenta del jugador
end
end

function onPlayerLogin (_, cuentaDelJugador )
-- cuando un jugador logea, se obtiene la cantidad su dinero desde los datos de cuenta y se le da al jugador el dinero
if ( cuentaDelJugador ) then
local dineroDelJugador = getAccountData ( cuentaDelJugador, "piraterpg.money" )
-- hay que estar seguros si de hecho habia un valor guardado bajo esta clave (verificar si dineroDelJugador no es false).
-- Esto seria por ejemplo si es la primera vez que el jugador juega este tipo de juego
if ( dineroDelJugador ) then
setPlayerMoney ( source, dineroDelJugador )
end
end
end

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

==Vease tambien==
{{Account_functions}}

SetAccountData

2011-09-30T20:13:59Z

MarioKartero:

{{Server function}}
__NOTOC__
{{Note_box|It is strongly recommended that you use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}
This function sets a string to be stored in an account. This can then be retrieved using [[getAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account. Even if logged into a guest account, account data can be useful as a way to store a reference to your own account system, though it's persistence is equivalent to that of using [[setElementData]] on the player's element.

==Syntax==
<syntaxhighlight lang="lua">
bool setAccountData ( account theAccount, string key, string value )
</syntaxhighlight>

===Required Arguments===
*'''theAccount:''' The account you wish to retrieve the data from.
*'''key:''' The key under which you wish to store the data
*'''value:''' The value you wish to store

===Returns===
Returns a ''true'' if the account data was set, ''false'' if an invalid argument was specified.

==Example==
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 ) and not isGuestAccount ( playeraccount ) then -- if the player is logged in
local playermoney = getPlayerMoney ( source ) -- get the player money
setAccountData ( playeraccount, "piraterpg.money", playermoney ) -- save it in his account
end
end

function onPlayerLogin (_, playeraccount )
-- when a player logins, retrieve his money amount from his account data and set it
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 ( "onPlayerLogin", getRootElement ( ), onPlayerLogin)
</syntaxhighlight>

==See Also==
{{Account_functions}}

[[es:setAccountData]]

SetAccountData

2011-09-30T20:12:42Z

MarioKartero: