Mercado, subastas y pedidos

Tres módulos permiten que los jugadores comercien sin tener que coincidir. El mercado vende al precio que pone el vendedor, la casa de subastas vende a quien más puja y los pedidos le dan la vuelta: el comprador paga primero y los vendedores le van entregando.

Cada uno tiene su propio interruptor en modules de config.yml (market, auctions, orders) y los tres vienen activados. Todos necesitan una economía. Sin ella el módulo carga igual, deja un aviso en el log y rechaza cualquier venta, puja o pedido.

Lo que tienen en común

Cualquier moneda. Un precio puede ir en cualquier moneda registrada en el servidor, con la moneda por defecto la primera. Si el jugador no indica la moneda en el comando y hay más de una, se abre un selector (menus/currency_select.yml). Con una sola moneda no se pregunta nada. Las monedas se explican en Economía.

El objeto sale de la mano. Anunciar o subastar se lleva de golpe todo el stack de la mano principal. Si falla la escritura en la base de datos, el stack y la comisión vuelven.

La entrega nunca tira nada al suelo. Lo que entregan estos módulos (una compra, una subasta ganada, un anuncio caducado, un pedido servido) pasa por el almacén de recompensas del plugin. Lo que no cabe en el inventario, y lo que se le debe a un jugador desconectado, se guarda y se le entrega en su próxima conexión.

Los límites salen de permisos. Se aplica el límite por jugador configurado, salvo que el jugador tenga un permiso numerado: entonces manda el número más alto que tenga. Un límite configurado de 0 o menos significa sin límite, y los menús muestran ∞.

Comisiones e impuestos son porcentajes. Se redondean a dos decimales y después a la precisión propia de la moneda. Los precios de los ajustes (min-price, max-price, broadcast-above) son números sin moneda y se comparan con el precio en la moneda en que se puso.

Los anuncios globales solo cuentan en la moneda por defecto. Una venta del mercado o una subasta ganada a partir de broadcast-above se anuncia al servidor solo si el precio estaba en la moneda por defecto, porque 100 gemas y 100 monedas no son la misma cantidad. Cada jugador puede desactivar los anuncios del mercado y de las subastas en /settings. Ver Utilidades.

Mercado

exyliasurvivalcore.market abre el mercado, exyliasurvivalcore.market.sell hace falta para anunciar y exyliasurvivalcore.market.admin cubre /marketadmin. Los comandos de administración solo los puede usar un jugador, no la consola.

Anunciar

Sujeta el objeto y usa /market sell, o pulsa Sell what you hold en el tablón o en tus anuncios. El botón pregunta la moneda y después el precio por el chat.

Un anuncio se rechaza si el material está en blocked-materials, si el objeto está dañado y allow-damaged-items está desactivado, si el precio queda fuera de min-price y max-price, o si el jugador ya está en su límite. Después se cobra la comisión de anuncio, un porcentaje del precio pedido. No se devuelve ni cuando el anuncio caduca ni cuando se retira, y eso es lo que impide usar el mercado como almacén gratis.

Comprar

Al hacer clic en un anuncio se abre una confirmación con el total, el precio por unidad, la moneda y el saldo del comprador antes y después. Al confirmar se cobra primero y luego se reclama el anuncio. Si otro jugador llegó antes, el dinero vuelve en el acto.

El vendedor cobra el precio menos sales-tax-percent, esté conectado o no, y el stack se entrega al comprador. allow-self-purchase viene desactivado: para recuperar un anuncio propio está retirarlo.

Caducidad y retirada

Un anuncio dura listing-hours. Con 0 o menos no caduca nunca. Los anuncios caducados desaparecen del tablón y ya no se pueden comprar. Una comprobación cada minuto los devuelve al vendedor, que recibe un aviso si está conectado. Los que caducaron con el servidor apagado vuelven igual cuando arranca.

Hacer clic en un anuncio dentro de My listings lo retira.

Mirar dentro

Una caja de shulker o un bundle con algo dentro se dibuja con su propia plantilla. Haz shift-clic sobre él en el tablón o en tus anuncios, o usa Look inside en la confirmación, para abrirlo. Una caja dentro de la caja se abre igual, y Back sube un nivel cada vez. La pantalla muestra una copia: no se puede sacar nada y mirar no compra nada. preview.container-hint es el lore que se añade a un contenedor dibujado dentro de la vista, con %items%.

El lore de cada anuncio describe además el stack: su tamaño, cuántos objetos lleva dentro, sus encantamientos (también los guardados en un libro encantado) y, si el módulo de tienda compra ese objeto, lo que la tienda paga por unidad.

El tablón

Search filtra por material, nombre del vendedor o nombre del objeto, hasta 32 caracteres. Clic derecho lo borra. Order alterna entre más nuevos, más baratos y más caros. La búsqueda y el orden se olvidan cuando el jugador sale.

Van en settings dentro de modules/market/config.yml. sounds define listed, bought, sold y cancelled.

Subastas

exyliasurvivalcore.auctions abre la casa de subastas, exyliasurvivalcore.auctions.sell hace falta para subastar y exyliasurvivalcore.auctions.admin cubre /auctionadmin, que solo puede usar un jugador.

Abrir una subasta

En el comando, las horas van antes del precio de compra inmediata. Sin horas se usa default-hours, y un precio de compra inmediata de 0 significa que no hay. Auction what you hold pregunta la moneda y luego abre un formulario con el precio de salida, un precio de compra inmediata opcional y las horas.

