Hasty | Documentação do plugin para Minecraft

O que o servidor precisa?

Spigot ou Paper, do Minecraft Java Edition 1.19.4 ou mais nova.
Java 21 ou mais nova rodando o servidor.
Acesso de saída a https://api.hasty.com.br. Não é preciso abrir nenhuma porta.
Para itens com modelo próprio pelo pacote de texturas, Minecraft 1.21.4 ou mais nova.

Como instalar o plugin?

Baixe o Hasty.jar, coloque na pasta plugins e inicie o servidor uma vez. O plugin cria o arquivo plugins/Hasty/settings.yml.
No painel, gere a chave do servidor, no passo "Instale o plugin" ou em Configurações. Ela começa com hy- e só aparece uma vez, então copie na hora.
Cole a chave em server_credential, salve o arquivo e reinicie o servidor, ou rode /hasty reload.
Rode /hasty update all para baixar a loja e as texturas, e abra a loja com /loja. Se aparecer o seu catálogo, está tudo conectado.

O que tem no settings.yml?

O arquivo fica em plugins/Hasty/settings.yml. Na prática, você só preenche a chave:

plugins/Hasty/settings.yml

# A chave gerada no painel.
server_credential: "hy-..."

# Já vem preenchido. Não precisa mudar.
api_url: "https://api.hasty.com.br"

# hand_mode ou flying_mode.
qrcodemode: hand_mode

server_credential: A chave do servidor, gerada no painel. Começa com hy- e é o único valor que você precisa preencher.
api_url: O endereço da API da Hasty. Já vem como https://api.hasty.com.br. Não mude.
qrcodemode: Como o QR code de pagamento aparece no jogo: hand_mode, num mapa na mão do jogador, ou flying_mode, num quadro flutuando na frente dele.
texturepack: Preenchido pelo próprio plugin quando você publica as texturas. Não edite.

Arquivos de versões antigas podem ter secret_key, resourcepack_public_url e resourcepack_port. O plugin 2.2.0 ignora os dois últimos. O secret_key só é aceito uma vez, para migrar, e precisa ser uma chave hy-. Depois que o servidor iniciar com a chave em server_credential, pode apagar os três.

Não compartilhe o settings.yml nem o fulfillment-journal.json, nem em pedidos de suporte. Eles guardam a chave do seu servidor.

Quais são os comandos?

/loja: Abre a loja. Qualquer jogador pode usar.
/hasty update all: Baixa a loja do painel e publica as texturas. Rode depois de mudar o catálogo ou os menus. /hasty update sozinho faz o mesmo.
/hasty update store: Baixa só a loja. A versão anterior fica guardada em old_loja.yml.
/hasty update texture: Publica só as texturas e os fundos de menu, e envia o pacote aos jogadores online.
/hasty update texture remove: Tira o pacote de texturas da Hasty dos jogadores online e do settings.yml.
/hasty reload: Recarrega a loja e o settings.yml sem reiniciar o servidor.
/hasty reload store: Recarrega só a loja.
/hasty reload settings: Recarrega só o settings.yml e reconecta a entrega, por exemplo depois de trocar a chave.

Quem pode usar?

/loja é para todos os jogadores. Todos os comandos /hasty pedem a permissão hasty.admin, que vem com o op. Para dar a alguém da equipe sem op, use o seu plugin de permissões, por exemplo lp user Nick permission set hasty.admin true no LuckPerms. No console do servidor, os comandos funcionam sem permissão.

Como funcionam as texturas?

As texturas dos itens e os fundos de menu são enviados no painel, em Menus in-game. Quando você roda /hasty update texture ou /hasty update all, a Hasty monta o pacote de texturas com eles e publica em assets.hasty.com.br. O plugin guarda o endereço no settings.yml, envia o pacote aos jogadores online e de novo a cada vez que alguém entra.

Os jogadores baixam o pacote direto da Hasty. O seu servidor não precisa abrir porta nem hospedar nada.
O pacote é enviado por cima do pacote que o servidor já usa, como o do server.properties ou do ItemsAdder, sem substituir.
Itens com modelo próprio pedem Minecraft 1.21.4 ou mais nova.
Se a publicação falhar, o pacote atual continua valendo. Rode o comando de novo em alguns minutos: ele aceita até 10 publicações a cada 5 minutos.

Isso vale a partir do plugin 2.2.0. As versões 2.0.0 e 2.1.0 serviam o pacote pelo próprio servidor e pediam uma porta aberta e o resourcepack_public_url. Atualize para não precisar disso.

O que acontece com uma entrega se o servidor cair?

Quando um pagamento é aprovado, a Hasty registra a entrega para o seu servidor. O plugin busca as entregas pendentes e roda os comandos de cada produto, na ordem, pelo console, trocando {player} pelo nick de quem comprou.

Com o servidor desligado, o pagamento fica registrado e a entrega espera. Em Pedidos, no painel, ela aparece como "Em entrega" até o plugin se conectar.
O plugin anota em plugins/Hasty/fulfillment-journal.json cada comando que já rodou. Se o servidor cair no meio de uma entrega, ele continua de onde parou e não repete o que já foi feito.
Se um comando falhar, a Hasty tenta de novo mais tarde. Se continuar falhando, o pedido aparece como "Falha na entrega" em Pedidos.

Guarde o fulfillment-journal.json nos backups do servidor. Veja também o guia o que acontece se o servidor estiver desligado quando alguém pagar.

Como atualizar o plugin?

Baixe a versão nova em /plugin e troque o arquivo na pasta plugins.
Reinicie o servidor. O settings.yml e a chave continuam valendo.
Rode /hasty update all e confira que o log mostra a versão nova e que /loja abre.

O plugin 1.x não funciona mais. Quem vem dele precisa gerar uma chave nova no painel e colar em server_credential.

Problemas comuns

As mensagens aparecem como o plugin escreve, no chat ou no console.

Configure server_credential em settings.yml antes de usar /hasty update.: A chave está vazia. Gere a chave no painel, cole em server_credential e salve o arquivo.
server_credential deve comecar com hy-. Copie a chave do painel.: O que está no arquivo não é a chave do servidor. Copie de novo a chave que começa com hy-. Se ela não aparece mais no painel, troque a chave em Configurações.
Voce nao tem permissao para usar este comando.: Os comandos /hasty pedem a permissão hasty.admin, que já vem com o op.
Texturas requerem Minecraft 1.20.3+.: O servidor é de uma versão anterior à 1.20.3 e não recebe o pacote de texturas. Para itens com modelo próprio, o mínimo é 1.21.4.
Nenhuma textura para aplicar: envie texturas ou fundos de menu no painel.: O servidor ainda não tem texturas nem fundos de menu. Envie em Menus in-game, no painel, e rode o comando de novo.
UnsupportedClassVersionError: Aparece no console quando o plugin não carrega porque o servidor roda uma versão do Java anterior à 21.

Se a chave vazou, troque em Configurações, no painel: a chave antiga para de funcionar na hora, e o plugin só volta a entregar depois que você colar a nova e rodar /hasty reload settings. Para qualquer outra coisa, fale com o suporte.