Plugin Minecraft QuickShop-Hikari

🔌 Sobre o QuickShop-Hikari

QuickShop-Hikari é um plugin de Minecraft que implementa lojas de compra e venda baseadas em baús (ChestShops). Os jogadores criam e usam lojas interagindo com baús; a maior parte da jogabilidade não exige comandos. O projeto é mantido pela QuickShop-Community e foca em compatibilidade moderna, segurança dos dados e integrações extensíveis.

🎯 Objetivo

Oferecer uma economia dentro do jogo, baseada em itens, onde os jogadores podem listar itens à venda ou criar lojas de compra usando baús. O plugin é voltado para administradores de servidor que querem uma economia física, guiada por baús, e controle por loja sem obrigar os jogadores a aprender comandos.

⚙️ Recursos

• Crie lojas de compra e venda usando baús e placas (lojas baseadas em baús).
• Suporte a dados NBT, encantamentos, durabilidade do item, dados de poção e ovos de mob.
• Item de exibição virtual acima das lojas com opção de ativar/desativar (suporta ProtocolLib ou PacketEvents).
• Suporte a baús ilimitados e comportamento misto de compra/venda em baú duplo.
• Suporte a blacklist com opções de permissão para ignorar a restrição.
• Gerenciamento de permissões por loja e benefícios da loja entre proprietários e outros jogadores.
• Suporte i18n para nomes de itens e encantamentos, e sintaxe MiniMessage para mensagens.
• Suporte a datasource H2 (local) e MySQL (remoto).
• Hooks de integração para plugins comuns de proteção e utilidade (módulos de compatibilidade disponíveis).
• API para desenvolvedores (coordenadas Maven/Gradle fornecidas) para consultar lojas e integrar recursos.
• Telemetria do bStats com opção de desativar via configuração.

🧩 Para quem é

Proprietários e administradores de servidores que rodam Survival/SMP ou servidores focados em economia e querem um marketplace físico baseado em baús. Funciona bem em servidores pequenos e grandes que usam plugins de economia compatíveis com Vault e desejam controle por loja e armazenamento com banco de dados.

🏗️ Casos de uso

• Jogadores colocam itens em um baú e o etiquetam para vender automaticamente pilhas para outros jogadores.
• Um administrador ativa permissões por loja para que moderadores possam gerenciar lojas em mundos ou regiões específicas.
• Uma rede usa armazenamento MySQL para manter as lojas persistentes entre instâncias do servidor.

⌨️ Comandos

Observação: a documentação do projeto informa que o jogo normal dos jogadores não exige comandos; os comandos são principalmente administrativos.

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Baixe o jar oficial do QuickShop-Hikari na distribuição do projeto (releases no Modrinth/Spigot/GitHub).
• Coloque o arquivo jar na pasta plugins/ do seu servidor.
• Inicie o servidor e verifique se o plugin foi carregado (a documentação mostra executar o comando qs no console para exibir a ajuda/saída de teste).

📦 Dependências

Integrações obrigatórias/opcionais confirmadas e listadas pelo projeto:

• Vault (necessário para a ponte de economia)
• Um plugin de economia compatível com Vault (exemplos fornecidos pelo projeto)
• ProtocolLib ou PacketEvents (necessários para itens de exibição virtuais / localização por jogador)
• LuckPerms (recomendado para gerenciamento de permissões)

🧾 Configuração

• O plugin cria e usa um config.yml (a documentação referencia chaves do config.yml para protocolo de exibição e configurações de privacidade).
• O armazenamento de dados suporta H2 local ou MySQL remoto; as opções de configuração estão disponíveis nos arquivos de configuração do plugin.

🧠 Notas técnicas

• A documentação oficial recomenda executar em um servidor baseado em Paper e informa a necessidade de Java 21.
• O projeto fornece uma API para desenvolvedores e coordenadas Maven/Gradle para uso em tempo de compilação.
• O QuickShop-Hikari inclui módulos de compatibilidade para plugins de terceiros (por exemplo, WorldGuard, WorldEdit, OpenInv) como downloads opcionais.
• Telemetria: usa bStats; é possível desativar nas configurações.

🤝 Quando este plugin é útil

Se você quer um marketplace visível aos jogadores, baseado em baús, com armazenamento persistente e controles por loja (em vez de lojas apenas por GUI ou por comandos), o QuickShop-Hikari oferece uma implementação moderna, com banco de dados, e hooks para plugins comuns de economia e proteção.