Contenido generado con IA — puede contener errores.

ExyliaEconomy/Cómo funcionaActualizada en v1.4.0

Red

Compartir saldos entre servidores: quién escribe un saldo, qué pasa con un cambio para un jugador que está en otra parte, monedas globales, de grupo y por servidor, IDs de servidor y Redis.

Página 11 de 255 min de lectura

Todos los servidores que apuntan a la misma base de datos comparten las mismas monedas, los mismos ajustes de la economía y los mismos saldos. No hay nada que configurar aparte de la propia base de datos; Redis lo hace instantáneo.

Quién escribe un saldo#

Propiedad, no sincronización. El saldo de un jugador lo reclama el servidor al que entra, se carga en memoria y lo escribe solo ese servidor mientras está allí. Cuando sale, se escribe su último saldo y se libera el reclamo.

Un servidor al que entra el jugador espera hasta cinco segundos a que el anterior termine su última escritura y lo libere, y después se queda con el saldo. Una escritura de un servidor que perdió el saldo entretanto nunca se escribe encima de la del nuevo dueño: se pone en cola para él. Dos servidores nunca pueden guardar dos totales distintos.

Hasta que se reclama el saldo de un jugador — el primer instante tras entrar —, un ingreso para él queda en cola y se aplica justo después, y todo lo que gastaría su dinero se rechaza con "Your balance is still loading."

Un cambio para alguien que está en otra parte#

Un ingreso, una retirada o una fijación de saldo para un jugador desconectado, o conectado en otro servidor, no se escribe en su saldo. Queda en cola en la base de datos para quien lo tenga:

CambioCuándo se aplica
IngresoSiempre, entero, hasta el máximo. Lo que el máximo recorte de un pago vuelve al que pagó.
RetiradaSin bajar de cero: no puede dejar en negativo a alguien que no ve.
Fijar, reiniciarSustituye el saldo.

Los cambios en cola se aplican del más antiguo al más reciente, cada uno exactamente una vez, aunque se enteren muchos servidores:

  • a un jugador conectado en otra parte se lo aplica ese servidor al momento con Redis activado, y como mucho en un minuto sin él;
  • a un jugador desconectado se le aplica cuando vuelve a entrar, en el servidor que sea.

Los cambios hechos mientras un servidor no podía llegar a la base de datos se reintentan cada segundo, y un cambio que no se puede escribir de ninguna manera queda anotado en consola con todo lo necesario para aplicarlo a mano.

Alcance de una moneda en la red#

Alcance en la red, en la página de Integraciones de una moneda almacenada, decide qué servidores comparten el saldo de un jugador:

AlcanceUn saldo paraGuardado comoClasificación, billetes, intereses
Global (por defecto)Todos los servidores de la base de datos<id>Una para la red; los billetes se canjean en cualquier parte; se paga una vez por jugador
GrupoLos servidores de un grupo de red<id>#<grupo>Una por grupo; los billetes se canjean dentro del grupo; se paga por grupo
ServidorCada servidor por separado<id>@<server-id>Una por servidor; los billetes se canjean donde se imprimieron; paga cada servidor

El grupo es el network-group del servidor en el config.yml de ExyliaLib, dicho una vez para todos los plugins: dos survivals del grupo survival comparten un saldo mientras un servidor boxpvp tiene otro. Una moneda de grupo en un servidor sin grupo se guarda por servidor, y la consola avisa una vez. Los cambios en cola para un saldo de grupo o por servidor solo los reclama un servidor que pertenezca a él.

Disponible en lista los grupos o IDs de servidor donde existe la moneda; vacío es todos. En un servidor excluido la moneda no se registra: ni comando, ni Vault, ni saldo.

El alcance se rechaza en cuanto la moneda tiene algún saldo distinto del inicial, porque los saldos que tiene quedarían atrás bajo la otra clave. Decídelo antes de que los jugadores ganen nada.

IDs de servidor#

La propiedad se anota con server-id, que se define bajo redis en el database.yml de cada servidor aunque Redis esté desactivado:

plugins/ExyliaEconomy/database.yml
yaml
database:
  redis:
    enabled: true
    host: 10.0.0.6
    server-id: survival-1

Vale server-1 en cada servidor que nunca lo cambió. Dos servidores que comparten saldos con el mismo ID creen ambos que tienen al jugador y se sobrescriben. Cuando el plugin ve el ID por defecto junto con Redis o una base de datos en red, avisa una vez al arrancar: "this server's id is the default 'server-1' while balances are shared…". Dale a cada servidor el suyo.

El ID es también la clave de una moneda por servidor: cambiar el ID de un servidor lo lleva a un conjunto nuevo y vacío de saldos por servidor.

Con Redis y sin él#

Con RedisSin Redis
Un cambio para un jugador en otro servidorSe aplica al momentoSe aplica como mucho en un minuto
Una moneda editada en /economyadminTodos los servidores la vuelven a leer al momentoLos demás servidores mantienen los ajustes anteriores hasta un /economyadmin reload o un reinicio
Saldos, cambios en cola, marcasCompartidos a través de la base de datosCompartidos a través de la base de datos

Redis es opcional y se configura una vez en database.yml. Ver la página de base de datos de la librería.

Apagar un servidor#

Cuando un servidor se apaga, se escribe y se libera el último saldo de cada jugador, y el plugin espera hasta diez segundos a las escrituras que aún estén en camino. Las que sigan pendientes después se anotan con su cantidad. Los ingresos se agrupan durante medio segundo antes de escribirse; las retiradas se escriben al momento.

¿Falta algo en esta página? Dínoslo en Discord