Una subasta se rechaza si el material está bloqueado, si el objeto está dañado y allow-damaged-items está desactivado, si la salida está por debajo de min-start-price, si la compra inmediata no supera la salida, si las horas quedan fuera de min-hours y max-hours, o si el jugador está en su límite. La comisión es un porcentaje del precio de salida y no se devuelve, aunque nadie puje.

Pujar

La primera puja tiene que llegar al menos al precio de salida. A partir de ahí, cada puja tiene que superar la más alta en min-bid-increment-percent de ella o en min-bid-increment, lo que sea mayor.

Al hacer clic en una subasta se abre la pantalla de puja:

• Bid hace exactamente la siguiente puja válida.
• Bid another amount acepta una cantidad escrita, desde la siguiente puja válida hasta la compra inmediata.
• Buy it now solo aparece si la subasta tiene precio de compra inmediata.

Una puja queda retenida. El dinero sale del pujador al pujar y se queda en la subasta. Si alguien le supera, le vuelve al momento, esté conectado o no. Subir tu propia puja funciona igual: recuperas la cantidad anterior y queda retenida la nueva. Nadie puede pujar en su propia subasta.

Una puja que alcanza el precio de compra inmediata cuenta como compra inmediata, y el comprador paga ese precio.

Anti-snipe

Una puja hecha con menos de anti-snipe-seconds restantes retrasa el final hasta esos segundos contados desde la puja, para que la última palabra no sea de quien hizo clic el último. 0 lo desactiva.

Cómo termina una subasta

Las subastas se comprueban cada segundo.

Los objetos llegan al ganador por el almacén de recompensas, así que un ganador desconectado los recibe en su próxima conexión.

El tablón

Cada subasta se dibuja con una de tres plantillas de modules/auctions/menus/auctions.yml: item para una en la que puedes pujar, leading para una que vas ganando y mine para las tuyas, que al hacer clic abre My auctions. Sort alterna entre las que terminan antes (por defecto), más nuevas, más baratas y más caras, según el precio actual. Search funciona igual que en el mercado. El lore indica lo que hay dentro de una caja de shulker o un bundle, pero las subastas no tienen pantalla para mirar dentro.

Van en settings dentro de modules/auctions/config.yml. sounds define listed, bid, outbid, won, sold y cancelled.

Pedidos

exyliasurvivalcore.orders abre los pedidos, exyliasurvivalcore.orders.create hace falta para crear uno y exyliasurvivalcore.orders.admin cubre /ordersadmin.

Crear un pedido

Sujeta una unidad del objeto que quieres. Pasa a ser la plantilla del pedido: los vendedores tienen que entregar objetos idénticos, con el mismo nombre, encantamientos y demás datos. La cantidad es cuántas unidades quieres, de 1 a max-amount, y el precio es por todas ellas. Order what you hold pregunta la cantidad, la moneda y luego el precio.

El precio completo más creation-fee-percent se cobra por adelantado. La comisión nunca se devuelve. No se pueden pedir materiales bloqueados ni objetos dañados; los pedidos no tienen ajuste para permitirlos. Solo cuentan para el límite los pedidos que aún aceptan objetos, así que uno terminado a la espera de recoger no cuenta.

Llenar un pedido

Cualquiera puede vender a un pedido abierto, y el comprador no tiene que estar conectado. El tablón muestra primero los pedidos que mejor pagan por unidad. Al hacer clic en uno se ve cuántos objetos iguales llevas, cuántos se van a vender y cuánto vas a ganar. Al confirmar se sacan de tu inventario y tu barra rápida (no de la mano secundaria, la armadura ni los contenedores), hasta lo que aún necesita el pedido, y se te paga al momento menos sales-tax-percent.

A un vendedor se le paga por las unidades que entrega, como esa parte del total redondeada hacia abajo. La última unidad liquida el resto, así que los pagos parciales siempre suman exactamente el precio del pedido. Si el pedido se llenó o se cerró mientras confirmabas, lo que ya no necesita vuelve a ti.

allow-self-fill viene desactivado.

Recoger, cerrar y caducar

Los objetos entregados esperan en el pedido. En My orders, clic izquierdo recoge todo lo que quepa en el inventario y el resto sigue listo para más tarde. Clic derecho cierra el pedido: no admite más objetos, se devuelve la parte del precio que aún no se ha pagado a vendedores y lo ya entregado se puede seguir recogiendo.

Un pedido dura order-hours. Con 0 o menos no caduca nunca. Cada minuto, los pedidos caducados se cierran y se reembolsan igual, y el comprador recibe un aviso si está conectado. Un pedido se borra en cuanto está cerrado o completo y ya no queda nada por recoger.

Van en settings dentro de modules/orders/config.yml.

Entre servidores

Los pedidos están hechos para varios servidores con una misma base de datos. Cada cambio en un pedido toma una fila de bloqueo que solo un servidor puede tener a la vez, y lee el pedido recién sacado de la base de datos. Los demás servidores actualizan su copia cuando un pedido cambia. Un jugador que toca un pedido que otro servidor está modificando ve "Somebody else is using that order right now" tras unos dos segundos de reintentos.

Menús

En el registro y en los contadores

Cada movimiento de dinero lleva un motivo en el registro de la economía:

También alimentan los contadores que miden las misiones y temporadas: