Contenido generado con IA — puede contener errores.

ExyliaEconomy/GuíasActualizada en v1.4.0

Crea una moneda

Crea monedas almacenadas, de ítem, de experiencia y solo visuales dentro del juego, fija sus reglas, impuesto y tasas de cambio, y dale a cada una su comando.

Página 4 de 2511 min de lectura

Al terminar tendrás una moneda nueva que los jugadores ven en /wallet, consultan con su propio comando y se pagan entre ellos. Las monedas se crean y se editan dentro del juego con /economyadmin; no hay archivo de monedas que editar.

Antes de empezar#

Necesitas exyliaeconomy.admin (los operadores lo tienen) y haber revisado tu primera moneda, ver Tu primera moneda. Decide antes el tipo:

TipoQué es
AlmacenadaUn saldo guardado en la base de datos. Funciona con jugadores desconectados o en otro servidor. Es el único tipo con reglas, registro, clasificación, intereses y billetes.
ÍtemUn ítem exacto en el inventario del jugador. El saldo es cuántos lleva; pagar los saca, cobrar los mete.
Solo visualSin saldo propio: el nombre, el símbolo, los decimales y el formato con los que se muestra la moneda de otro plugin, como vault o points.

La experiencia es una cuarta fuente. No se crea, se activa en Ajustes de economía: xp_levels y xp_points pasan a ser IDs de moneda con los que una tienda puede poner precios.

Pasos#

Abre la lista

Ejecuta /economyadmin. Salen todas las monedas, por orden.

Créala

Pulsa Crear moneda. Escribe un ID en el chat (a-z, 0-9 y _, hasta 32; no cambia después) y elige Almacenada, Ítem o Solo visual. En una moneda de ítem te pide después que coloques el ítem exacto.

Dale aspecto

Clic izquierdo en tu moneda y después la tarjeta General. Ahí están Icono, Apariencia (nombre, plural, símbolo, decimales, formato, formato compacto) y Orden. El resumen de la pantalla de edición enseña una vista previa completa y otra compacta.

Fija las reglas

Vuelve a la pantalla de edición, Reglas: saldo inicial, saldo máximo, permiso, mínimo que un jugador puede enviar e impuesto de transferencia. Pagos, Cambio, Interés e Integraciones cubren el resto, ver la lista de abajo.

Revisa el comando

Comandos guarda los nombres, separados por comas y sin la barra. El primero es el comando y el resto, alias.

La pantalla de edición es un centro de tarjetas y muestra solo lo que usa el tipo de la moneda. Cada tarjeta abre su propia página, con un botón Volver:

TarjetaQué contiene
GeneralIcono, apariencia y orden.
ComandosNombres de comando y el interruptor que los activa o desactiva.
ReglasSaldo inicial, máximo, permiso, mínimo, impuesto y dónde existe la moneda. En una moneda de ítem, la tarjeta Ítem guarda el ítem.
PagosInterruptor de transferencias, confirmación de pago, billetes.
CambioEl interruptor de cambio y las tasas.
InterésTasa, intervalo, tope e interés sin conexión.
IntegracionesTop, alcance en la red y economía de Vault.

Cada cambio se escribe en la base de datos al momento, se registra en este servidor y se anuncia a los demás servidores del mismo Redis, que reinstalan los comandos de las monedas. Si la base de datos rechaza una escritura ves "Could not save … to the database."

Comprueba que funciona#

Dame algo

Ejecuta /economyadmin give <tú> 500 <id>.

Léelo

Ejecuta /<id> (el comando que pusiste). Muestra tu saldo. /wallet lista todas las monedas que puedes usar.

Paga a alguien

/<id> pay <jugador> 100 envía 100.

Ir más allá#

Dale a una moneda su propio comando#

Cada moneda almacenada con comandos activados y al menos un nombre de comando recibe su propio comando, instalado en el momento en que se guarda y retirado cuando se desactiva. Para una moneda llamada shards:

/shards                              tu saldo
/shards <player>                     el de otro (necesita exyliaeconomy.others)
/shards pay <player> <amount>        pagar en shards (necesita exyliaeconomy.pay)
/shards top [page]                   su clasificación
/shards history [player]             su registro
/shards exchange <amount> <to>       cambiar shards por otra moneda
/shards give|take|set <player> <amount>   administradores
/shards reset <player>                    administradores

