Como funciona a entrega?

Quando um pagamento é aprovado, cada unidade comprada vai para o inventário do jogador. Quando ele ativa uma compra, a Hasty registra a entrega para o seu servidor. O plugin busca a entrega e roda os comandos do produto no console, na ordem, trocando {player} pelo nick de quem comprou. Vale para compras no jogo e na loja na web. Veja Inventário de compras.

Com um plugin mais antigo que 2.5.0 (ou legacy 0.1.0), não há inventário: a entrega é registrada assim que o pagamento é aprovado.

Com o servidor desligado

O pagamento fica registrado e a entrega espera. Em Pedidos, o pedido aparece como "Em entrega" até o plugin se conectar. Quando o servidor volta, o plugin entrega tudo o que estava pendente.

O jogador não precisa estar online: os comandos rodam pelo console. Se ele estiver online, o plugin avisa no chat que a compra foi confirmada.

Cada comando roda uma vez

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.

Nota: guarde o fulfillment-journal.json nos backups do servidor e não apague a pasta plugins/Hasty ao atualizar o plugin. O arquivo guarda a chave do servidor: não compartilhe.

Quando uma entrega falha

Se um comando falha, a Hasty tenta de novo mais tarde, algumas vezes. Se continuar falhando, o pedido aparece como Falha na entrega em Pedidos, e o item Pedidos, no menu do painel, mostra quantas entregas falharam.

Causas comuns:

• O comando precisa do jogador online, como give, e ele tinha saído.
• O comando é de um plugin que não está instalado ou não carregou.
• Um erro de digitação no comando do produto.
• O comando não funciona pelo console.

Confira o comando em Produtos e as mensagens do console, sem executá-lo de novo: ele pode conceder o benefício outra vez. Corrigir o produto vale para compras futuras. Cada pedido guarda os comandos que estavam no produto no momento da compra; as novas tentativas usam essa cópia e não recebem as alterações feitas depois.

Entregar de novo

1. Resolva a causa: espere o jogador entrar, instale o plugin que faltava ou reinicie o servidor.
2. Em Pedidos, clique em Entregar de novo, ao lado do pedido.

O pedido volta para "Em entrega", e o plugin roda de novo só os comandos que falharam. Os que já deram certo não se repetem.

Se o erro estiver no próprio comando guardado pelo pedido, fale com o suporte e informe o número do pedido, sem enviar a chave do servidor. A equipe confere o que já foi executado e orienta a recuperação.

Com que rapidez

Plugin	Como recebe as entregas
hasty-VERSÃO.jar (1.17 em diante)	A Hasty avisa o plugin assim que o pagamento é aprovado. Se o aviso não chegar, o plugin pergunta de tempos em tempos.
hasty-legacy-VERSÃO.jar (1.8.9)	O plugin pergunta à Hasty a cada 5 segundos.