DocumentaçãoComeçar

Primeiros passos

Da conta nova à primeira venda no seu servidor, em seis passos.

Atualizado em 22 de outubro de 2026.

Todas as páginas

Este tutorial leva você da conta nova a uma compra de teste entregue no jogo. Faça na ordem: cada passo usa o anterior.

O que você precisa

  • Um servidor Spigot ou Paper no Minecraft 1.8.9 ou do 1.17 em diante, em que você tenha acesso ao console e à pasta plugins.
  • Uma conta no Mercado Pago, para receber pelas vendas.
  • Uma conta no Discord ou no Google, para entrar no painel.

1. Crie o servidor no painel

  1. Entre em app.hasty.com.br com o Discord ou o Google.
  2. Crie o seu servidor. O endereço que você escolher vira o da loja na web, por exemplo seuservidor.hasty.com.br.

2. Escolha a versão do Minecraft

Em Menus in-game, no seletor ao lado de Templates, escolha a versão do seu servidor. A Hasty monta a loja para essa versão e só deixa você usar o que ela suporta. Veja Versões do Minecraft.

3. Conecte o Mercado Pago

Em Configurações, na parte Recebimentos, conecte a sua conta do Mercado Pago. Sem isso, o jogador não consegue pagar. Veja Como receber pelas vendas?.

4. Cadastre um produto

Em Produtos, crie um produto com nome, preço e pelo menos um comando. Para testar, use um comando simples:

say {player} comprou na loja!

Veja Como criar um produto?.

5. Instale o plugin

Siga Como instalar o plugin?. No fim, rode no console:

/hasty update all

O console deve mostrar Loja baixada e carregada.

6. Faça uma compra de teste

  1. Entre no servidor e rode /loja.
  2. Coloque o produto no carrinho e finalize com Pix.
  3. Pague o QR que aparece no mapa na sua mão. O QR vira "Compra confirmada" e o seu inventário abre.
  4. Clique na compra e clique de novo para ativar.
  5. Confira no chat do servidor a mensagem do comando say, e em Pedidos, no painel, o pedido como "Entregue".

Pronto: a loja está no ar. Agora monte os menus do seu jeito em Como montar os menus do /loja?, e coloque um botão Mudar menu para o menu Inventário na loja. Veja Inventário de compras.

Problemas

Sintoma Causa provável O que fazer
/loja responde A loja ainda esta carregando do painel da Hasty. O plugin ainda não baixou a loja. Rode /hasty update all no console.
O pedido fica em "Em entrega" O plugin não está conectado. Confira a chave em settings.yml e rode /hasty reload settings.
Ao finalizar, aparece Erro ao gerar pagamento: Muitas vezes, o Mercado Pago não está conectado. Conecte em Configurações › Recebimentos e tente de novo.

Para outras mensagens, veja Problemas comuns.