ES/setAccountData

From Multi Theft Auto: Wiki

[[{{{image}}}|link=]] 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


Traductores

- MarioKartero