Plugin de Minecraft AuctionHouse

🔌 Acerca de AuctionHouse

AuctionHouse es un plugin de Minecraft que añade una casa de subastas dentro del juego, accesible con el comando /ah. Los jugadores pueden publicar objetos a la venta, explorar y buscar listados, y comprar objetos a través de un mercado basado en GUI. El plugin se centra en el comercio entre jugadores, con reglas de publicación, tasas y anuncios configurables.

🎯 Propósito

AuctionHouse ofrece un mercado centralizado y gestionado mediante GUI para que los servidores puedan disponer de un sistema de subastas administrado en lugar de depender de tiendas creadas por jugadores o mercados basados en carteles. Está pensado para servidores que quieren un mercado público con búsqueda, restricciones configurables e integración con la economía.

⚙️ Funcionalidades

• Casa de subastas en GUI abierta con /ah.
• Crear y cancelar anuncios; recoger objetos cancelados o caducados.
• Buscar y filtrar anuncios por nombre, tipo, lore, enchants o vendedor.
• Ordenar anuncios por tiempo o precio.
• Controles de publicación: definir precios mínimos/máximos, tasas de publicación (fijas y/o porcentuales), impuesto al vendedor con límite y enfriamiento entre publicaciones.
• Restricciones de objetos por nombre, tipo, lore, encantamientos, daño, bandera unbreakable, custom_model_data y patrones regex.
• Opción para publicar objetos del servidor (anuncios únicos o ilimitados).
• Activadores especiales para abrir la subasta mediante carteles, entidades de bloque con nombre (cofres, shulkers, dispensadores, etc.) o entidades con nombre personalizado.
• Los tooltips al pasar el cursor muestran el tiempo restante y los enchants.
• Anuncios opcionales para nuevos listados e integración con Discord.
• Compatibilidad con internacionalización y mensajes, materiales y sonidos configurables.
• Registro de transacciones en un archivo de log separado y limpieza automática de objetos abandonados.

🧩 Para quién es

• Servidores Survival y SMP que quieren un mercado compartido entre jugadores.
• Servidores centrados en la economía que quieren una GUI de subastas con búsqueda.
• Administradores que necesitan reglas de publicación, tasas y restricciones de objetos configurables.

🏗️ Casos de uso de ejemplo

• Los jugadores publican botín sobrante y lo subastan a la comunidad del servidor en lugar de usar cofres o tiendas.
• El personal del servidor crea anuncios limitados o ilimitados de objetos ofrecidos por el servidor.
• Los administradores aplican las reglas de la economía del servidor restringiendo ciertos objetos o aplicando impuestos de publicación.

⌨️ Comandos

🔐 Permisos

⚙️ Instalación

📥 Configuración

• Descarga el archivo oficial .jar del plugin y colócalo en el directorio plugins/ de tu servidor para servidores compatibles con Spigot.
• Reinicia el servidor (reinicio completo) y revisa la consola para confirmar que el plugin se cargó.
• Configura el plugin usando los archivos de configuración proporcionados según sea necesario.

📦 Dependencias

• Vault (obligatorio, se recomienda 1.7.1+).
• Un plugin de economía adecuado (por ejemplo, EssentialsX economy u otro proveedor de economía compatible con Vault).
• Un plugin de permisos adecuado (si usas permisos más allá de los predeterminados).

🧠 Notas técnicas

• Almacenamiento: el plugin usa SQLite (no se documenta soporte para base de datos externa).
• El plugin registra transacciones en un archivo de log separado y admite internacionalización.
• Compatible con cabezas de HeadDatabase y texturas de calaveras personalizadas como botones de GUI.
• El autor indica que las funciones y la compatibilidad de versiones están orientadas a Spigot; el comportamiento puede variar en otro software de servidor.

🤝 Cuándo es útil este plugin

Si quieres un sistema de subastas configurable, basado en GUI e integrado con la economía de tu servidor y Vault, AuctionHouse ofrece controles de publicación, búsqueda/filtro, tasas/impuestos y registro de transacciones para proporcionar un mercado de jugadores manejable.