Hoje a loja.gg tem um resource oficial pronto apenas para FiveM e RedM (veja FiveM e RedM). Para Minecraft ou qualquer outro engine, não existe ainda um plugin pronto — a entrega é feita conectando o webhook de pedidos da loja.gg ao seu próprio servidor.
Como funciona
O princípio é o mesmo de qualquer integração de entrega: você recebe um aviso quando o pedido é pago e, a partir dele, aciona o que já existe no seu servidor para dar o produto ao jogador — um plugin, um plugin RCON, um comando via console.1
Cadastre um endpoint de webhook
No painel, em Loja → Configurações → Webhooks, cadastre a URL de um serviço seu (uma função serverless, um bot, um plugin com um endpoint HTTP embutido) e guarde o segredo
whsec_... gerado.2
Escute o evento order.paid
É o evento correto para liberar produto — não a página de sucesso do checkout. Veja o formato completo em Webhooks.
3
Valide a assinatura do webhook
Use o segredo para validar o cabeçalho
X-Huskpay-Signature antes de processar qualquer coisa — os exemplos em Node.js, Go e PHP estão em Webhooks.4
Traduza o pedido em uma ação no servidor
A partir dos dados do pedido (
data.order.items, identificador do comprador que você tiver associado ao produto — nick, e-mail, UUID), acione a entrega da forma que seu servidor já suporta.Opções comuns para acionar a entrega
RCON
Se o seu servidor Minecraft expõe RCON, seu handler de webhook pode abrir uma conexão RCON e rodar um comando (ex.:
lp user <jogador> permission set vip.gold true, ou um comando de plugin de loja como EssentialsX/Vault).Plugin com endpoint próprio
Um plugin Java/Kotlin (Spigot, Paper, Fabric) pode expor um endpoint HTTP interno que seu handler de webhook chama para entregar o item direto na API do plugin, sem depender de RCON.
Fila própria
Se o jogador pode estar offline no momento do pagamento, grave a entrega pendente no seu banco e processe quando ele conectar — o mesmo padrão usado na integração de FiveM/RedM (veja FiveM e RedM).
Identificação do jogador
Use uma variável de produto (ex.: campo “Nick” ou “UUID”) para capturar, no momento da compra, qual jogador deve receber o item — ela vem preenchida em
metadata/variables no pedido.