Migración

Desde ExyliaSurvivalCore

ExyliaEconomy es el módulo economy de ExyliaSurvivalCore convertido en plugin propio. Los saldos, los cambios en cola y el registro ya vivían en tablas con nombres neutros (exylia_balances, exylia_balance_pending, exylia_ledger), así que pasarse consiste en abrir la misma base de datos.

En su primer arranque junto a ExyliaSurvivalCore, ExyliaEconomy trae, una sola vez:

Nada de la carpeta de ExyliaSurvivalCore se cambia ni se borra nunca. Un archivo de marca, .imported-survivalcore, anota que la importación se hizo; bórralo para hacerla otra vez. Un database.yml escrito por una versión anterior que todavía abría el archivo H2 del survival core recibe su propia copia en el siguiente arranque, y la consola lo dice.

Permisos

Lo que tenía concedido el staff cuando la economía vivía en ExyliaSurvivalCore sigue funcionando: los nodos antiguos se declaran de nuevo, cada uno con su nodo nuevo como hijo.

Comandos y placeholders

Los comandos conservan sus nombres — /balance, /pay, /baltop, /wallet, /economy, /economyadmin y los comandos de las monedas —, igual que las antiguas formas de administración /eco give, /eco take, /eco set, /eco reset y /eco import, con las que están escritos los archivos de recompensas y cajas de los servidores en marcha.

Los placeholders pertenecen ahora a este plugin: %exyliasurvivalcore_economy_balance_<currency>% pasa a ser %exyliaeconomy_economy_balance_<currency>%, y lo mismo para el resto. Ver Placeholders.

El archivo de monedas del primer arranque

Las monedas viven en la base de datos. La primera vez que las tablas están vacías — un servidor nuevo, o uno cuyo survival core no tenía monedas que copiar —, el plugin importa un currencies.yml, en este orden:

1. plugins/ExyliaEconomy/currencies.yml, si pusiste uno ahí;
2. plugins/ExyliaSurvivalCore/modules/economy/currencies.yml, copiado antes;
3. las monedas de serie: dollars, shards, netherite_ingots, y las superposiciones vault y points.

Después el archivo se renombra a currencies.yml.imported y no se vuelve a leer. Su formato, para un servidor que quiera preparar uno:

stored:
  gems:
    name: Gem
    plural: Gems
    symbol: "◆"
    icon: EMERALD
    decimals: 0
    format: "%amount% %symbol%"
    compact-format: "%amount%%symbol%"
    aliases: [gems, gem]
    start: 0
    max: -1
    permission: ""
    transfer:
      enabled: true
      minimum: 1
      tax-percent: 0
    exchange:
      enabled: false
      rates: {}
    leaderboard: true
    networked: true
    commands: true
items:
  emeralds:
    item: EMERALD          # o una instantánea 'bytes:' de un ítem personalizado
    name: Emerald
    plural: Emeralds
    icon: EMERALD
    format: "%amount% %name%"
    aliases: []
experience:
  levels: false
  points: true
display:
  vault:
    name: Dollar
    plural: Dollars
    symbol: "$"
    decimals: 2
    format: "%symbol%%amount%"
vault:
  provide: gems
  force: false
ledger:
  enabled: true

Un ID de moneda almacenada que no sea a-z, 0-9 y _ hasta 32, o una moneda de ítem sin ítem, se omite con un aviso. Un bloque almacenado sin exchange.enabled lo lee como activado.

Desde Vault o PlayerPoints

/economyadmin import <from> <into> suma el saldo de cada jugador en una moneda a una moneda almacenada. from puede ser cualquier moneda del servidor, incluida vault mientras EssentialsX o CMI la sigan sirviendo, o points para PlayerPoints.

Una importación suma, nunca fija, así que se ejecuta una vez:

• una segunda importación del mismo par se rechaza salvo que añadas again;
• con again, solo cobran los jugadores que aún no se importaron — nadie cobra dos veces, ni tras una importación que se quedó a medias ni con una lanzada en dos servidores a la vez;
• una importación entre una moneda y ella misma se rechaza, incluido vault hacia la moneda que sirve vault;
• una segunda ejecución escrita mientras otra está leyendo se rechaza: "That import is already running."

Cada jugador importado se anota en exylia_balance_imports, y el registro pone import:<from>.