AxoStudio

AxoSell

AxoSell es un sistema completo de economía para servidores Paper: venta directa de ítems, menú de venta, mercado entre jugadores, tienda del servidor, ChestShops, mercado negro, subastas, logs, SellWands y placeholders.

Plataforma

Paper 1.21.11+ / 26.1.2+

Compatibilidad

Paper y Folia

Java Requerido

Java 25+

Autor

AxoStudio

Qué resuelve

Permite vender ítems por comando, por inventario completo o desde una GUI.
Incluye mercado entre jugadores con publicaciones, compras, cancelaciones y recolección de pagos.
Permite crear una tienda del servidor con categorías, productos, stock, permisos y límites.
Incluye ChestShops de jugadores con holograma, vitrina de cristal e ítem flotante del producto.
Agrega mercado negro con rotación de ofertas, probabilidades, horarios y vitrinas físicas.
Incluye subastas con pujas, historial, recolección de ganancias y notificaciones.

Integraciones opcionales

Plugin	Uso en AxoSell
Vault	Economía principal para compras, ventas, mercado, tienda, mercado negro y subastas.
PlaceholderAPI	Expone placeholders de precios, estadísticas, comandos, mercado negro y última compra.
ExcellentEconomy	Permite usar monedas virtuales específicas en mercado y mercado negro.
zMenu	Permite usar acciones de compra de AxoSell desde menús de zMenu y mostrar la última transacción.

Comandos base

Comando principal: /axosell.
Aliases principales: /asell y /sell.
Los subcomandos, aliases y comandos directos se pueden ajustar desde config.yml.
Los placeholders de comandos ayudan a mostrar rutas correctas aunque cambies nombres en configuración.

Monedas soportadas

Modo	Descripción
`VAULT`	Usa la economía del servidor conectada a Vault.
`ITEM`	Usa un ítem físico como moneda, con opción de comparar metadata exacta.
`EXCELLENT_ECONOMY`	Usa una moneda registrada en ExcellentEconomy, por ejemplo `coins`.

Módulos principales

Cada sistema puede activarse o desactivarse desde modules en config.yml.

Módulo	Uso
`sell-system`	Venta del ítem en mano y venta total del inventario usando precios configurados.
`sell-gui`	Menú de venta con confirmación y desglose de ítems vendibles.
`sell-wands`	Herramientas para vender contenido de contenedores con usos y multiplicador.
`market-system`	Mercado entre jugadores con publicaciones, búsquedas, compras y recolección.
`shop`	Tienda del servidor con categorías, productos, stock, permisos y límites.
`chest-shop`	Tiendas físicas sobre cofres, barriles o shulkers con menú y displays.
`catalogos`	Menús de catálogo configurables para mostrar productos, bloques o secciones informativas.
`black-market`	Mercado negro con ofertas rotativas, horarios, chances, compra directa y vitrinas.
`auction-system`	Subastas entre jugadores con pujas, límites, historial y cobro de ganancias.
`sale-logs`	Historial de operaciones del jugador mostrado en menú.
`placeholders`	Expansión PlaceholderAPI y placeholders internos para menús y mensajes.

Precios de productos

Los precios de venta y compra se leen desde prices.yml.
Un producto puede tener precio de venta, precio de compra o ambos.
Se aceptan materiales normales, CustomModelData y pociones específicas.
Formatos útiles de producto: DIAMOND, DIAMOND#1001 y POTION:INVISIBILITY.

Almacenamiento

La configuración se mantiene en archivos YAML para comandos, menús, idioma, módulos y opciones visuales.
Las operaciones dinámicas del mercado, subastas, tienda, ChestShop y estadísticas se guardan en base de datos local.
El archivo predeterminado de base de datos es database/axosell.db.
El plugin conserva metadata de ítems en sistemas donde el ítem exacto importa.

Idiomas y menús

