Contenido generado con IA — puede contener errores.

ExyliaAnalytics/GuíasActualizada en v1.3.0

Sigue la economía de tu servidor

Dónde encuentra el agente dinero en movimiento — ExyliaLib, Vault, VaultUnlocked, PlayerPoints, ExcellentEconomy y la API —, cómo cuenta cada cambio una sola vez, y qué hace con ello la página Economía.

Página 12 de 2811 min de lectura

En unos minutos puedes ver si el dinero se acumula más rápido de lo que la gente juega: cuánto se creó y se retiró, por qué motivo, quién lo tiene y si la economía sufre inflación. El agente necesita dos cosas de cada moneda: qué se movió (dinero creado y retirado, y por qué) y qué existe (la masa monetaria). Esta guía explica cómo hacer que lleguen las dos y cómo leer la página.

La economía es solo de Paper y Spigot; un proxy no mueve dinero. Todo lo de aquí se descarta en el agente cuando el módulo Economía está desactivado.

Antes de empezar#

  • Un servidor Paper o Spigot vinculado a tu espacio de trabajo, mira Conecta tu servidor.
  • El módulo Economía activado. Lo está por defecto; compruébalo en Ajustes, Qué recoge el plugin (Configuración remota).
  • Al menos una economía que el agente pueda leer: una moneda de ExyliaLib, una economía de Vault o VaultUnlocked, PlayerPoints o ExcellentEconomy. Cualquiera se mide por sí sola; para la masa monetaria exacta usa un plugin de economía que la informe, como ExyliaSurvivalCore.
  • El permiso Economía (view_economy) en tu rol para leer la página.

Pasos#

Mira qué ha encontrado el agente

En el servidor de juego, ejecuta /analytics status. Las líneas Vault y VaultUnlocked dicen si el agente se pone delante de esa economía, y las fuentes de economía enganchadas aparecen con ellas. Si falta tu plugin de economía, mira El proxy de Vault.

Deja que unos jugadores ganen y gasten

Los cambios se envían una vez por minuto. Juega unos minutos: vende algo, compra algo, paga a otro jugador.

Abre la página de economía

En la barra lateral del panel abre Ingresos y la pestaña Economía del juego. Elige la Moneda arriba (la lista muestra cuántos jugadores tiene cada una) y, si tienes varios servidores de juego, el filtro de servidor.

Lee el veredicto

Bajo ¿El dinero pierde valor? verás Inflación, Estable o Deflación. Luego abre Todos los motivos para ver qué fuente o sumidero lo mueve.

Comprueba que funciona#

Una moneda aparece en la lista Moneda con su número de jugadores, y Dinero creado y Dinero retirado muestran las operaciones que acabas de hacer. Si la página dice No hay datos de economía en este periodo, el módulo está desactivado, el servidor no es Paper o no se encontró ninguna economía: ejecuta /analytics status y mira Problemas comunes.

El veredicto ¿El dinero pierde valor? necesita al menos 3 semanas de instantáneas de saldos; antes dice que aún no hay datos suficientes. Es lo normal en una instalación nueva.

Para ir más lejos#

Las fuentes#

Cada cambio de saldo se cuenta una vez, desde la primera fuente que lo ve:

FuenteMonedasMotivo registrado
El evento de cambio de saldo de ExyliaLibCada moneda de ExyliaLib, por su id.El propio motivo de la transacción, como shop:sell o pay:tax.
Un proxy transparente delante de VaultvaultEl motivo que dio quien llamó desde ExyliaLib (ExyliaLib 1.460.0 o posterior); si no, vault: y el plugin que llamó a Vault, como vault:shopguiplus.
Lo mismo delante de VaultUnlockedvault para la moneda por defecto, si no la moneda indicadaIgual: el motivo de quien llama; si no, vault: y el plugin que lo llamó.
El evento de cambio de PlayerPointsplayerpointsplayerpoints
El evento de cambio de ExcellentEconomyCada moneda por su id; la principal es vault mientras ExcellentEconomy sea la economía de Vault.excellenteconomy
El evento de compra y el comando /credits de Rival Creditsrivalcreditsrivalcredits:shop, :console (una tienda como Tebex), :staff, :pay
ExyliaAnalytics.economy(...)La que indique el plugin.El que diga el plugin.

Los ids de moneda se pasan a minúsculas y se cortan a 32 caracteres, los motivos a 64. Un cambio de cero se ignora.

El proxy de Vault#

Vault no lanza ningún evento cuando se mueve dinero, así que el agente se pone delante: registra su propia economía con la prioridad más alta, reenvía cada llamada intacta a la real y, cuando un ingreso o una retirada ha salido bien, la registra con el plugin que hizo la llamada (el primer plugin de la pila de llamadas que no es Vault, VaultUnlocked, ExyliaLib ni el agente). Nada de lo que hace puede cambiar el resultado de un pago ni hacer que falle.

El proxy no se instala cuando:

  • vault-wrapper: false en el config.yml del agente;
  • la economía de Vault ya informa de cada cambio a través de ExyliaLib: ExyliaSurvivalCore, o cualquier economía que ExyliaLib conozca como una moneda que anuncia sus propios cambios, como ExyliaEconomy (ExyliaLib 1.372.0 o posterior; con una anterior se envuelve como cualquier otra);
  • el puente propio de VaultUnlocked hacia una economía de Vault que ya informa a través de ExyliaLib (el puente se deja sin envolver, para no contar dos veces cada pago);
  • el plugin de economía se registró antes con la prioridad más alta, así que el proxy quedaría sin uso.

/analytics status dice cuál de estos casos se aplica en las líneas Vault y VaultUnlocked.

Plugins que guardan la economía que encontraron al arrancar

El proxy entra en el primer tick del servidor, cuando todos los plugins ya se han activado. Un plugin que buscó la economía de Vault al activarse y la guardó llama directamente a la real, y sus pagos no se ven. El agente lo vuelve a comprobar cada vez que una economía se registra o se da de baja.

Lee la página#

SecciónMuestra
Dinero en circulación, Dinero por jugador activo, Dinero creado, Dinero retiradoLas cifras principales, con la proporción de retirada ("retirado por cada 1 creado").
¿El dinero pierde valor?Dinero por jugador activo en las últimas 8 semanas completas con una línea ajustada: Inflación por encima de +5 % semanal, Deflación por debajo de −5 %, y Estable en medio. Necesita al menos 3 semanas de datos.
Dinero en circulaciónEl saldo de todos los titulares sumado, por periodo.
Dinero por jugador activoDinero en circulación ÷ jugadores activos en los últimos 30 días. Si sube más rápido que el juego, hay inflación.
Dinero y jugadoresEl cambio de cada uno desde el inicio del periodo. Si el dinero crece muy por encima de los jugadores, hay inflación.
Dinero creado y retiradoPor periodo, lo que creó cada motivo (sobre la línea) y lo que retiró (debajo).
Todos los motivosCada motivo por el que se movió dinero, de mayor a menor impacto: Entrada, Salida, Neto, Parte del total, Jugadores y el tipo (Crea dinero, Retira dinero, Transferencia). Los motivos de Vault muestran el plugin que llamó, marcado vía Vault.
Quién tiene el dineroSaldo típico, Desigualdad (Gini), la parte en manos del 1 % y del 10 % más ricos y Dinero sin usar (en manos de jugadores ausentes 30 días o más).
Progreso de los nuevosSaldo típico de los jugadores nuevos 1, 7 y 30 días después de su primera sesión.
Mayores saldosEl último saldo conocido de cada jugador junto a su saldo máximo y lo ganado y gastado mediante plugins desde que empezó el registro, hasta 100 jugadores.
Causas de la inflaciónPaneles de toda la temporada (no del periodo): quién y qué alimenta la masa monetaria, con alertas de inflación como un solo jugador detrás de una fuente de dinero.

La pestaña Mercado de al lado cubre casas de subastas, tiendas y comandos de venta.

Qué existe: masa monetaria y saldos

Los cambios por sí solos no dicen cuánto dinero hay. Tres fuentes sí:

