Economía

ExyliaLib habla con economías — Vault, PlayerPoints, cualquier cosa que registre un plugin — y no guarda ninguna propia. El módulo economy es donde viven las monedas del servidor: sus saldos, su historial, sus clasificaciones, la moneda que se entrega a Vault y todos los comandos que un jugador escribe sobre dinero. Apagarlo deja al servidor con la otra economía que tenga.

Monedas

Una moneda es una fila en sc_currencies, creada y editada en el juego con /economyadmin. No hay ningún archivo de monedas que editar.

Hay tres tipos:

La experiencia es una cuarta fuente, que se activa en los ajustes de economía en vez de crearse: xp_levels y xp_points pasan a ser ids de moneda en los que una tienda puede poner precios.

Una moneda de objeto o de experiencia solo tiene saldo mientras el jugador está en este servidor. Pagar a un jugador ausente deja el pago en cola para el próximo servidor que lo tenga; quitarle a un jugador ausente falla.

Una moneda de objeto es el objeto entero — nombre, lore, modelo y encantamientos — y solo cuenta un stack idéntico.

Qué tiene una moneda

Una moneda con permiso desaparece de la cartera, de las líneas de saldo de las pantallas de tienda y de las sugerencias de comandos para quien no lo tenga, y sus comandos lo rechazan.

Con qué empieza un servidor nuevo

La primera vez que las tablas están vacías, el módulo importa modules/economy/currencies.yml y lo renombra a currencies.yml.imported. Un servidor sin ese archivo pero con el que guardaba ExyliaLib antes de la 1.159.0, plugins/ExyliaLib/currencies.yml, copia ese primero, con sus cambios. Un servidor sin ninguno de los dos importa los valores por defecto:

Las dos monedas guardadas empiezan en 0, no tienen tope, permiten transferencias desde 1 sin impuesto y tienen el cambio apagado. Los puntos de experiencia son moneda, los niveles no, y el historial está activado.

Después de importarlo, el archivo no se vuelve a leer. Si en un arranque posterior sigue habiendo un currencies.yml, la consola lo avisa y lo ignora.

La moneda por defecto

Un comando que no nombra moneda — /balance, /pay, /baltop — usa la moneda por defecto de ExyliaLib, default-currency en plugins/ExyliaLib/economy.yml. Viene como vault: lo que sirva Vault, que en un servidor sin otro plugin de economía es dollars a través del puente de más abajo.

El puente con Vault

Una moneda guardada se puede publicar como la economía de Vault del servidor, así que todos los plugins que solo hablan Vault funcionan con ella. Se elige con Economía de Vault en la pantalla de esa moneda; elegir otra la sustituye, y borrar la moneda publicada la despublica.

Se registra por debajo de cualquier plugin de economía que haya instalado el dueño — EssentialsX, CMI — y solo sirve mientras no haya ninguno. Vault por encima en los ajustes de economía la registra por encima de ellos. La consola dice cuál de las dos pasó.

El puente no tiene cuentas de banco: toda llamada de banco responde no implementado. Un jugador nombrado por texto en vez de por UUID se busca entre los jugadores que ExyliaLib ha visto, y un nombre desconocido se rechaza. Sin Vault instalado no se publica nada y la consola avisa.

Saldos, jugadores desconectados y otros servidores

Los saldos guardados de un jugador se cargan al entrar, y el servidor en el que está es el único que los escribe. Cualquier otro servidor — o el mismo, para alguien que no está — deja el cambio en una cola y avisa a la red. El dueño lo aplica en el momento; si no, espera a su próxima entrada. Un repaso cada minuto recoge lo que se haya perdido un mensaje.

Los comandos de administración dicen "Queued … They are away; it lands when they are next seen" en vez de enseñar un saldo que no tienen.

Un ingreso que pasaría el tope solo paga hasta él, y uno con el tope ya alcanzado falla.

Los cambios de monedas hechos en un servidor se registran ahí al momento y los leen todos los demás de la red, que reinstalan también los comandos de moneda.

El historial

Con el historial activado (por defecto), cada operación sobre una moneda guardada escribe una línea en exylia_ledger: qué se movió, cómo quedó el saldo, el motivo, quién lo causó y qué servidor lo aplicó — incluidos los cambios que llegaron de otro servidor. Nada lo purga.

Otros plugins escriben sus propios motivos.

Comandos de jugador

Todo lo que es sobre otro jugador — un saldo, una cartera, un historial — necesita además exyliasurvivalcore.economy.others. Todos funcionan con un jugador desconectado o en otro servidor. Las cantidades se escriben como 100, 2.5k o 1m.