Idiomas incluidos: es_ES, en_US y ru_RU.
Los menús están separados por sistema: venta, mercado, tienda, ChestShop, mercado negro, subastas y logs.
Los textos pueden usar formato de color y placeholders internos según el contexto del menú.
El idioma por defecto y el fallback se ajustan desde la configuración principal.

Venta directa

/axosell sell vende una unidad del ítem en mano.
/axosell sell <cantidad> vende una cantidad específica del ítem en mano.
El sistema usa el precio de venta configurado para ese producto.
Si el producto no tiene precio, la venta se rechaza con el mensaje configurado.

Venta del inventario

/axosell sellall vende todos los ítems del inventario que tengan precio.
Los ítems sin precio no se eliminan ni se cobran.
Aliases incluidos: /axosell sellinventory y /axosell vendertodo.
El pago máximo por acción puede limitarse desde la sección sell.

SellGUI

/axosell sellgui abre el menú de venta.
El comando directo /sellgui está activado por defecto.
Alias directo incluido: /vender.
La GUI puede usar menú de confirmación, acción de cancelar y acción de volver.

SellWands

Las SellWands venden contenido de contenedores compatibles al interactuar con ellos.
Los tipos incluidos por defecto son premium y unlimited.
Las varitas pueden tener usos limitados, multiplicador y permiso por tipo.
Los jugadores necesitan permiso de uso y, si aplica, permiso específico del tipo de varita.

Mercado entre jugadores

/axosell market abre el mercado principal.
El comando directo /market y el alias /mercado están activos por defecto.
Los jugadores publican el ítem de la mano con /axosell market sell <precio>.
También funciona /axosell market list <precio>.

Operaciones

Acción	Resultado
`buy <id>`	Compra una publicación por su ID.
`cancel <id>`	Cancela una publicación propia y deja el ítem pendiente para recolectar.
`collect` / `claim`	Recolecta pagos de ventas, ítems cancelados o publicaciones expiradas.
`mine`	Abre el menú de publicaciones del jugador.
`search`	Abre el menú de búsqueda.

Límites y economía

Precio mínimo por defecto: 10.
Precio máximo por defecto: 1,000,000.
Las publicaciones expiran por defecto después de 72 horas.
La comisión predeterminada es 5%.
El límite base es de 5 publicaciones activas por jugador.
Los límites personalizados usan permisos como axosell.market.limit.10.

Moneda del mercado

/axosell market currency abre el menú de moneda.
/axosell market currency set guarda el ítem en mano como moneda física.
/axosell market currency vault vuelve al modo Vault.
/axosell market currency info muestra la moneda actual y un ejemplo de precio.

Tienda del servidor

/axosell shop abre la tienda principal.
/shop y /tienda están disponibles como comandos directos por defecto.
/axosell shop <categoría> abre una categoría concreta.
La tienda puede tener categorías, productos, permisos, stock, precios de compra y precios de venta.

Controles de compra y venta

Click	Acción predeterminada
Click izquierdo	Comprar.
Click derecho	Vender.
Shift + click izquierdo	Compra rápida.
Shift + click derecho	Venta rápida.

Administración de tienda

/axosell shopadmin abre el menú administrativo.
/axosell shopadmin createcategory <id> [slot] [nombre] crea una categoría.
/axosell shopadmin addproduct <categoría> <compra> <venta> [slot] agrega el ítem de la mano como producto.
Aliases incluidos: shop-admin y tiendaadmin.

Integración con zMenu

AxoSell registra acciones de zMenu para comprar productos desde botones externos.
La acción axosell-buy compra un producto concreto usando su ID y cantidad.
La acción axosell-buy-last repite la última compra exitosa del jugador.
Los IDs pueden ser materiales, CustomModelData o pociones específicas: DIAMOND, DIAMOND#1001, POTION:INVISIBILITY.
La última compra puede mostrarse con placeholders de AxoSell o con Player Data de zMenu si esa sincronización está disponible.

Tiendas físicas

