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 colocar itens à venda, navegar e pesquisar anúncios, e comprar itens através de um mercado baseado em GUI. O plugin foca na troca entre jogadores, com regras de anúncio, taxas e avisos configuráveis.

🎯 Objetivo

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

⚙️ Funcionalidades

• Casa de leilões em GUI aberta com /ah.
• Criar e cancelar anúncios; recolher itens cancelados ou expirados.
• Pesquisar e filtrar anúncios por nome, tipo, lore, enchants ou vendedor.
• Ordenar anúncios por tempo ou preço.
• Controlo de anúncios: definir preços mínimos/máximos, taxas de anúncio (fixas e/ou percentuais), imposto do vendedor com limite e cooldown entre anúncios.
• Restrições de itens por nome, tipo, lore, encantamentos, dano, flag unbreakable, custom_model_data e padrões regex.
• Opção para listar itens do servidor (anúncios únicos ou ilimitados).
• Gatilhos especiais para abrir o leilão via placas, entidades de bloco com nome (baús, shulkers, dispensadores, etc.) ou entidades com nome personalizado.
• Tooltips ao passar o rato sobre o item mostram o tempo restante e os enchants.
• Avisos opcionais para novos anúncios e integração com o Discord.
• Suporte a internacionalização e mensagens, materiais e sons configuráveis.
• Registo de transações num ficheiro de log separado e limpeza automática de itens abandonados.

🧩 Para Quem É

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

🏗️ Casos de Uso de Exemplo

• Jogadores anunciam loot em excesso e leiloam-no para a comunidade do servidor em vez de usarem baús ou lojas.
• A equipa do servidor cria anúncios limitados ou ilimitados de itens da loja oferecidos pelo servidor.
• Administradores aplicam regras da economia do servidor restringindo certos itens ou aplicando impostos de anúncio.

⌨️ Comandos

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Descarrega o ficheiro .jar oficial do plugin e coloca-o na pasta plugins/ do teu servidor para servidores compatíveis com Spigot.
• Reinicia o servidor (reinício completo) e verifica a consola para confirmar que o plugin foi carregado.
• Configura o plugin usando os ficheiros de configuração fornecidos, conforme necessário.

📦 Dependências

• Vault (obrigatório, recomendado 1.7.1+).
• Um plugin de economia مناسب (por exemplo, EssentialsX economy ou outro fornecedor de economia compatível com Vault).
• Um plugin de permissões adequado (se usares permissões além das predefinições).

🧠 Notas Técnicas

• Armazenamento: o plugin usa SQLite (não há suporte documentado para bases de dados externas).
• O plugin regista transações num ficheiro de log separado e suporta internacionalização.
• Suporta cabeças do HeadDatabase e texturas de crânios personalizadas como botões da GUI.
• O autor indica que as funcionalidades e a compatibilidade de versões têm como alvo o Spigot; o comportamento pode variar noutros softwares de servidor.

🤝 Quando Este Plugin É Útil

Se queres um sistema de leilões configurável, baseado em GUI e integrado com a economia do teu servidor e o Vault, o AuctionHouse oferece controlo de anúncios, pesquisa/filtros, taxas/impostos e registo de transações para criar um mercado de jogadores gerível.