Imprime billetes
Deja que los jugadores conviertan dinero en un ítem de papel con /withdraw y lo canjeen con clic derecho o /deposit, a prueba de copias.
Un billete es dinero impreso en papel. Los jugadores ejecutan /withdraw <amount> [currency] y reciben una nota que pueden regalar, tirar, intercambiar y guardar en cofres como cualquier ítem. Quien le haga clic derecho, o ejecute /deposit con ella en la mano, se queda el dinero.
Antes de empezar#
Necesitas una moneda almacenada, ver Crea una moneda. Solo las monedas almacenadas imprimen billetes; las de ítem, experiencia y solo visuales no tienen interruptor. Una moneda nueva tiene los billetes desactivados, así que un servidor recién instalado no imprime ninguno hasta que actives uno.
Pasos#
Abre la moneda
Ejecuta /economyadmin y clic izquierdo en la moneda.
Activa los billetes
Pulsa Pagos y después Billetes. Ahora aparece activado.
Deja que los jugadores lo usen
/withdraw necesita exyliaeconomy.withdraw, que todos tienen por defecto. Canjear no necesita permiso, ver Permisos.
Comprueba que funciona#
Imprime uno
Con algo de saldo, ejecuta /withdraw 100 <moneda>. Recibes un ítem de papel llamado BILLETE con la cantidad; sin la moneda se usa la moneda por defecto.
Cóbralo
Clic derecho con el billete en cualquier mano. Lees "Canjeaste un billete de …" y el saldo vuelve. /deposit hace lo mismo mientras lo sostienes.
Ir más allá#
Cuando se rechaza una retirada#
Se rechaza, antes de cobrar nada, cuando el interruptor Billetes de la moneda está desactivado ("… no se puede retirar como billete."), cuando la cantidad no es positiva o se redondea a nada con los decimales de la moneda, cuando el saldo aún se está cargando o cuando el jugador no puede permitírselo.
Con el inventario lleno la retirada funciona igualmente: el billete queda en cola y se entrega cuando se libera un hueco o al volver a entrar. Dos retiradas con menos de medio segundo entre ellas cuentan como una.
Qué es un billete#
El ítem sale de la sección banknote de plugins/ExyliaEconomy/lang/es/messages.yml (lang/en/messages.yml en inglés), así que puedes cambiar su material, nombre y lore. Ver colores y mensajes e idiomas.
banknote:
material: PAPER
name: '{primary}&lBILLETE &8[{success}%amount%&8]'
lore:
- ''
- '{secondary}Información:'
- ' {letters_black}▎ {letters}Moneda {letters_black}» {highlight}%currency%'
- ' {letters_black}▎ {letters}Firmado por {letters_black}» {highlight}%issuer%'
- ' {letters_black}▎ {letters}Emitido {letters_black}» {info}%date%'
- ''
- '{warning}➥ Clic derecho para canjear'
- ''%amount% es la cantidad con formato, %currency% el nombre en plural de la moneda, %issuer% quién lo imprimió y %date% el día en que se imprimió. El billete siempre brilla y nunca se apila.
Lo que vale un billete no está en el ítem. El ítem solo lleva el ID del billete; la cantidad, la moneda y el emisor son una fila de exylia_banknotes, escrita antes de cobrar el dinero. Renombrar o editar el ítem no cambia nada.
Canjear#
Clic derecho con un billete en cualquier mano, al aire o a un bloque, o /deposit mientras sostienes uno (primero la mano principal, luego la secundaria). El clic derecho no necesita permiso; /deposit necesita exyliaeconomy.use. Ambos necesitan el permiso propio de la moneda si tiene uno.
El billete sale de la mano antes de que ocurra nada más, luego se reclama su fila en la base de datos y después se paga el dinero:
| Qué dice la base de datos | Qué ve el jugador |
|---|---|
| Aún no canjeado | "Canjeaste un billete de …": el dinero es suyo. |
| Ya canjeado, o no existe | "Este billete ya fue canjeado o no es válido." El ítem desaparece. |
| La moneda rechazó el pago (su máximo) | El billete vuelve, sin canjear, con el motivo. |
| La base de datos no respondió | El billete vuelve: "No se pudo procesar el billete ahora mismo. Inténtalo de nuevo en un momento." |
Una pila duplicada, un clon en creativo, el mismo billete canjeado en dos servidores a la vez: solo una reclamación sobre la fila puede ganar, así que el dinero se paga exactamente una vez en toda la red y cualquier otra copia desaparece.
Monedas por servidor#
Un billete recuerda de qué saldo se imprimió. Una moneda guardada por servidor o por grupo de red (ver Red) solo canjea sus billetes donde ese saldo es el mismo: en cualquier otro sitio se rechaza y el billete vuelve con "Este billete solo se puede canjear en el servidor que lo emitió." Un billete de una moneda global se canjea en cualquier parte.
Fuera del crafteo y el comercio#
Un billete es papel, y vanilla convertiría el papel en libros, mapas y cohetes, o lo cambiaría a un bibliotecario. Cualquier inventario que contenga un billete se niega a producir resultado: mesas de crafteo, la cuadrícula del inventario, crafters, yunques, piedras de afilar, mesas de herrería, telares, mesas de cartografía, cortapiedras y comercio con aldeanos.
En el registro#
Las dos mitades de un billete son dos líneas del registro: note:withdraw en el emisor y note:redeem en quien lo canjeó. Una reversión nunca deshace ninguna, porque la otra mitad es un billete que alguien aún puede tener. Ver Registro.
Arreglar un billete atascado
El billete se anota primero en la base de datos, luego se cobra el dinero y se entrega el billete en el mismo tick. Si al final no se puede cobrar, el registro se descarta y no se entrega nada.
Si se rechaza un pago y la base de datos falla al marcar de nuevo el billete como no canjeado, el billete vuelve al jugador pero sigue marcado como canjeado, y la consola nombra su ID. Pon redeemed_at a 0 en esa fila de exylia_banknotes para poder canjearlo otra vez. Un jugador que se va antes de que se le pueda devolver un billete rechazado se anota igual, con la fila para pagar a mano.
¿Falta algo en esta página? Dínoslo en Discord