ChestShop permite convertir contenedores en tiendas de jugadores.
Bloques permitidos por defecto: CHEST, TRAPPED_CHEST, BARREL y SHULKER_BOX.
Los jugadores pueden comerciar desde el menú de la tienda física.
Los administradores pueden gestionar tiendas ajenas con permiso administrativo.

Creación y gestión

Por defecto, el jugador puede crear una tienda con Shift + click derecho y mano vacía sobre un contenedor.
/axosell chestshop create crea una tienda mirando al contenedor.
/axosell chestshop open abre el navegador de tiendas.
/axosell chestshop mine muestra tiendas propias.
/axosell chestshop remove elimina la tienda que el jugador está mirando.

Displays y vitrina

El holograma muestra nombre de tienda, producto, precio de compra y precio de venta.
El display puede mostrar el primer producto configurado como ítem flotante.
La vitrina de cristal se controla desde chest-shop.displays.showcase.
El material de cristal predeterminado es GLASS.
Altura, escala, rango de vista, brillo, fondo y cantidad de líneas son configurables.

Límites y seguridad

Límite base por jugador: 10 tiendas.
Límite base de productos por tienda: 3.
Permisos dinámicos: axosell.chestshop.shops.25 y axosell.chestshop.products.10.
Las tiendas pueden protegerse contra explosiones.
La interacción remota está desactivada por defecto y la distancia máxima predeterminada es 8 bloques.

Funcionamiento

/axosell blackmarket abre el mercado negro si el jugador tiene permiso.
Aliases incluidos: bm y mercadonegro.
Las ofertas pueden rotar por horario, usar probabilidades y mostrarse en un menú configurable.
Cuando el mercado está cerrado, los placeholders de oferta no revelan nombre ni precio real del ítem.

Horario predeterminado

Abre cada 1440 minutos por defecto.
Permanece abierto 60 minutos por ciclo.
Mientras está abierto, rota ofertas cada 20 minutos.
Si la duración de apertura se define en 0, puede funcionar como mercado siempre abierto.

Items y chances

/axosell blackmarket additem <precio> [chance|preset] agrega el ítem de la mano.
/axosell blackmarket chance <id> <chance|preset> cambia la probabilidad de un producto.
Presets incluidos: comun, poco-comun, raro, epico y legendario.
Con rotación aleatoria activada, los productos con chance mayor a 0 se seleccionan sin repetir dentro de la ronda.

Administración y vitrinas

/axosell blackmarket admin abre el menú administrativo.
/axosell blackmarket listchat muestra los productos configurados en chat.
/axosell blackmarket open [tiempo] fuerza apertura manual.
/axosell blackmarket close [tiempo] fuerza cierre manual.
/axosell blackmarket auto vuelve al horario automático.
/axosell blackmarket setshowcase <slot> crea una vitrina mirando un bloque.
/axosell blackmarket clearshowcase <slot> elimina una vitrina.
/axosell blackmarket refresh refresca estado, ofertas y displays.

Subastas entre jugadores

/axosell auction abre el menú de subastas.
Aliases incluidos: subasta y auctions.
/axosell auction sell <precio> <minutos> subasta el ítem de la mano.
/axosell auction bid <id> [cantidad] puja una subasta activa.

Operaciones

Acción	Resultado
`list`	Abre la lista de subastas.
`sell <precio> <minutos>`	Crea una subasta con el ítem en mano.
`bid <id> [cantidad]`	Puja una cantidad o la puja mínima si no se indica monto.
`cancel <id>`	Abre la confirmación para cancelar una subasta propia.
`collect` / `claim`	Recolecta dinero o ítems pendientes.
`bids <id>` / `info <id>`	Abre el historial de pujas.

Límites predeterminados

Precio inicial mínimo: 10.
Precio inicial máximo: 1,000,000.
Puja máxima predeterminada: 1,000,000.
Incremento mínimo de puja: 1.
Duración mínima: 5 minutos.
Duración máxima: 1440 minutos.
Límite base: 2 subastas activas por jugador.
Permisos dinámicos: axosell.auctions.limit.7, axosell.auctions.limit.10 y valores similares.

