Contenido generado con IA — puede contener errores.

ExyliaEconomy/ReferenciaActualizada en v1.4.0

Configuración

Dónde vive cada ajuste, qué contiene messages.yml, los archivos de menú y de pantalla con sus valores, y cada tabla de la base de datos que guarda el plugin.

Página 17 de 257 min de lectura

Todo se genera en plugins/ExyliaEconomy/ en el primer arranque, con comentarios. Edita los archivos de ahí, nunca las copias del jar. El plugin no escribe ningún config.yml: las monedas y todos los ajustes viven en la base de datos y se editan en el juego con /economyadmin, así que todos los servidores de una red leen los mismos y un cambio en uno llega a los demás. /economyadmin reload vuelve a leer los archivos y la base de datos.

Casi todo lo que vas a cambiar es un botón, no un archivo: ejecuta /economyadmin para editar monedas y ajustes, y abre lang/<code>/messages.yml solo para reescribir un mensaje. Las listas completas de claves están plegadas más abajo.

Ajustes#

DóndeAjusteQué hace
Ajustes de economíaIdiomadefault sigue el idioma de ExyliaLib; en, es, pt, fr, ru o tr lo fijan solo para este plugin. Se aplica al instante.
Ajustes de economíaDepuraciónExplica en consola lo que está haciendo el plugin.
Ajustes de economíaAviso de pagos sin conexiónAvisa a un jugador, al entrar, de lo que le pagaron mientras estaba desconectado. Ver Pagos.
Página Pagos de una monedaConfirmación de pagoLa cantidad a partir de la cual /pay pregunta antes. Ver Pagos.
Página Pagos de una monedaBilletesSi /withdraw puede imprimirla. Ver Billetes.
Página Intereses de una monedaTasa, intervalo, máximo, sin conexiónVer Intereses.

Un servidor que actualiza desde una versión con config.yml lo ve importado a la base de datos en el primer arranque, donde todavía no hay nada fijado, y renombrado a config.yml.migrated. Un config.yml que solo contenga language se importa igual. Ver Migración.

messages.yml#

lang/<code>/messages.yml contiene cada línea que dice el plugin. %prefix% se sustituye por el valor prefix de arriba del todo, {primary}&lECONOMÍA {letters_black}•<reset> en español. Los colores son tokens de la paleta, así que cambiar los colores de la red nunca obliga a editar este archivo; las etiquetas de MiniMessage también funcionan, y las líneas de confirmación usan <click> y <hover> para su botón [✔ CONFIRMAR].

Una línea puede empezar con una etiqueta de efecto, que nunca llega a la pantalla: [sound:NAME|volume|pitch] reproduce un sonido a quien la recibe. Una línea vacía no envía nada — así se desactiva un mensaje.

Algunas líneas se muestran en el HUD del jugador en vez de en el chat, con la etiqueta [hud:grupo], y vuelven al chat para quien no lo ve: paid y paid-taxed (hud:paid), y received, given-notify e interest-paid (hud:earned). Nuevo en v1.4.0

Todas las claves de messages.yml
ClavesQué son
balance, balance-other, wallet-header, wallet-line, currencies-header, currencies-lineSaldos y listas en el chat.
paid, paid-taxed, received, pay-self, pay-disabled, pay-minimum, pay-refused, pay-cancelled, pay-disabled-target, pay-confirm, confirm-expiredPagos.
pay-toggle-off, pay-toggle-on, pay-toggle-failed/paytoggle.
offline-pay-single, offline-pay-manyEl aviso al entrar.
not-enough, invalid-amount, no-currency, no-permission, not-available, still-loading, refused, over-ceiling, at-ceiling, permission-denied, economy-off, player-required, usageRechazos. over-ceiling, at-ceiling y los motivos exchange-… son texto plano que se inserta en refused o exchange-failed.
given, given-notify, taken, taken-notify, set, reset, queuedCambios de administración.
give-all-confirm, give-all-done, give-all-nobodygiveall.
reset-confirmLa pregunta que hace reset antes de actuar.
top-header, top-line, top-empty, top-total, top-disabledLa clasificación en consola.
history-header, history-line, history-emptyEl historial en consola.
exchanged, exchange-failed, exchange-not-allowed, exchange-no-rate, exchange-over-ceiling, exchange-cancelledCambios de moneda.
import-started, import-done, import-already, import-same, import-running, import-failedImportaciones.
currency-created, currency-deleted, currency-saved, currency-not-found, currency-exists, currency-invalid-id, currency-invalid-rates, currency-networked-locked, currency-write-failedEl editor.
rewards-deliveredPagos de ítem y de experiencia entregados al entrar. %amount% es cuántos.
note-withdrawn, note-queued, note-redeemed, note-invalid, note-not-held, note-disabled, note-failed, note-wrong-serverBilletes.
log-header, log-line, export-started, export-done, ledger-failed, rollback-confirm, rollback-nothing, rollback-done, invalid-windowLas herramientas del registro.
interest-paidUn pago de intereses: %amount%, %currency%, %next%. Vacío para pagar en silencio.
reasonsCómo se lee cada motivo del registro en los historiales: pay: Pago, shop:sell: Venta en la tienda, …
kindsCómo se lee cada tipo de moneda: stored: Moneda del servidor, item: Ítem, experience: Experiencia, external: Otro plugin, unknown: Desconocida.
banknoteEl material, name y lore del billete. Ver Billetes.
adminLas preguntas del editor, los títulos de formulario, los nombres de campo y sus pistas, y las palabras que muestran sus pantallas: on, off, none, ledger-forever, ledger-days, kind-stored…
demoLas respuestas de /economyadmin demo seed y demo clear.