Un pago comprueba el interruptor de transferencias y el mínimo de la moneda, no deja pagarse a uno mismo, cobra el impuesto al que envía además de la cantidad y luego mueve la cantidad. Al que recibe se le avisa si está conectado.

Un cambio necesita Cambio activado en la moneda de origen y una tasa hacia la de destino, que puede ser cualquier moneda que exista. Primero se cobra el origen; si el ingreso falla, se devuelve.

Un comando por moneda

Cada moneda guardada con Comandos activados y al menos un nombre de comando tiene su propio comando, instalado en cuanto se guarda:

/shards                         tu saldo
/shards <jugador>               el de otro (necesita .others)
/shards pay <jugador> <cantidad>
/shards top [página]
/shards history [jugador]
/shards exchange <cantidad> <destino>
/shards give|take|set <jugador> <cantidad>   administradores
/shards reset <jugador>                      administradores

Necesita exyliasurvivalcore.economy. Un nombre que ya tiene otro plugin responde igualmente como /exyliasurvivalcore:<nombre>, y la consola lo avisa.

Las pantallas

Tres pantallas en modules/economy/menus/, escritas una vez y tuyas para editar:

El historial y la clasificación llegan a 90 entradas. La clasificación se lee de la base de datos como mucho una vez por minuto, así que el primer vistazo tras un arranque puede salir vacío hasta que llega esa lectura. Solo se clasifican las monedas guardadas con la clasificación activada, y solo ellas tienen historial; cualquier otra moneda abre una pantalla vacía.

Las acciones que hay detrás — survivalcore:economy_wallet [uuid], survivalcore:economy_history <moneda> [uuid] y survivalcore:economy_top <moneda> — se pueden poner en cualquier menú.

/economyadmin

/economyadmin — /ecoadmin, /eadmin — necesita exyliasurvivalcore.economy.admin.

import recorre todos los jugadores que el servidor ha visto alguna vez y suma su saldo de origen a destino. Ejecútalo una sola vez.

Las formas antiguas — /eco give, /eco take, /eco set, /eco reset, /eco import — siguen funcionando con el mismo permiso, porque los archivos de recompensas y cajas de servidores en marcha están escritos con ellas.

Las pantallas de administración

Crear pide un id, luego el tipo y — para una moneda de objeto — el objeto en sí. Los botones que enseña una moneda dependen de su tipo: una guardada tiene reglas e interruptores, una de objeto su objeto, una de solo apariencia solo su aspecto.

Borrar pregunta antes. Los saldos de una moneda guardada se quedan en la base de datos, sin uso hasta que vuelva a existir una moneda con ese id.

Cada cambio se escribe, se registra en este servidor al momento y se anuncia a los demás. Estos tres archivos se regeneran desde el plugin en cada arranque, así que los cambios en ellos no sobreviven.

El selector de moneda

menus/currency_select.yml es la única pantalla que usan todos los flujos para preguntar qué moneda: publicar en el mercado, empezar una subasta, poner una orden de compra y elegir la moneda en la que se pone el precio de un producto de la tienda. Cada moneda enseña su icono y lo que el jugador tiene de ella. Un servidor con una sola moneda nunca la ve: el flujo sigue con la única que hay.

%purpose% es la línea que escribe la pantalla que pregunta; cada moneda se dibuja con %currency%, %currency_icon% y %currency_balance%. El archivo se escribe una vez y es tuyo para editar.

Las líneas de saldo de las pantallas de tienda, mercado y subastas siguen la misma regla: todas las monedas que el jugador puede usar, una por línea.

Placeholders

Los saldos y las clasificaciones son los dos de este módulo; los saldos funcionan con cualquier moneda, guardada aquí o no.

Sin moneda se lee la moneda por defecto. Dejada en vault, la clasificación que se ordena es la de la moneda guardada que se publica en Vault. Las formas %exylialib_economy_…% ya no responden; consulta Placeholders.

Valores por defecto de economía baja

Los precios y pagos que vienen de serie están pensados para una economía baja, donde un bloque barato vale una unidad y nada cuesta miles. Una instalación nueva escribe estos; un servidor que ya tiene los archivos conserva sus números.

El catálogo de la tienda sigue dos reglas para no fabricar dinero: un producto se vende por más o menos un tercio de lo que cuesta, y cuando un producto se fabrica a partir de otro — troncos en tablones, trigo en heno — el resultado nunca se vende por más que sus ingredientes. El equipo se vende pero nunca se recompra.

