Empezar

Instalación

Descargar el plugin, cómo se instala ExyliaLib sola, la base de datos, los archivos que escribe el primer arranque y cómo llegan las actualizaciones.

Descargar

ExyliaEconomy es gratuito. Cada versión se publica en GitHub con dos copias del mismo jar: ExyliaEconomy-<version>.jar y ExyliaEconomy.jar. Sirve cualquiera de las dos; la segunda mantiene el mismo nombre en todas las versiones, y es la que descarga el actualizador.

Antes de empezar

Plugin	Para qué
`ExyliaLib`	Obligatorio. Configuración, menús, base de datos, Redis, placeholders, los editores y la fachada de economía. 1.236.0 o superior.
`Vault`	Opcional. Sin él no se publica nada como economía de Vault, y los plugins que solo hablan Vault no ven dinero.
`PlaceholderAPI`	Opcional. Expone los saldos y las clasificaciones a otros plugins.
`ExyliaAnalytics`	Opcional. Recibe el dinero en circulación de cada moneda almacenada.

ExyliaLib figura como soft, y se instala sola

plugin.yml pone ExyliaLib en softdepend a propósito, para que el plugin pueda arrancar sin ella. Cuando falta ExyliaLib, ExyliaEconomy descarga exactamente la versión con la que se compiló (ExyliaLib-1.236.0.jar desde las releases de la librería en GitHub) en plugins/ExyliaLib.jar, lo avisa en consola y se queda desactivado hasta que reinicies. Si ya hay un jar de ExyliaLib en plugins/ pero no cargó, no se descarga nada: la consola te pide que arregles primero los errores de la librería.

ExyliaEconomy no necesita packetevents por sí mismo. ExyliaLib sí: instálalo junto a la librería como explica la página de instalación de la librería.

Instalar

Coloca el jar

Copia ExyliaEconomy.jar en plugins/, junto con Vault si quieres que los plugins que usan Vault vean las monedas.

Arranca el servidor

Sin ExyliaLib, el primer arranque la descarga y pide un reinicio. Reinicia una vez.

Revisa la consola

Cuando se leen las monedas aparece una línea como Economy: 2 stored, 1 item and 1 experience currencies., y después qué moneda sirve a Vault. Nada relacionado con el dinero funciona antes de esa primera línea, un instante después de que el servidor termina de arrancar.

Abre el editor

Con exyliaeconomy.admin, ejecuta /economyadmin para ver las monedas con las que empieza el servidor. Ver Primeros pasos.

Junto a ExyliaSurvivalCore

Un servidor que usaba el módulo economy de ExyliaSurvivalCore debe instalar este plugin antes de su primer arranque, con la carpeta de ExyliaSurvivalCore todavía en su sitio: ese primer arranque es el que trae la configuración de la base de datos, las monedas, los mensajes y los menús de los jugadores. Lee primero Migración.

Archivos generados

Todos viven en plugins/ExyliaEconomy/.

Archivo	Contenido
`config.yml`	Lo que decide cada servidor por su cuenta: idioma, depuración, la confirmación de `/pay`, los avisos de pagos recibidos, los billetes y los intereses.
`lang/<code>/messages.yml`	Cada línea que envía el plugin, el aspecto del billete y los textos del editor de monedas.
`lang/<code>/menus/user/`	Las pantallas de los jugadores: `wallet.yml`, `top.yml`, `history.yml`. Se escriben si faltan y nunca se sobrescriben.
`lang/<code>/menus/admin/`	Las pantallas del editor: `currency_admin_list.yml`, `currency_admin_edit.yml`, `currency_admin_settings.yml`.
`database.yml`	Motor de base de datos y Redis, escrito por ExyliaLib. H2 por defecto.
`currencies.yml.imported`	El archivo de monedas que importó el primer arranque, apartado. No se vuelve a leer.
`exports/`	Las exportaciones del registro hechas con `/economyadmin export`.
`.imported-survivalcore`	Una marca de que ya se buscaron los archivos de ExyliaSurvivalCore. Bórrala para buscarlos otra vez.

<code> es el idioma en el que funciona el plugin: en, es o pt, o el propio idioma de ExyliaLib mientras config.yml diga default. Ver Configuración.

menus/admin/ se reescribe

Las tres pantallas del editor se reemplazan desde el jar cada vez que arranca el plugin y cada vez que se recargan sus menús — /economyadmin reload, y una recarga de la propia ExyliaLib. Su cabecera dice "regenerado en cada arranque"; también ocurre al recargar. Ahí no vive nada que un dueño deba editar.

Las monedas no están en un archivo

Las monedas y los ajustes generales de la economía viven en la base de datos, en exylia_currencies y exylia_economy_settings, y se editan con /economyadmin. El primer arranque importa currencies.yml — el tuyo, el de ExyliaSurvivalCore o el de serie — y le cambia el nombre. Un currencies.yml encontrado en un arranque posterior se avisa en consola y se ignora.

Base de datos

Por defecto el plugin usa H2: un archivo dentro de la carpeta del plugin, sin servidor, sin instalación y sin mantenimiento. Para un único servidor es perfectamente válido.

Para compartir saldos entre servidores, todos apuntan a la misma base de datos:

plugins/ExyliaEconomy/database.yml

database:
  type: mysql
  settings:
    max-pool-size: 0
  mysql:
    host: 127.0.0.1
    port: 3306
    database: minecraft
    username: root
    password: ""
  redis:
    enabled: true
    host: 127.0.0.1
    server-id: survival-1

Motores soportados: h2, mysql, mariadb, postgresql y mongodb. Solo se lee el bloque que coincide con type. El archivo es de ExyliaLib; su referencia completa está en la página de base de datos de la librería.

Dale a cada servidor su propio server-id

Quién tiene un saldo lo decide server-id, que vale server-1 si no lo cambias. Dos servidores que comparten base de datos con el mismo ID creen ambos que tienen al jugador y se pisan los saldos. La consola avisa una vez cuando ve el ID por defecto en una base de datos compartida. Ver Red.

Nada espera a la base de datos mientras el plugin se activa. Las monedas se leen en el primer tick; los saldos de un jugador se reclaman cuando entra, y cada escritura es asíncrona.

Actualizar

ExyliaLib mantiene ExyliaEconomy al día. El plugin indica su repositorio de GitHub en plugin.yml (exylia-updates: Exylia-Plugins/ExyliaEconomy) y la versión mínima de la librería con la que funciona (exylia-lib: 1.236.0); ExyliaLib busca una versión más nueva al arrancar y cada cierto tiempo, la descarga, la comprueba y la deja preparada para el siguiente reinicio.

Solo se instalan solas las versiones menores y los parches. Una versión mayor nueva se anuncia y se deja en tus manos.
Una versión que necesita una ExyliaLib más nueva que la que estará funcionando se retiene hasta que la librería se ponga al día.
/exylialib plugins lo comprueba en el momento. plugin-updates en plugins/ExyliaLib/config.yml lo apaga (enabled: false), permite versiones mayores o excluye este plugin por su nombre.

Para actualizar a mano, reemplaza el jar y reinicia. config.yml, messages.yml y los menús de los jugadores conservan tus cambios; menus/admin/ se refresca desde el jar; las monedas, los saldos y el registro viven en la base de datos y no se tocan.

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