Necesita exyliaeconomy.use, más el permiso propio de la moneda si tiene uno. Un nombre que ya tiene otro plugin sigue respondiendo como /exyliaeconomy:<name>, y la consola lo avisa. Las monedas de ítem guardan nombres de comando en su pantalla, pero solo las almacenadas reciben un comando.

Haz una moneda solo para VIP#

En Reglas, escribe un permiso como economy.gems y dáselo al rango en tu plugin de permisos, ver Permisos. La pista del editor dice que es "necesario para usar sus comandos". Hace más: un jugador sin él no ve la moneda en su billetera ni en las sugerencias de comandos, no la recibe con /economyadmin giveall, no puede canjear sus billetes, no gana intereses en ella, y todos los comandos lo rechazan con "No puedes usar …". Los plugins que preguntan a ExyliaLib si un jugador puede usar una moneda obtienen la misma respuesta.

Añade un impuesto de transferencia#

En Reglas, pon el Impuesto de transferencia, en porcentaje entre 0 y 100. La pista del editor dice que "se retiene de cada transferencia". No es así: el receptor recibe la cantidad completa y el que paga abona el impuesto encima. /pay 100 con un impuesto del 5 % le cuesta 105 al que paga, y el impuesto no va a nadie. Ver Pagos.

Limita los saldos#

Saldo máximo es lo máximo que puede tener un saldo; -1, o cualquier valor no mayor que cero, significa ninguno. Un ingreso que lo superaría se rechaza entero, nunca se recorta: "Eso superaría el máximo del saldo, que es …", o "El saldo está en su máximo de …" cuando ya está ahí. Un pago rechazado así no le cobra nada al que paga.

Un cambio para un jugador que no está en este servidor se compara con el último saldo leído de él. Si aun así llega por encima del máximo (dos servidores le pagaron a la vez) se recorta al máximo al aplicarse: la parte de un pago que no cabía vuelve al que pagó, y cualquier otra cosa queda anotada en consola con la cantidad.

Diga lo que diga la moneda, ningún saldo puede superar 1018, el número más grande que cabe con holgura en la columna de la base de datos. -1 significa sin máximo propio de la moneda, no sin máximo en absoluto.

Tasas de cambio#

En Cambio, activa el interruptor y escribe las tasas como otro_id=tasa, separadas por comas: shards=0.01, gems=2 significa que 1 de esta moneda vale 0.01 shards y 2 gems. Una tasa debe ser un número positivo; cualquier otra cosa se rechaza indicando qué no se pudo leer. El destino puede ser cualquier moneda del servidor: almacenada, de ítem, de experiencia o de otro plugin.

Los jugadores ejecutan /economy exchange <amount> <from> <to>. Cambia según la tasa de la moneda de origen y necesita Cambio activado en el origen. Lo que se recibe es la cantidad, recortada a los decimales del origen, por la tasa, recortada a los decimales del destino. Solo se cobra lo que eso cuesta, así que la fracción que los decimales del destino redondean se queda con el jugador. Primero se cobra el origen, y si el destino lo rechaza se devuelve.

Decimales#

Toda cantidad se recorta a los decimales de la moneda antes de moverse: /pay Steve 10.567 en una moneda con dos decimales envía 10.56. Una moneda con 0 decimales solo admite números enteros, y una cantidad que se redondea a nada se rechaza por no ser una cantidad.

Los ítems y la experiencia viven en el jugador#

Una moneda de ítem o de experiencia solo tiene saldo mientras el jugador está en este servidor. Un pago a alguien que no está, o cuyo inventario está lleno, se guarda y se le entrega la próxima vez que entra con "Delivered N payments that were waiting for you." Quitarle a alguien que no está falla. Una moneda de ítem es el ítem entero (nombre, lore, modelo y encantamientos): solo cuenta una pila exactamente igual, y una copia renombrada es otro ítem.

Eliminar una moneda#

Clic derecho en ella en la lista de /economyadmin y confirma. Los saldos de una moneda almacenada se quedan en la base de datos, sin usar hasta que vuelva a existir una moneda con ese ID. Eliminar la moneda publicada en Vault la despublica.

