Plugin Minecraft Shopkeepers

🔌 Sobre o Shopkeepers

O Shopkeepers é um plugin de Minecraft para Bukkit/Spigot que permite aos donos de servidores criar comerciantes aldeões personalizáveis, vendendo itens configurados por preços configurados. O plugin suporta tanto lojas de administradores (estoque infinito) quanto lojas de jogadores que retiram itens de um contêiner, e publica uma ShopkeepersAPI para integração com add-ons e extensões.

🎯 Objetivo

O plugin oferece um sistema de lojas baseado em NPCs dentro do jogo, para que os servidores possam ter lojas persistentes sem gerenciamento manual de baús ou lojas complexas baseadas em comandos. Ele é مناسب para economias de servidor, lojas de roleplay e servidores survival/SMP que querem comerciantes NPC. ()

⚙️ Recursos

• Crie comerciantes aldeões personalizados com trocas e preços definidos.
• Lojas de administradores com suprimento infinito.
• Lojas de jogadores que puxam itens de um contêiner conectado (baú) para o estoque.
• ShopkeepersAPI para autores de plugins consultarem e gerenciarem comerciantes programaticamente.
• Personalização de itens/dados de itens no jogo e suporte a arquivos de idioma via wiki e arquivos de idioma do projeto. ()

🧩 Para quem é

• Servidores Survival e SMP que querem lojas operadas por NPCs.
• Servidores de roleplay ou economia que usam NPCs aldeões como comerciantes.
• Desenvolvedores de plugins que precisam de uma API para integrar o comportamento de lojas a outros sistemas. ()

🏗️ Casos de uso de exemplo

• Um admin cria uma loja de administrador infinita vendendo itens fornecidos pelo servidor.
• Um jogador abre uma loja que vende automaticamente itens de um baú vinculado.
• Um desenvolvedor cria um add-on que lista ou modifica comerciantes usando a ShopkeepersAPI. ()

⌨️ Comandos

(Observação: acima estão listados apenas os comandos explicitamente documentados pelas fontes oficiais.) ()

⚙️ Instalação

📥 Configuração

• Baixe o arquivo jar oficial do plugin e coloque-o na pasta plugins/ do seu servidor.
• Reinicie o servidor e verifique o console para confirmar que o plugin foi carregado.

(Estes são os passos padrão de instalação para plugins Bukkit/Spigot e são apoiados pela documentação do projeto.) ()

🧠 Notas técnicas

• O Shopkeepers é publicado sob a licença GPL-3.0 e o repositório do projeto inclui um módulo de API (ShopkeepersAPI) e instruções de compilação. ()
• O projeto fornece artefatos Maven e uma API publicada para desenvolvedores de add-ons; o README documenta o uso do repositório e as coordenadas de dependência da API. ()
• A distribuição oficial e o suporte da comunidade estão disponíveis pela página de recursos do Spigot e pelo servidor Discord do plugin. ()

🤝 Quando este plugin é útil

Se você precisa de comerciantes NPC persistentes e configuráveis, com suporte a lojas de administradores e de jogadores, e quer uma API para integrar lojas a outros plugins, o Shopkeepers oferece uma implementação comprovada para servidores Bukkit/Spigot. ()