Notificaciones

Puede avisar al vendedor cuando alguien puja.
Puede avisar al jugador superado por otra puja.
Puede avisar al ganador y al vendedor al finalizar.
Los métodos configurables incluyen chat, actionbar, title y sonido.

Comandos principales

Comando	Permiso	Descripción
`/axosell`	`axosell.player.use`	Abre ayuda o menú principal según configuración y contexto.
`/axosell help`	`axosell.player.use`	Muestra ayuda de comandos disponibles.
`/axosell sell [cantidad]`	`axosell.player.sell`	Vende el ítem de la mano.
`/axosell sellall`	`axosell.player.sellall`	Vende los ítems vendibles del inventario.
`/axosell sellgui`	`axosell.player.sellgui`	Abre el menú de venta.
`/axosell sellwand [tipo] [jugador]`	`axosell.admin.sellwand.give`	Entrega una SellWand.
`/axosell logs [página]`	`axosell.player.logs`	Abre el historial personal de operaciones.
`/axosell reload`	`axosell.admin.reload`	Recarga configuración, idiomas, menús y servicios del plugin.

Mercado

Comando	Descripción
`/axosell market`	Abre el mercado.
`/axosell market sell <precio>`	Publica el ítem de la mano.
`/axosell market list <precio>`	Alias para publicar.
`/axosell market buy <id>`	Compra una publicación.
`/axosell market cancel <id>`	Cancela una publicación propia.
`/axosell market collect` / `claim`	Recolecta pagos e ítems pendientes.
`/axosell market mine`	Abre tus publicaciones.
`/axosell market search`	Abre búsqueda del mercado.
`/axosell market currency`	Administra la moneda del mercado.

Shop, ChestShop y catálogos

Comando	Descripción
`/axosell shop`	Abre la tienda del servidor.
`/axosell shop <categoría>`	Abre una categoría concreta.
`/axosell shopadmin`	Abre el menú administrativo de tienda.
`/axosell shopadmin createcategory <id> [slot] [nombre]`	Crea una categoría.
`/axosell shopadmin addproduct <categoría> <compra> <venta> [slot]`	Agrega el ítem de la mano como producto.
`/axosell chestshop`	Abre el navegador de ChestShops.
`/axosell chestshop create`	Crea una tienda mirando un contenedor.
`/axosell chestshop mine`	Muestra tiendas propias.
`/axosell chestshop remove`	Elimina la tienda que estás mirando.
`/axosell catalogo [menú]`	Abre el catálogo principal o un catálogo específico.

Mercado negro y subastas

Comando	Descripción
`/axosell blackmarket`	Abre el mercado negro.
`/axosell blackmarket open [tiempo]`	Fuerza apertura.
`/axosell blackmarket close [tiempo]`	Fuerza cierre.
`/axosell blackmarket auto`	Vuelve al horario automático.
`/axosell blackmarket time <refrescoMin> [abiertoMin] [offsetMin] [aperturaCadaMin]`	Cambia horario.
`/axosell blackmarket additem <precio> [chance\|preset]`	Agrega el ítem en mano.
`/axosell blackmarket chance <id> <chance\|preset>`	Cambia probabilidad de aparición.
`/axosell blackmarket setshowcase <slot>`	Crea o actualiza una vitrina.
`/axosell auction sell <precio> <minutos>`	Crea una subasta.
`/axosell auction bid <id> [cantidad]`	Puja una subasta.
`/axosell auction collect` / `claim`	Recolecta resultados pendientes.

Grupos recomendados

Permiso	Default	Incluye
`axosell.player`	Manual	Uso base de jugador: vender, SellGUI, sellall, market, shop, ChestShop, catálogo, mercado negro, subastas, logs y uso de SellWand.
`axosell.admin`	OP	Todos los permisos de jugador y administración de recarga, SellWands, mercado, tienda, ChestShop, mercado negro y subastas.

