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.
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:
| Fuente | Monedas | Motivo registrado |
|---|---|---|
| El evento de cambio de saldo de ExyliaLib | Cada moneda de ExyliaLib, por su id. | El propio motivo de la transacción, como shop:sell o pay:tax. |
| Un proxy transparente delante de Vault | vault | El 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 VaultUnlocked | vault para la moneda por defecto, si no la moneda indicada | Igual: el motivo de quien llama; si no, vault: y el plugin que lo llamó. |
| El evento de cambio de PlayerPoints | playerpoints | playerpoints |
| El evento de cambio de ExcellentEconomy | Cada 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 Credits | rivalcredits | rivalcredits: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: falseen elconfig.ymldel 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.
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ón | Muestra |
|---|---|
| Dinero en circulación, Dinero por jugador activo, Dinero creado, Dinero retirado | Las 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ón | El saldo de todos los titulares sumado, por periodo. |
| Dinero por jugador activo | Dinero 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 jugadores | El 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 retirado | Por periodo, lo que creó cada motivo (sobre la línea) y lo que retiró (debajo). |
| Todos los motivos | Cada 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 dinero | Saldo 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 nuevos | Saldo típico de los jugadores nuevos 1, 7 y 30 días después de su primera sesión. |
| Mayores saldos | El ú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ón | Paneles 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í:
| Fuente | Qué informa | Cuá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 saldo | El 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 ExyliaLib | Lo 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
vaultde 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
pointsde ExyliaLib se descarta cuando PlayerPoints está enganchado. - Rival Credits no lanza ningún evento cuando cambia un saldo, así que los cambios hechos con
/creditsse leen como el saldo un tick después del comando menos el de antes: los comandos rechazados no informan nada, ysetoresetsobre 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 encredit_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étrica | Definición |
|---|---|
| Dinero en circulación | Por 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 estimada | Para 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 motivo | Dinero que entra − dinero que sale por un motivo, entre todos los jugadores. Un pago entre jugadores se cancela dentro de su motivo. |
| Creado / retirado | Los netos de motivo positivos / negativos. |
| Proporción de retirada | Retirado ÷ creado. Por debajo de 1 el dinero se acumula; por encima, se drena. |
| Crea dinero, retira dinero, transferencia | Es 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 conocido | El saldo más reciente de un jugador, de un cambio o de una lectura de saldo. |
| Gini | 0 cuando todos tienen lo mismo, 1 cuando un jugador lo tiene todo. |
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