FuenteQué informaCuándo
ExyliaAnalytics.supply(...)La masa monetaria exacta: cada saldo sumado y cuántas cuentas tienen dinero, por ámbito de almacenamiento.Cuando el plugin la envía.
Lecturas de saldoEl saldo de un jugador: a través de Vault (salvo que la economía de Vault informe por ExyliaLib), PlayerPoints y cada moneda de ExcellentEconomy distinta de la que se lee por Vault. Se leen fuera del hilo principal.Al entrar y salir, como mucho una vez por jugador cada 5 minutos.
Tenencias de ExyliaLibLo que un jugador tiene en cada moneda de ExyliaLib que ninguna fuente anterior ya informa.Al entrar, al salir y cada 10 minutos para todos los conectados.

Las tenencias importan en monedas que cambian sin transacción: una barra de experiencia crece por un mob, un objeto moneda se recoge del suelo. Ahí contar lo que la gente lleva es la única masa monetaria que hay. ExyliaLib hace cada recuento en el hilo que posee al jugador, y un recuento que llega después de que el jugador se fue (y sale a cero porque el inventario ya no está) se descarta en vez de registrarse como un bolsillo vacío. Necesita una ExyliaLib lo bastante reciente para contar fuera del hilo del jugador; con una anterior, el estado dice ExyliaLib (flows only).

Contar cada cambio una vez

Un servidor puede tener varias de estas a la vez, y se llaman entre sí: la moneda vault de ExyliaLib pasa por Vault, VaultUnlocked responde por su propia interfaz y una economía lanza su evento mientras Vault mueve el dinero. Las reglas:

  • Un cambio que ocurre dentro de una llamada de Vault con proxy es el mismo cambio: cada evento lanzado durante ella se ignora, y se registra la llamada exterior a Vault.
  • La moneda vault de ExyliaLib se descarta cuando Vault ya está cubierto, por el proxy, por una economía que informa a través de ExyliaLib o por el evento propio de ExcellentEconomy.
  • La moneda points de ExyliaLib se descarta cuando PlayerPoints está enganchado.
  • Rival Credits no lanza ningún evento cuando cambia un saldo, así que los cambios hechos con /credits se leen como el saldo un tick después del comando menos el de antes: los comandos rechazados no informan nada, y set o reset sobre un jugador desconectado no se ven. Los créditos que otro plugin añade por la API de Rival solo aparecen como un saldo que se movió sin flujo. Cada compra en la tienda es además una operación en credit_shop. Nuevo en v1.3.0
Cómo se envía

Los cambios se suman por jugador, moneda y motivo y se envían una vez por minuto como un economy.flow cada uno: cuántos cambios, el total ganado, el total gastado y el saldo tras el último. Una varita de venta que se dispara mil veces por minuto cuesta un evento. Se guardan como mucho 50.000 de esas claves a la vez; pasado eso, las nuevas esperan al minuto siguiente. Al apagar, el último minuto parcial se envía con el resto.

Definiciones
MétricaDefinición
Dinero en circulaciónPor periodo, el último informe supply de cada ámbito de almacenamiento, sumado entre ámbitos. Un periodo sin informe queda vacío, nunca se arrastra.
Masa monetaria estimadaPara una moneda de la que nadie informa la masa: la suma del último saldo de cada jugador conocido (por debajo de cero cuenta como cero), arrastrada entre cambios. Faltan los jugadores no vistos desde que empezó el registro, así que queda por debajo de la masa real; la página la marca como estimada con el número de jugadores detrás.
Neto de un motivoDinero que entra − dinero que sale por un motivo, entre todos los jugadores. Un pago entre jugadores se cancela dentro de su motivo.
Creado / retiradoLos netos de motivo positivos / negativos.
Proporción de retiradaRetirado ÷ creado. Por debajo de 1 el dinero se acumula; por encima, se drena.
Crea dinero, retira dinero, transferenciaEs una transferencia cuando el neto está dentro del 5 % de la mayor de sus entradas y salidas brutas; si no, crea dinero (positivo) o lo retira (negativo).
Último saldo conocidoEl saldo más reciente de un jugador, de un cambio o de una lectura de saldo.
Gini0 cuando todos tienen lo mismo, 1 cuando un jugador lo tiene todo.
Economías compartidas o separadas

Todos los servidores informan los mismos ids de moneda (vault, playerpoints), compartan una economía o cada uno tenga la suya. Entre todos los servidores, el saldo de un jugador es el último informado en cualquier sitio: correcto para una economía compartida, y uno de dos saldos para economías separadas. Lee las economías separadas de una en una.

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