Plugin de Minecraft zAuctionHouse

🔌 Acerca de zAuctionHouse

zAuctionHouse es un plugin de Minecraft que implementa una casa de subastas completa para que los jugadores publiquen, naveguen y compren objetos. Se centra en la configurabilidad, las interfaces guiadas por GUI y el soporte para varios tipos de economía. El proyecto está mantenido por GroupeZ-dev y el repositorio y la documentación muestran una reescritura V4 orientada a Java moderno y arquitecturas de servidor.

🎯 Propósito

zAuctionHouse resuelve el problema del comercio de objetos dentro del juego al proporcionar un mercado central donde los jugadores pueden crear anuncios de compra inmediata, realizar ventas al por mayor y navegar por inventarios categorizados. Está pensado para servidores que quieren un mercado integrado con auditoría de administradores y sincronización de red opcional.

⚙️ Características

• Anuncios de compra instantánea (buy-it-now) y flujos de pujas donde se admita.
• Ventas al por mayor: vende varios objetos en un solo anuncio.
• Vista previa de la caja de Shulker para que los compradores puedan inspeccionar el contenido antes de comprar.
• Filtro por categorías, ordenación avanzada y paginación para grandes conjuntos de anuncios.
• Compatibilidad con múltiples economías (Vault, PlayerPoints, CoinsEngine, monedas basadas en objetos, XP/niveles).
• Sistema de impuestos configurable y reducciones de impuestos basadas en permisos.
• Entrega de dinero con reclamación automática o manual, y notificaciones de ventas offline.
• Integración con zMenu para GUIs y plantillas de inventario totalmente personalizables.
• Compatibilidad con PlaceholderAPI y MiniMessage para mensajes formateados y placeholders.
• Herramientas de administración: panel de admin, registros de acciones, historial de transacciones, recuperación de objetos y comandos de gestión de caché.
• Sincronización entre varios servidores mediante un addon Redis con bloqueo distribuido y pub/sub.
• Controles de objetos en lista negra/blanca, restricciones de mundo, límites de anuncios y de precio, y bloqueo de transacciones para evitar race conditions.
• Compatibilidad con webhook de Discord para notificaciones de ventas con contenido de embed configurable.

🧩 Para quién es

• Servidores Survival y SMP que quieren un mercado impulsado por los jugadores.
• Servidores Skyblock, Factions y centrados en la economía que necesitan sistemas de comercio.
• Redes que requieren mercados sincronizados entre varios servidores backend.
• Administradores de servidores que necesitan registros de auditoría y herramientas de recuperación.

🏗️ Casos de uso de ejemplo

• Los jugadores publican drops raros o objetos crafteados a un precio fijo para que otros jugadores los compren al instante.
• Un operador del servidor aplica reglas de impuestos y reducciones para VIP mediante permisos.
• Una red con varios servidores sincroniza anuncios y ventas entre los servidores hub y backend usando el addon Redis.

⌨️ Comandos

(Los comandos anteriores se han tomado de la documentación oficial del proyecto y de los materiales de inicio rápido del repositorio.)

🔐 Permisos

(Solo se enumeran los nodos de permiso referenciados explícitamente en la configuración y la documentación oficiales.)

⚙️ Instalación

📥 Configuración

• Obtén el jar oficial de zAuctionHouse desde la distribución del proyecto (página oficial de ventas o catálogo).
• Coloca el jar de zAuctionHouse (y los plugins requeridos) en el directorio plugins/ del servidor.
• Reinicia el servidor y verifica que el plugin se inicialice en la consola.
• Configura el plugin usando plugins/zAuctionHouse/config.yml y personaliza los inventarios de la GUI en plugins/zAuctionHouse/inventories/.

📦 Dependencias

• Requeridos: zMenu, PlaceholderAPI.
• Integraciones opcionales / compatibles: Vault, LuckPerms y el addon Redis de zAuctionHouse para sincronización entre varios servidores.

🧠 Notas técnicas

• El proyecto apunta a Java moderno (la reescritura V4 apunta a Java 21) y utiliza un patrón de repositorio / ORM en su arquitectura.
• El software de servidor recomendado incluye Paper y forks de Paper; Folia y varios forks basados en Paper aparecen como compatibles.
• La documentación oficial y la distribución muestran compatibilidad con Minecraft 1.20 hasta 1.21+ (consulta la documentación del proyecto para conocer la compatibilidad exacta de la build antes de desplegar en producción).

❓ FAQ

• ¿Hay una versión gratuita?
  Hay una build demo gratuita disponible (el proyecto ofrece una versión free/demo en algunas plataformas), mientras que las versiones completas y con soporte se distribuyen a través de los canales premium del proyecto.

🤝 Cuándo es útil este plugin

Si necesitas un mercado configurable, guiado por GUI, con soporte para múltiples economías y sincronización opcional entre varios servidores, zAuctionHouse ofrece una implementación de casa de subastas mantenida junto con auditoría de administradores y personalización de la GUI mediante zMenu.