Introducción
Qué es ExyliaEconomy, qué resuelve y cómo está organizada esta documentación.
ExyliaEconomy es la economía de un servidor de Exylia: monedas que el propio servidor guarda en su base de datos, que se editan dentro del juego y que se comparten entre todos los servidores que apuntan a esa misma base de datos. Es gratuito y de código abierto, publicado bajo la GNU General Public License v3.0 en GitHub.
Un servidor puede tener todas las monedas que quiera — dólares, fragmentos, gemas —, cada una con su nombre, símbolo, decimales, formato, saldo inicial, saldo máximo y reglas. Una de ellas se puede publicar como la economía de Vault del servidor, de modo que cualquier plugin de tiendas, trabajos o subastas que solo hable Vault funcione con ella sin EssentialsX ni CMI por debajo. Todos los plugins de Exylia llegan a las mismas monedas a través de ExyliaLib, por su ID.
Antes era el módulo economy de ExyliaSurvivalCore. Ahora es un plugin propio, y un servidor que usaba
ese módulo conserva sus saldos, sus monedas y sus permisos en el primer arranque — ver
Migración.
Qué incluye
Saldos almacenados, monedas de ítem y experiencia, creados y editados desde /economyadmin. Ningún
archivo de monedas que mantener.
/pay con mínimo, impuesto, confirmación a partir de una cantidad, un interruptor por jugador y un
aviso para quien cobró mientras no estaba.
/withdraw imprime dinero en papel. Cada billete es una fila en la base de datos, así que una copia
paga una sola vez.
Un porcentaje del saldo pagado en cada intervalo, una sola vez por jugador en toda la red.
RedUn saldo para toda la red, o uno por servidor. Solo el servidor en el que está el jugador lo escribe.
Registro y reversiónCada movimiento anotado con su motivo, exportado a CSV y revertido línea a línea.
Requisitos
| Requisito | Detalle |
|---|---|
| Servidor | Paper 1.21 o superior. Compatible con Folia. |
| Java | 21 |
| Dependencia obligatoria | ExyliaLib 1.236.0 o superior — se instala sola si falta |
| Dependencias opcionales | Vault, PlaceholderAPI, ExyliaAnalytics |
La configuración tipada, los menús en YAML, la base de datos y Redis, los placeholders, los editores dentro del juego y la fachada de economía con la que paga cada plugin de Exylia vienen de ExyliaLib. ExyliaEconomy es una de las economías que esa fachada sirve: sus monedas se registran ahí, y cualquier plugin que pida dinero a ExyliaLib por ID llega a ellas.
Cómo leer esta documentación
Empezar
Instalación, lo que crea el primer arranque y una primera moneda propia.
Configurar
Monedas, pagos, billetes, intereses y clasificaciones: lo que ve un jugador.
Sistemas
Vault, la red, el registro, las importaciones desde otras economías y cómo lee el dinero el resto del ecosistema.
Referencia
Comandos, permisos, placeholders, cada clave de configuración y cada mensaje, y la API para desarrolladores.
Convenciones
- Los valores marcados como por defecto son los que el plugin escribe la primera vez que arranca. Si el archivo ya existe, se conserva tu valor.
- Los identificadores entre
<y>son variables./pay <player> <amount>significa/pay Steve 100. - Las cantidades se escriben como las escriben los jugadores en cualquier parte:
100,2.5k,1m,3b. Las comas se ignoran y los exponentes se rechazan. - Una moneda se nombra por su ID, la clave en minúsculas con la que se creó:
dollars,shards. - Los colores usan los tokens de la paleta de ExyliaLib (
{primary},{success},{highlight}); las etiquetas de MiniMessage como<click>y<hover>también funcionan, como muestran los botones de confirmación.
¿Falta algo en esta página? Dínoslo en Discord