El alcance en la red se bloquea cuando hay saldos

El alcance decide en qué filas viven los saldos, así que solo cambia mientras la moneda no tenga más que saldos iniciales: "… already holds balances, so it cannot switch between networked and per-server." Decídelo antes de que los jugadores ganen nada. Ver Red.

Ajustes de economía#

Ajustes de economía (abajo de la lista de monedas) son los interruptores que no pertenecen a ninguna moneda concreta. Son una fila en la base de datos, compartida por todos los servidores.

AjusteServidor nuevoQué hace
Niveles de experienciadesactivadoConvierte xp_levels en moneda.
Puntos de experienciaactivadoConvierte xp_points en moneda.
RegistroactivadoAnota cada movimiento de una moneda almacenada. Ver Registro.
Retención del registro90 díasRota entre 30, 90, 180, 365 días y para siempre. Las líneas más antiguas se borran cada hora.
Vault por encimaactivadoSirve Vault aunque haya otro plugin de economía instalado.
Economía de VaultdollarsQué moneda está publicada; se muestra aquí y se elige en la tarjeta Integraciones de una moneda almacenada.
Aviso de pagos sin conexiónactivadoAvisa al jugador al entrar de lo que le pagaron mientras no estaba.
Idiomael del servidorIdioma de los menús y mensajes del plugin; rota entre el del servidor, en, es, pt, fr, ru y tr. Ver mensajes e idiomas.
DepuracióndesactivadoHace que el registro del servidor explique qué hace el plugin.
Todos los campos de una moneda
CampoTiposMoneda nuevaQué hace
IDtodosse escribe al crearlaLa clave bajo la que se guardan los saldos.
IconotodosGOLD_INGOT; una moneda de ítem usa su ítemLo que dibujan las billeteras y las listas.
Nombre, pluraltodosvacíoUna unidad y varias. Admite colores, ver colores.
SímbolotodosvacíoVacío para ninguno.
Decimalestodos0; solo visual -1De 0 a 8. -1 en una moneda solo visual mantiene lo que diga el proveedor.
Formatotodos%amount% %name%%amount%, %symbol% y %name%.
Formato compactotodosvacíoLo mismo para scoreboards, donde %amount% se ve como 1.2k.
Nombres del comandoalmacenada, ítemel IDEl primero es el comando, el resto sus alias. Lo que no sea a-z, 0-9 o _ se descarta.
Ordentodosdespués de la últimaMenor se muestra primero, en billeteras, listas y en el selector de monedas de cualquier otro plugin.
Ítemítemse pide al crearlaEl ítem exacto.
Saldo inicialalmacenada0Con lo que empieza un jugador la primera vez que se le crea un saldo.
Saldo máximoalmacenada-1Lo máximo que puede tener un saldo.
PermisoalmacenadavacíoNecesario para ver y usar la moneda en absoluto.
Mínimo que un jugador puede enviaralmacenada1El mínimo de /pay.
Impuesto de transferenciaalmacenada0Un porcentaje, de 0 a 100, que se cobra al que paga además de la cantidad.
Tasas de cambioalmacenadaningunaotro_id=tasa.
TransferenciasalmacenadaactivadoSi los jugadores pueden pagarse entre sí.
CambioalmacenadadesactivadoSi se puede cambiar según sus tasas.
TopalmacenadaactivadoSi funcionan su top, su posición y su dinero en circulación. Ver Clasificaciones.
Alcance en la redalmacenadaglobalTodos los servidores, el grupo de red del servidor, o cada servidor por separado. Un clic los recorre.
ServidoresalmacenadatodosGrupos o IDs de servidor donde existe la moneda; vacío es todos. Un servidor excluido no tiene su comando, ni Vault, ni saldo.
Confirmación de pagoalmacenada0Un /pay por encima pregunta primero; 0 nunca.
BilletesalmacenadadesactivadoSi /withdraw imprime billetes de ella. Ver Billetes.
InterésalmacenadaningunoTasa, intervalo, tope y pago sin conexión. Ver Intereses.
Comandos activadosalmacenadaactivadoSi sus nombres de comando existen siquiera.
Economía de VaultalmacenadadesactivadoSi es la moneda publicada en Vault. Ver Vault.

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