Boosters

Un booster multiplica dinero o experiencia, para un jugador o para todos, durante un tiempo.

Misiones, recompensas por muerte, cultivo y votos pagan su money en la moneda por defecto, redondeado hacia abajo a sus decimales. El dinero que se da con un comando — eco give — no se multiplica.

Un booster de experiencia se aplica a toda la experiencia que el juego registra como ganada, orbes incluidos, venga de donde venga.

La fuente es texto libre: un booster dado para una fuente que no existe no multiplica nada.

Personales y globales

Un booster personal espera en /boosters hasta que su dueño lo empieza, así que se le puede dar a alguien desconectado o en otro servidor, que es lo que necesita una tienda web. Al jugador se le avisa cuando le llega uno.

Un booster global se anuncia en todos los servidores al empezar y al terminar, a todos los que tengan activados los anuncios de boosters en /settings. /boostersadmin clear termina todos los boosters globales en marcha sin anunciarlo.

El multiplicador tiene que pasar de 1 y no superar 100. La duración se escribe 30m, 2h, 1d; un número solo son segundos, y también valen s y h. Sin fuente es *.

Cómo se suman

Cuentan todos los boosters en marcha de un tipo que se apliquen a un pago: los del jugador y los globales juntos.

settings:
  stacking: ADD
  max-multiplier: 5.0
  one-per-type: true
bossbar:
  config:
    text: "{highlight}⚡ {primary}&lBOOSTERS {letters_black}» {success}Money x%money% {letters_black}· {info}XP x%xp% {letters_black}» {letters}%left%"
    colour: PURPLE
    overlay: PROGRESS

Cualquier otro valor se lee como ADD. El resultado nunca baja de x1 ni pasa de max-multiplier; 0 quita el tope.

one-per-type impide que un jugador empiece un segundo booster personal de un tipo mientras otro está en marcha. Los globales no cuentan.

La barra de jefe se muestra mientras algún booster se aplique al jugador, llenándose con el tiempo que le queda al que termina más tarde. En su texto funcionan %money%, %xp%, %left% y %count%; un texto vacío la oculta.

Comandos, permisos y placeholders

/boosters lista los boosters globales en marcha y luego los del jugador: primero los que están en marcha, después los que esperan. Su pantalla es modules/boosters/menus/boosters.yml.

Varitas de venta

El módulo sell-wands necesita la tienda: sus dos funciones venden a precios de tienda, así que se aplican la bonificación exyliasurvivalcore.shop.sell.<multiplicador> del jugador, los boosters de dinero de shop-sell, los permisos de producto y categoría, y los límites de venta de la tienda. Ver Tienda.

La varita

Una varita lleva en el objeto un multiplicador y un número de usos, y un id propio para que dos varitas nunca se apilen.

/sellwandadmin give <jugador> <multiplicador> <usos>

/sellwanda para abreviar, con exyliasurvivalcore.sellwands.admin. El jugador tiene que estar conectado. El multiplicador va de 0.1 a 10; los usos son -1 para ilimitados o cualquier número mayor que 0.

Hacer clic derecho en un contenedor con una varita en la mano principal vende lo que la tienda compra de dentro, al precio de tienda por el multiplicador de la varita. Todo lo demás, y el resto de una unidad, se queda donde está. Necesita exyliasurvivalcore.sellwands.use, y un clic que un plugin de protección ya ha rechazado se deja en paz, así que una varita nunca mete la mano en un cofre que su dueño no podría abrir.

Solo se gasta un uso cuando se ha vendido algo; el último rompe la varita.

Autoventa

Con exyliasurvivalcore.sellwands.autosell, lo que rompe un jugador se vende por él: los bloques rotos a mano, y tanto lo que sueltan los bloques como el loot de las minas. Solo se cogen los drops que compra la tienda; lo demás cae como siempre.

Los drops esperan unos segundos y se venden juntos, al precio de tienda sin más. Lo que la tienda rechace para entonces — un límite de venta alcanzado — vuelve al jugador. Salir del servidor vende antes lo que está esperando. Cada cierto tiempo se le dice al jugador cuánto ha sacado.

/autosell la activa y desactiva, el mismo interruptor que en /settings. Viene activada para todo el que tenga el permiso.

Configuración

modules/sell-wands/config.yml:

Los dos temporizadores de autoventa se programan una sola vez, al arrancar el plugin: cambiarlos necesita reiniciar.