Configuración
config.yml clave por clave, qué contiene messages.yml, los archivos de menú y sus valores, y cada tabla de la base de datos que guarda el plugin.
Todo se genera en plugins/ExyliaEconomy/ en el primer arranque, con comentarios. Edita los archivos de
ahí, nunca las copias del jar. config.yml contiene solo lo que decide cada servidor por su cuenta; las
monedas y los ajustes generales de la economía viven en la base de datos y se editan con /economyadmin,
así que todos los servidores de una red leen los mismos. /economyadmin reload aplica un cambio.
config.yml
# ExyliaEconomy. The currencies are kept in the database and edited in game with /economyadmin.
language: default
debug: false
pay-confirm-above:
default: '0'
offline-pay-notice: true
banknotes:
- default
interest: {}| Clave | Por defecto | Qué hace |
|---|---|---|
language | default | El idioma de los menús y mensajes de este plugin. default sigue el idioma fijado en el config.yml de ExyliaLib; en, es o pt lo fijan solo para este plugin. Cada uno es una carpeta dentro de lang/. Cualquier otro código empieza como una copia del inglés, para que lo reescribas. |
debug | false | Explica en consola lo que está haciendo el plugin. |
pay-confirm-above | default: '0' | Por ID de moneda, la cantidad a partir de la cual /pay pide al que paga confirmar en 30 segundos. default cubre cada moneda que no aparezca; '0' nunca pregunta. Ver Pagos. |
offline-pay-notice | true | Avisa a un jugador, al entrar, de lo que le pagaron mientras estaba desconectado: una línea por moneda. |
banknotes | [default] | Las monedas que puede imprimir /withdraw, por ID; default es la moneda por defecto. Solo monedas almacenadas. Vacío desactiva los billetes. Ver Billetes. |
interest | vacío | Por ID de moneda, rate, interval, max y online-only. No se paga nada hasta que se añade una. Ver Intereses. |
Las cantidades de pay-confirm-above y interest.<id>.max se leen como las de los comandos: 10000,
10k, 1.5m. Escríbelas entre comillas, como las de por defecto.
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}• 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.
| Claves | Qué son |
|---|---|
balance, balance-other, wallet-header, wallet-line, currencies-header, currencies-line | Saldos 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-expired | Pagos. |
pay-toggle-off, pay-toggle-on, pay-toggle-failed | /paytoggle. |
offline-pay-single, offline-pay-many | El 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, usage | Rechazos. 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, queued | Cambios de administración. |
give-all-confirm, give-all-done, give-all-nobody | giveall. |
top-header, top-line, top-empty, top-total, top-disabled | La clasificación en consola. |
history-header, history-line, history-empty | El historial en consola. |
exchanged, exchange-failed, exchange-not-allowed, exchange-no-rate, exchange-over-ceiling, exchange-cancelled | Cambios de moneda. |
import-started, import-done, import-already, import-same, import-running, import-failed | Importaciones. |
currency-created, currency-deleted, currency-saved, currency-not-found, currency-exists, currency-invalid-id, currency-invalid-rates, currency-networked-locked, currency-write-failed | El editor. |
rewards-delivered | Pagos de ítem y de experiencia entregados al entrar. %amount% es cuántos. |
note-withdrawn, note-redeemed, note-invalid, note-not-held, note-disabled, note-inventory-full, note-failed, note-wrong-server | Billetes. |
log-header, log-line, export-started, export-done, ledger-failed, rollback-confirm, rollback-nothing, rollback-done, invalid-window | Las herramientas del registro. |
interest-paid | Un pago de intereses: %amount%, %currency%, %next%. Vacío para pagar en silencio. |
reasons | Cómo se lee cada motivo del registro en los historiales: pay: Pago, shop:sell: Venta en la tienda, … |
kinds | Cómo se lee cada tipo de moneda: stored: Moneda del servidor, item: Ítem, experience: Experiencia, external: Otro plugin, unknown: Desconocida. |
banknote | El material, name y lore del billete. Ver Billetes. |
admin | Las 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… |
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
Seis pantallas, dentro de lang/<code>/menus/.
| Archivo | Lo abre | Ediciones |
|---|---|---|
user/wallet.yml | /wallet, /economy, el botón de volver de las otras dos | Tuyas. Se escribe una vez, si falta. |
user/top.yml | /baltop, top, clic derecho en la billetera | Tuyas. |
user/history.yml | history, clic izquierdo en la billetera | Tuyas. |
admin/currency_admin_list.yml | /economyadmin | Se reemplaza desde el jar en cada arranque y cada recarga de menús. |
admin/currency_admin_edit.yml | Una moneda de la lista | Se reemplaza. |
admin/currency_admin_settings.yml | Ajustes de economía | Se reemplaza. |
Un archivo de menú que no se puede leer se nombra en consola y esa pantalla no abre; arréglalo y ejecuta
/economyadmin reload.
Valores en las pantallas de los jugadores
| Archivo | Valores de la pantalla | Cada 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ón | Qué 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.
| Tabla | Contiene |
|---|---|
exylia_currencies | Una fila por moneda. |
exylia_economy_settings | Los ajustes de la economía, la elección de Vault, la retención del registro y las importaciones ya hechas. |
exylia_balances | Una fila por jugador y moneda almacenada, con el servidor que la tiene. |
exylia_balance_pending | Cambios en cola para un jugador que está en otra parte o desconectado. |
exylia_balance_pending_taken | Marcas de cambios en cola ya tomados, guardadas seis horas para que un reintento nunca pague dos veces. |
exylia_ledger | El registro. |
exylia_balance_imports | A quién ya pagó cada /economyadmin import. |
exylia_economy_claims | Pagos de intereses y reversiones ya hechos. |
exylia_economy_flags | /paytoggle y la exención de la clasificación, por jugador. |
exylia_banknotes | Cada billete impreso, y quién lo canjeó. |
exylia_pay_notices | Pagos 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