Configura la economía de tus plugins Exylia
Elige con qué dinero cobran y pagan tus plugins Exylia: Vault, PlayerPoints o una moneda de ExyliaEconomy, con un solo archivo, economy.yml.
Un solo archivo decide qué dinero usan todos los plugins Exylia: tiendas, kits, recompensas y cualquier cosa con precio. Lo cambias una vez y todos lo siguen.
ExyliaLib es la librería que instala cada plugin Exylia. Este archivo está en su carpeta, plugins/ExyliaLib/economy.yml, y se aplica a todos los plugins Exylia. Los plugins Exylia nunca hablan con un plugin de economía directamente; piden "dinero" y este archivo decide quién responde.
Antes de empezar#
Necesitas al menos una economía en el servidor:
- Vault con un plugin de economía detrás (por ejemplo EssentialsX o ExyliaEconomy). Es la opción por defecto.
- PlayerPoints, si quieres una moneda de puntos.
- ExyliaEconomy, que te da tantas monedas como quieras y además puede hacer de economía de Vault. Mira ExyliaEconomy.
Elige la moneda por defecto#
Abre el archivo
Abre plugins/ExyliaLib/economy.yml. Se crea en el primer arranque con un comentario sobre cada clave.
Pon la moneda por defecto
default-currency: vault
fallback: []
balance-cache-millis: 500Usa vault para la economía de Vault del servidor, points para PlayerPoints, o el id de una moneda que creaste en ExyliaEconomy.
Recarga
Ejecuta /exylialib reload (permiso exylialib.admin). No hace falta reiniciar.
Cómo se cobran los precios#
Un precio en un plugin Exylia (el coste de un kit, un objeto de tienda, una entrada) se cobra en la moneda por defecto, salvo que el ajuste del plugin nombre otra por su id. Cuando un plugin te deja poner una moneda en un precio, escribe el id de la moneda, como points. Déjalo vacío para usar la de por defecto.
El dinero solo se cobra si el jugador puede pagarlo; si no, no cambia nada. En un comando puedes escribir las cantidades en forma corta, como 2.5k o 1m.
Los saldos se quedan en la economía que los guarda. Si pasas de vault a points, los jugadores conservan su dinero de Vault, pero tus plugins ahora cobran puntos. Decídelo antes de abrir el servidor.
Si falta la economía: el respaldo#
Si el plugin de la moneda por defecto no está en el servidor, puedes listar otras monedas para probar en orden:
default-currency: vault
fallback:
- pointsResponde la primera que esté disponible. El cambio se escribe una vez en el log, para que nunca ocurra sin que nadie lo sepa. El respaldo solo vale para la moneda por defecto: un precio que nombra una moneda concreta recibe esa moneda o nada, nunca la cifra correcta en la moneda equivocada.
Con fallback vacío (lo normal) no se prueba nada más. Lista lo que de verdad tiene tu servidor.
Caché de saldos#
balance-cache-millis: 500 indica cuánto se reutiliza un saldo leído de la economía, en milisegundos. Existe porque los scoreboards se refrescan cada tick. Puedes escribir 500ms o 2s. Los saldos que cambia un plugin Exylia se refrescan al instante; el número solo importa para cambios hechos por otros plugins. Déjalo así salvo que un saldo en un scoreboard vaya con retraso.
Comprueba que funciona#
Abre un menú que muestre un precio o usa un comando que cobre, y compara tu saldo antes y después. Si un plugin dice que no hay economía disponible, instala Vault y un plugin de economía, o pon en default-currency una moneda que exista, y ejecuta /exylialib reload.
Detalles técnicos
Los ids de proveedor incluidos son vault y points; cualquier plugin puede registrar más, y ExyliaEconomy registra cada moneda con su propio id. Un plugin de economía que arranca después de ExyliaLib se detecta igualmente. Cuando Vault lo sirve una moneda registrada, vault y esa moneda son el mismo dinero. La librería no guarda saldos. Vista para desarrolladores: Economía.
¿Falta algo en esta página? Dínoslo en Discord