Permisos de jugador

Permiso	Permite
`axosell.player.use`	Usar el comando base y ayuda.
`axosell.player.sell`	Vender el ítem en mano.
`axosell.player.sellgui`	Abrir el menú de venta.
`axosell.player.sellall`	Vender inventario completo.
`axosell.player.market`	Usar el mercado entre jugadores.
`axosell.shop.use`	Usar la tienda del servidor.
`axosell.chestshop.use`	Comprar y vender en ChestShops.
`axosell.chestshop.create`	Crear ChestShops propias.
`axosell.player.catalogo`	Abrir catálogos.
`axosell.player.blackmarket`	Usar el mercado negro.
`axosell.player.auction`	Usar subastas y pujas.
`axosell.player.logs`	Ver historial personal.
`axosell.player.sellwand.use`	Usar SellWands.
`axosell.player.sellwand.premium`	Usar el tipo premium de SellWand si está configurado.

Permisos administrativos

Permiso	Permite
`axosell.admin.reload`	Recargar AxoSell.
`axosell.admin.sellwand.give`	Entregar SellWands.
`axosell.admin.market`	Administrar moneda y acciones reservadas del mercado.
`axosell.shop.admin`	Abrir administración de Shop.
`axosell.shop.admin.categories`	Administrar categorías de Shop.
`axosell.shop.admin.products`	Administrar productos de Shop.
`axosell.shop.bypass.limits`	Omitir límites de transacción de Shop.
`axosell.chestshop.admin`	Administrar cualquier ChestShop.
`axosell.chestshop.bypass.limits`	Omitir límites de tiendas y productos en ChestShop.
`axosell.admin.blackmarket`	Administrar mercado negro.
`axosell.admin.auction`	Administrar acciones reservadas de subastas.

Permisos dinámicos y legacy

axosell.market.limit.<cantidad> cambia el límite de publicaciones activas del mercado.
axosell.auctions.limit.<cantidad> cambia el límite de subastas activas.
axosell.chestshop.shops.<cantidad> cambia el límite de ChestShops por jugador.
axosell.chestshop.products.<cantidad> cambia el límite de productos por ChestShop.
axosell.shop.category.<id> permite limitar acceso por categoría.
axosell.shop.product.<id> permite limitar acceso por producto.
Permisos legacy como axosell.use, axosell.sell, axosell.market, axosell.blackmarket, axosell.auction y axosell.reload siguen existiendo por compatibilidad.

PlaceholderAPI

Placeholders de AxoSell

Si PlaceholderAPI está instalado y el módulo de placeholders está activado, AxoSell registra la expansión axosell. También existen placeholders internos para menús, mensajes y acciones del plugin.

Precios Estadísticas Mercado negro Última compra

Generales y comandos

%axosell_prefix% %axosell_main_command% %axosell_market_command% %axosell_market_direct_command% %axosell_blackmarket_command% %axosell_black_market_command% %axosell_auction_command% %axosell_sellgui_command% %axosell_bid_command%

Precios

%axosell_buy_price_item% muestra el precio de compra del ítem en contexto.
%axosell_sell_price_item% muestra el precio de venta del ítem en contexto.
Para productos fijos, agrega el ID al final: %axosell_buy_price_DIAMOND%.
También funciona con CustomModelData y pociones: %axosell_sell_price_DIAMOND#1001% y %axosell_buy_price_POTION:INVISIBILITY%.

Estadísticas de jugador

%axosell_total_sales% %axosell_money_earned% %axosell_market_listings% %axosell_market_sales% %axosell_auction_wins% %axosell_auction_bids% %axosell_sellwand_uses% %axosell_sellwand_multiplier%

Mercado negro: estado

%axosell_black_market_time_left% %axosell_black_market_seconds_left% %axosell_black_market_next_refresh% %axosell_black_market_refresh_time_left% %axosell_black_market_open_time_left% %axosell_black_market_close_time_left% %axosell_black_market_next_open% %axosell_black_market_next_close% %axosell_black_market_status%

