DocumentaçãoAjuda
Problemas comuns
As mensagens do plugin, o que causa cada uma e como resolver.
Atualizado em 22 de outubro de 2026.
Todas as páginas
Plugin
Pagamentos e entregas
As mensagens aparecem como o plugin escreve, no chat ou no console. Procure pelo texto exato.
Chave e conexão
| Mensagem | Causa provável | O que fazer |
|---|---|---|
server_credential vazio em settings.yml: loja e textura nao atualizadas ao iniciar. |
O plugin iniciou sem chave. | Gere a chave em Configurações › Plugin, cole em server_credential e rode /hasty reload settings. |
Configure server_credential em settings.yml antes de usar /hasty update. |
A chave está vazia. | O mesmo de cima. |
server_credential deve comecar com hy-. Copie a chave do painel. |
O valor colado não é a chave do servidor. | Copie a chave que começa com hy-. Se ela não aparece mais, use Trocar chave. |
Chave invalida. Verifique server_credential em settings.yml. |
A chave foi trocada no painel ou copiada pela metade. | Gere uma chave nova, cole e rode /hasty reload settings. |
A Hasty não está configurada. Contate um administrador. |
Um jogador abriu /loja num servidor sem chave. |
Configure a chave. |
Handshake com a Hasty falhou: seguido do motivo |
O servidor não alcança https://api.hasty.com.br. |
Libere conexões de saída para api.hasty.com.br no firewall ou na hospedagem. |
Loja
| Mensagem | Causa provável | O que fazer |
|---|---|---|
A loja ainda esta carregando do painel da Hasty. Tente de novo em instantes. |
O plugin ainda não baixou a loja. | Rode /hasty update all. |
Erro ao baixar a loja: seguido do motivo |
A Hasty não respondeu ou recusou a chave. | Confira a chave e rode o comando de novo. |
A loja ja esta sendo baixada. |
Um download já está em andamento. | Espere terminar. |
Este item nao tem produto configurado. |
O botão não tem produto. | Escolha o produto do botão em Menus in-game e rode /hasty update all. |
Seu carrinho tem itens sem produto configurado. |
Um produto do carrinho saiu do botão. | O jogador limpa o carrinho e adiciona de novo. |
Pagamento
| Mensagem | Causa provável | O que fazer |
|---|---|---|
Erro ao gerar pagamento: seguido do motivo |
Muitas vezes, o Mercado Pago não está conectado. | Conecte em Configurações › Recebimentos. |
Pedido criado. O pagamento ainda nao esta disponivel; tente novamente em instantes. |
O Mercado Pago demorou para responder. | O jogador finaliza de novo em instantes. |
Pagamento indisponível: server_credential não configurada. |
O plugin está sem chave. | Configure a chave. |
Nao foi possivel verificar o cupom agora. Tente de novo. |
O servidor não conseguiu falar com a Hasty. | O jogador tenta de novo em instantes. |
Entrega
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Pedido em "Em entrega" por muito tempo | O plugin não está conectado, ou o servidor está desligado. | Confira a chave e rode /hasty reload settings. A entrega sai quando o plugin conectar. |
| Pedido em "Falha na entrega" | Um comando do produto falhou várias vezes. | Resolva a causa e clique em Entregar de novo, em Pedidos. Veja Como funciona a entrega?. |
Texturas
| Mensagem | Causa provável | O que fazer |
|---|---|---|
Nenhuma textura para aplicar: envie texturas ou fundos de menu no painel. |
Não há textura, som nem fundo de menu. | Envie em Menus in-game e rode de novo. |
Nesta versão a Hasty não troca a textura do servidor: baixe a textura no painel (Menus in-game) e junte ao pacote do servidor. |
O servidor é do 1.17 ao 1.20.2. | Baixe com Baixar textura (.zip) e junte ao pacote do servidor. Veja Versões do Minecraft. |
Muitas atualizacoes de textura seguidas. Tente de novo em alguns minutos. |
Passou do limite de publicações. | Espere alguns minutos. |
A Hasty nao conseguiu publicar a textura agora. A textura atual foi mantida; tente de novo em instantes. |
Falha temporária. | Rode de novo em alguns minutos. |
| Itens com textura aparecem como papel | O jogador recusou o pacote, ou usa uma versão mais antiga que a do servidor pelo ViaVersion. | Peça para aceitar o pacote ao entrar, ou para usar a versão do servidor. |
Permissões e Java
| Mensagem | Causa provável | O que fazer |
|---|---|---|
Voce nao tem permissao para usar este comando. |
Falta hasty.admin. |
Veja Comandos e permissões. |
UnsupportedClassVersionError no console |
O Java do servidor é mais antigo que o pedido pelo jar. | Veja a tabela em Como instalar o plugin?. |
Ainda com problema?
Fale com o suporte. Diga a versão do Minecraft, a versão do plugin e a mensagem exata. Nunca mande o settings.yml nem a sua chave.