Plugin Minecraft zAuctionHouse

🔌 Sobre o zAuctionHouse

zAuctionHouse é um plugin de Minecraft que implementa uma casa de leilões completa para os jogadores anunciarem, navegarem e comprarem itens. Ele foca em configurabilidade, interfaces guiadas por GUI e suporte a vários tipos de economia. O projeto é mantido por GroupeZ-dev, e o repositório e a documentação mostram uma reescrita V4 voltada para Java moderno e arquiteturas de servidor.

🎯 Objetivo

zAuctionHouse resolve o problema da troca de itens no jogo ao fornecer um mercado central onde os jogadores podem criar anúncios de compra imediata, realizar vendas em lote e navegar por inventários categorizados. Ele é voltado para servidores que querem um mercado integrado com auditoria de administradores e sincronização de rede opcional.

⚙️ Recursos

• Anúncios com compra instantânea (buy-it-now) e fluxos no estilo de lances onde houver suporte.
• Vendas em lote: venda vários itens em um único anúncio.
• Prévia da caixa de Shulker para que os compradores possam inspecionar o conteúdo antes da compra.
• Filtro por categoria, ordenação avançada e paginação para grandes conjuntos de anúncios.
• Suporte a múltiplas economias (Vault, PlayerPoints, CoinsEngine, moedas baseadas em itens, XP/níveis).
• Sistema de impostos configurável e reduções de taxa baseadas em permissões.
• Entrega de dinheiro com resgate automático ou manual, e notificações de vendas offline.
• Integração com zMenu para GUIs e modelos de inventário totalmente personalizáveis.
• Suporte a PlaceholderAPI e MiniMessage para mensagens formatadas e placeholders.
• Ferramentas de administração: painel de admin, logs de ações, histórico de transações, recuperação de itens e comandos de gerenciamento de cache.
• Sincronização entre vários servidores por meio de um addon Redis com locking distribuído e pub/sub.
• Controles de itens por blacklist/whitelist, restrições de mundo, limites de anúncio e de preço, e travamento de transações para evitar race conditions.
• Suporte a webhook do Discord para notificações de vendas com conteúdo de embed configurável.

🧩 Para quem é

• Servidores Survival e SMP que querem um mercado conduzido pelos jogadores.
• Servidores Skyblock, Factions e focados em economia que precisam de sistemas de troca.
• Networks que exigem mercados sincronizados entre vários servidores backend.
• Administradores de servidor que precisam de logs de auditoria e ferramentas de recuperação.

🏗️ Exemplos de uso

• Jogadores anunciam drops raros ou itens craftados por um preço fixo para que outros jogadores comprem na hora.
• Um operador do servidor aplica regras de impostos e reduções para VIP via permissões.
• Uma rede com vários servidores sincroniza anúncios e vendas entre os servidores hub e backend usando o addon Redis.

⌨️ Comandos

(Os comandos acima foram retirados da documentação oficial do projeto e dos materiais de início rápido do repositório.)

🔐 Permissões

(Somente os nós de permissão explicitamente citados na configuração e na documentação oficiais estão listados.)

⚙️ Instalação

📥 Configuração

• Obtenha o jar oficial do zAuctionHouse na distribuição do projeto (página de vendas oficial ou catálogo).
• Coloque o jar do zAuctionHouse (e os plugins necessários) no diretório plugins/ do servidor.
• Reinicie o servidor e verifique se o plugin é inicializado no console do servidor.
• Configure o plugin usando plugins/zAuctionHouse/config.yml e personalize os inventários da GUI em plugins/zAuctionHouse/inventories/.

📦 Dependências

• Necessário: zMenu, PlaceholderAPI.
• Integrações opcionais / suportadas: Vault, LuckPerms e o addon Redis do zAuctionHouse para sincronização entre vários servidores.

🧠 Observações técnicas

• O projeto visa Java moderno (a reescrita V4 mira Java 21) e usa um padrão de repositório / ORM em sua arquitetura.
• O software de servidor recomendado inclui Paper e forks do Paper; Folia e vários forks baseados em Paper aparecem como suportados.
• A documentação oficial e a distribuição mostram suporte ao Minecraft 1.20 até 1.21+ (verifique a documentação do projeto para a compatibilidade exata da build antes de implantar em produção).

❓ FAQ

• Existe uma versão gratuita?
  Há uma build demo gratuita disponível (o projeto oferece uma versão free/demo em algumas plataformas), enquanto as versões completas e suportadas são distribuídas pelos canais premium do projeto.

🤝 Quando este plugin é útil

Se você precisa de um mercado configurável, guiado por GUI, com suporte a múltiplas economias e sincronização opcional entre vários servidores, o zAuctionHouse oferece uma implementação de casa de leilões mantida, junto com auditoria de administradores e personalização da GUI via zMenu.