Contenido generado con IA — puede contener errores.

ExyliaEconomy/EmpezarActualizada en v1.4.0

Instalación

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

Página 2 de 256 min de lectura

ExyliaEconomy es gratis: descarga el jar, ponlo en plugins/ junto a ExyliaLib y tendrás una economía funcionando tras un reinicio.

Descargar#

ExyliaEconomy es gratuito. Cada versión se publica en Modrinth como ExyliaEconomy-<version>.jar.

Antes de empezar#

PluginPara qué
ExyliaLibObligatorio. Configuración, menús, base de datos, Redis, placeholders, los editores y la fachada de economía. 1.597.0 o superior.
ServidorPaper o Folia 1.21.4 o superior. Java 21.
VaultOpcional. Sin él no se publica nada como economía de Vault, y los plugins que solo hablan Vault no ven dinero.
PlaceholderAPIOpcional. Expone los saldos y las clasificaciones a otros plugins.
ExyliaAnalyticsOpcional. Recibe el dinero en circulación de cada moneda almacenada.
ExyliaLib figura como soft, y no se descarga por ti

plugin.yml pone ExyliaLib en softdepend a propósito, para que el plugin pueda arrancar sin ella y decir qué pasa. Sin ExyliaLib, ExyliaEconomy se queda apagado y la consola dice dónde conseguirla (Modrinth o las releases de la librería en GitHub): pon el jar en plugins/ y reinicia. Si ya hay un jar de ExyliaLib en plugins/ pero no cargó, la consola te pide que arregles primero los errores de la propia 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 plugin se queda apagado y la consola dice dónde conseguirla; instálala y reinicia.

Revisa la consola

El plugin se activa sin avisar. Ejecuta /economyadmin: si se abre la lista de monedas, ya están leídas. Con Depuración activada en Ajustes de economía, la consola también imprime una línea como Economy: 2 stored, 1 item and 1 experience currencies., y después qué moneda sirve a Vault. El dinero funciona 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.

Si vienes de ExyliaSurvivalCore

La importación automática de la economía del survival core se quitó en la 1.2.1. Un servidor que aún usa el módulo debe pasarse antes con una versión anterior a esa. Ver Migración.

Archivos generados#

Todos viven en plugins/ExyliaEconomy/.

ArchivoContenido
lang/<code>/messages.ymlCada 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: la lista de monedas, una moneda y sus páginas, los ajustes de economía y el registro de administración.
screens/economy.html, screens/theme.cssLa billetera, la clasificación y el historial como una sola pantalla.
database.ymlMotor de base de datos y Redis, escrito por ExyliaLib. H2 por defecto.
currencies.yml.importedEl archivo de monedas que importó el primer arranque, apartado. No se vuelve a leer.
exports/Las exportaciones del registro hechas con /economyadmin export.
config.yml.migratedUn config.yml antiguo importado a la base de datos, apartado. Solo en un servidor actualizado desde una versión anterior.

<code> es el idioma en el que funciona el plugin: en, es, pt, fr, ru o tr, o el propio idioma de ExyliaLib mientras Ajustes de economía 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 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
yaml
database:
  type: mysql
  settings:
    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.597.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. 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