ES/setAccountData
Note: 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
bool setAccountData ( account laCuenta, string clave, string valor )
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.
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)
Vease tambien
- addAccount
- copyAccountData
- getAccount
- getAccountData
- getAccountName
- getAccountPlayer
- getAccountSerial
- getAccounts
- getAccountsBySerial
- getAllAccountData
- getPlayerAccount
- isGuestAccount
- logIn
- logOut
- removeAccount
- setAccountData
- setAccountPassword
Traductores
- MarioKartero