Plugin Minecraft AuctionHouse

🔌 Sobre o AuctionHouse

AuctionHouse é um plugin de Minecraft que adiciona uma casa de leilões no jogo, acessível com o comando /ah. Os jogadores podem anunciar itens à venda, navegar e pesquisar listagens, e comprar itens por meio de um mercado baseado em GUI. O plugin foca na negociação entre jogadores, com regras de listagem, taxas e anúncios configuráveis.

🎯 Objetivo

O AuctionHouse oferece um mercado centralizado, guiado por GUI, para que os servidores possam oferecer um sistema de leilões gerenciado em vez de depender de lojas criadas por jogadores ou mercados baseados em placas. Ele foi feito para servidores que querem um mercado público pesquisável com restrições configuráveis e integração com a economia.

⚙️ Recursos

• Casa de leilões em GUI aberta com /ah.
• Criar e cancelar listagens; coletar itens cancelados ou expirados.
• Pesquisar e filtrar listagens por nome, tipo, lore, enchants ou vendedor.
• Ordenar listagens por tempo ou preço.
• Controles de listagem: definir preços mínimos/máximos, taxas de listagem (fixas e/ou percentuais), imposto do vendedor com limite e cooldown entre listagens.
• Restrições de itens por nome, tipo, lore, encantamentos, dano, flag unbreakable, custom_model_data e padrões regex.
• Opção de listar itens do servidor (listagens únicas ou ilimitadas).
• Gatilhos especiais para abrir o leilão via placas, entidades de bloco nomeadas (baús, shulkers, dispensadores, etc.) ou entidades com nome personalizado.
• Tooltips ao passar o mouse sobre o item mostram o tempo restante e os enchants.
• Anúncios opcionais para novas listagens e integração com o Discord.
• Suporte à internacionalização e mensagens, materiais e sons configuráveis.
• Registro de transações em um arquivo de log separado e limpeza automática de itens abandonados.

🧩 Para Quem É

• Servidores Survival e SMP que querem um mercado compartilhado entre jogadores.
• Servidores focados em economia que querem uma GUI de leilões pesquisável.
• Administradores que precisam de regras de listagem, taxas e restrições de itens configuráveis.

🏗️ Casos de Uso

• Jogadores listam itens sobrando e leiloam para a comunidade do servidor em vez de usar baús ou lojas.
• A equipe do servidor cria listagens limitadas ou ilimitadas de itens oferecidos pelo servidor.
• Administradores aplicam regras da economia do servidor restringindo certos itens ou cobrando impostos de listagem.

⌨️ Comandos

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Baixe o arquivo .jar oficial do plugin e coloque-o no diretório plugins/ do seu servidor para servidores compatíveis com Spigot.
• Reinicie o servidor (reinício completo) e verifique o console para confirmar que o plugin foi carregado.
• Configure o plugin usando os arquivos de configuração fornecidos, conforme necessário.

📦 Dependências

• Vault (obrigatório, recomendado 1.7.1+).
• Um plugin de economia apropriado (por exemplo, EssentialsX economy ou outro provedor de economia compatível com Vault).
• Um plugin de permissões apropriado (se você usar permissões além das padrões).

🧠 Notas Técnicas

• Armazenamento: o plugin usa SQLite (não há suporte documentado para banco de dados externo).
• O plugin registra transações em um arquivo de log separado e oferece suporte à internacionalização.
• Suporta cabeças do HeadDatabase e texturas de crânio personalizadas como botões da GUI.
• O autor observa que os recursos e a compatibilidade de versão têm como alvo o Spigot; o comportamento pode variar em outros softwares de servidor.

🤝 Quando Este Plugin É Útil

Se você quer um sistema de leilões configurável, baseado em GUI e integrado à economia do seu servidor e ao Vault, o AuctionHouse oferece controles de listagem, pesquisa/filtro, taxas/impostos e registro de transações para fornecer um mercado de jogadores gerenciável.