Mercado negro: ofertas y vitrinas

Ofertas activas usan %axosell_black_market_offer_<n>_item%, amount, price, price_display, chance y chance_percent.
Vitrinas físicas usan %axosell_black_market_showcase_<slot>_item%, amount, price, price_display, chance y chance_percent.
También existen aliases de compatibilidad con blackmarket, black_market, blankmarket y blank_market.

Última compra y zMenu

%axosell_last_transaction_type% %axosell_last_transaction_product_id% %axosell_last_transaction_item% %axosell_last_transaction_amount% %axosell_last_transaction_price% %axosell_last_transaction_material% %axosell_last_transaction_display_material% %axosell_last_transaction_potion% %axosell_last_transaction_potion_type% %axosell_last_transaction_is_potion%

Placeholders internos

Generales: %currency_symbol%, %page%, %max_page%.
Venta: %item_name%, %amount%, %unit_price%, %total_price%, %items_breakdown%, %remaining%, %multiplier%.
Mercado: %market_currency_mode%, %market_currency_name%, %market_price_example%, %market_collect_count%.
Subastas: %auction_id%, %seller%, %current%, %highest_bidder%, %time_left%.
Mercado negro admin: %black_market_item_id%, %price_display%, %chance_percent%, %active_status%.

Archivos y carpetas principales

Ruta	Uso
`config.yml`	Comandos, módulos, moneda, formatos, venta, market, shop, ChestShop, mercado negro y subastas.
`storage.yml`	Define el tipo de almacenamiento y la ubicación de la base de datos local.
`lang/`	Mensajes por idioma.
`menus/`	Menús de venta, mercado, tienda, ChestShop, mercado negro, subastas, logs y menú principal.
`catalogos/`	Catálogos configurables, como menú principal, bloques y minerales.
`sellwands/`	Tipos de SellWand y sus propiedades.
`database/axosell.db`	Datos persistentes del mercado, subastas, tienda, ChestShop, logs y estadísticas.

Opciones comunes

commands controla nombres, aliases y comandos directos.
modules activa o desactiva sistemas completos.
currency controla símbolo, formato y separadores numéricos.
languages y language controlan idioma por defecto, fallback y detección del cliente.
tab-complete controla sugerencias y visibilidad de comandos según permisos.

Market y subastas

market.min-price y market.max-price limitan precios de publicaciones.
market.expire-after-hours define vencimiento de publicaciones.
market.tax-percent aplica comisión de mercado.
auction.min-duration-minutes y auction.max-duration-minutes limitan duración de subastas.
auction.notifications controla avisos de puja, ganador, vendedor y subastas sin pujas.

Shop y ChestShop

shop.enabled activa la tienda del servidor.
shop.controls define compras, ventas y acciones rápidas por click.
chest-shop.allowed-blocks define contenedores permitidos para tiendas físicas.
chest-shop.creation controla creación por Shift + click derecho, mundos bloqueados, límites y costos.
chest-shop.displays controla holograma, texto, brillo, rango de vista, ítem flotante y vitrina de cristal.

Mercado negro

black-market.open-interval-minutes define cada cuánto vuelve a abrir.
black-market.refresh-minutes define cada cuánto rotan ofertas mientras está abierto.
black-market.open-duration-minutes define cuánto dura abierto.
black-market.chance-presets define presets como común, raro o legendario.
black-market.showcases guarda vitrinas configuradas desde el juego.

Notas prácticas

Usa placeholders de comando en mensajes y menús para no depender de nombres fijos.
Para permisos por límite, el valor numérico más alto suele ser el que conviene asignar al rango.
Si usas moneda física, guarda el ítem real desde el comando de moneda para conservar metadata.
En ChestShop, ajusta altura y escala del showcase si el cristal o el ítem quedan muy cerca del holograma.
Después de cambios importantes en menús, idioma o configuración, usa /axosell reload.