Un motivo que no aparece en reasons se lee como la etiqueta de la parte antes de los dos puntos, y si no, como el propio motivo con la primera letra en mayúscula, así que los motivos de un plugin nuevo nunca aparecen en blanco.

Menús#

Las pantallas de los jugadores y las del editor, dentro de lang/<code>/menus/.

Todos los archivos de menú
ArchivoLo abreEdiciones
user/wallet.yml/wallet, /economy, el botón de volver de las otras dosTuyas. Se escribe una vez, si falta.
user/top.yml/baltop, top, clic derecho en la billeteraTuyas.
user/history.ymlhistory, clic izquierdo en la billeteraTuyas.
admin/currency_admin_list.yml/economyadminSe reemplaza desde el jar en cada arranque y cada recarga de menús.
admin/currency_admin_edit.yml y currency_admin_edit_*.ymlUna moneda de la lista; sus páginas General, Comandos, Pagos, Cambio, Intereses e IntegracionesSe reemplazan.
admin/currency_admin_settings.ymlAjustes de economíaSe reemplaza.
admin/ledger_admin_list.yml, ledger_admin_entry.yml/economyadmin log de un jugador; una línea suyaSe reemplazan.

Un archivo de menú que no se puede leer se nombra en consola y esa pantalla no abre; arréglalo y ejecuta /economyadmin reload.

La billetera como pantalla#

screens/economy.html (con screens/theme.css) dibuja la billetera, la clasificación y el historial como una sola pantalla con una barra lateral de monedas. Sustituye a los tres menús de cofre de arriba y lee los mismos valores; las palabras salen de lang/<code>/screens/economy.yml. Pon tus propias reglas en un custom.css junto al tema y el HTML sigue actualizándose con el plugin. /exylialib screens check lista lo que tenga mal.

Valores en las pantallas de los jugadores#

Valores y acciones de los menús
ArchivoValores de la pantallaCada fila
wallet.yml%wallet_owner%, %wallet_owner_id%, %wallet_currencies%%currency%, %currency_id%, %currency_icon%, %currency_balance%, %currency_kind%, %wallet_owner_id%
top.yml%currency%, %currency_id%, %top_size%, %top_total%%top_position%, %top_player%, %top_amount%, %currency%
history.yml%currency%, %currency_id%, %history_owner%, %history_owner_id%, %history_size%%entry_when%, %entry_delta%, %entry_reason%, %entry_balance%, %entry_server%, %entry_icon%

La billetera lista solo las monedas que puede usar quien la mira. La tabla y el historial tienen 90 filas; %entry_icon% es LIME_DYE para el dinero que entra y RED_DYE para el que sale.

Acciones#

Los botones llaman a estas, y cualquier menú de cualquier plugin de Exylia también puede:

AcciónQué hace
exyliaeconomy:economy_wallet [uuid]Abre una billetera: la de quien hace clic, o la del jugador cuyo ID se indica.
exyliaeconomy:economy_history <currency> [uuid]Abre un historial. Se rechaza para una moneda que quien hace clic no puede usar.
exyliaeconomy:economy_top <currency>Abre una clasificación, igual que top.

Los botones del editor son acciones exyliaeconomy:currency_admin_*; cada una comprueba exyliaeconomy.admin en el clic.

Base de datos#

Todas las tablas viven en la base de datos a la que apunta database.yml; ver Instalación.

Todas las tablas
TablaContiene
exylia_currenciesUna fila por moneda.
exylia_economy_settingsLos ajustes de la economía, la elección de Vault, la retención del registro y las importaciones ya hechas.
exylia_balancesUna fila por jugador y moneda almacenada, con el servidor que la tiene.
exylia_balance_pendingCambios en cola para un jugador que está en otra parte o desconectado.
exylia_balance_pending_takenMarcas de cambios en cola ya tomados, guardadas seis horas para que un reintento nunca pague dos veces.
exylia_ledgerEl registro.
exylia_balance_importsA quién ya pagó cada /economyadmin import.
exylia_economy_claimsPagos de intereses y reversiones ya hechos.
exylia_economy_flags/paytoggle y la exención de la clasificación, por jugador.
exylia_banknotesCada billete impreso, y quién lo canjeó.
exylia_pay_noticesPagos pendientes de mostrar al entrar.

Los pagos de ítem y de experiencia que esperan a que un jugador entre se guardan en las recompensas pendientes de ExyliaLib.

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