Servidor de FiveM que vende VIP, moeda ou veículo costuma passar pela mesma fase: o jogador paga, manda o comprovante no privado, e alguém da equipe entra no jogo para entregar. Funciona com dez vendas por mês. Com cinquenta, vira um segundo emprego — e com a equipe dormindo, o jogador que pagou às duas da manhã espera até o dia seguinte.
Entrega automática resolve isso: o pagamento é confirmado sozinho e a compra chega ao jogador dentro do servidor, sem ninguém no meio. O que muda de uma solução para outra é como a compra chega lá, e essa escolha tem consequência em segurança.
Este guia explica o modelo que o GBBOT usa, por que ele não é o mais comum, e o que você precisa configurar do seu lado para funcionar.
Duas formas de levar a compra até o servidor
| Ponto | Plataforma entra no seu servidor (RCON) | Seu servidor busca a compra (fila) |
|---|---|---|
| Porta aberta no servidor | precisa | não precisa |
| Senha do servidor guardada por terceiro | precisa | nunca |
| Atrás de anti-DDoS ou rede fechada | costuma falhar | funciona |
| Quem decide como entregar | a plataforma, por comando | o seu código, do seu jeito |
No modelo de fila, que é o do GBBOT, a compra paga entra numa fila. Um recurso instalado no seu servidor pergunta a cada poucos segundos se há algo novo, entrega com o seu próprio código e confirma. Nada de fora precisa entrar no seu servidor, e nenhuma senha dele sai de lá.
Configurando, do produto à entrega
- 1
Crie a loja e ligue o recebimento por PIX
A loja do GBBOT fica num endereço próprio e cobra por PIX na sua própria conta de pagamento — Asaas, Mercado Pago ou Stripe —, sem comissão por venda. Configure a conta de pagamento primeiro: sem ela, o produto aparece mas ninguém consegue pagar.
- 2
Gere o token e ligue a integração
No painel da loja, na aba Servidor de jogo, gere o token e ligue a integração. São dois cliques diferentes, e esquecer o segundo é o erro mais comum na primeira instalação. O token é uma senha: se vazar, gere outro.
- 3
Instale o recurso no servidor
Copie a pasta do recurso para resources, cole o token no arquivo de configuração e adicione o ensure no server.cfg. Ao reiniciar, o console mostra que conectou à loja e quantas compras há na fila. Se aparecer erro de token, confira se a integração foi mesmo ligada.
- 4
Escreva a entrega do seu jeito
No arquivo de configuração há o trecho de entrega, com um exemplo para ESX comentado. É ali que você credita a moeda, dá o cargo de VIP ou entrega o veículo, usando o framework e as tabelas do seu servidor. A plataforma não tenta adivinhar como o seu banco guarda dinheiro: o código é seu.
- 5
Configure o produto para entrega no jogo
No produto, crie um campo em que o comprador digita a identificação dele no jogo, como a license. Em modo de entrega, escolha Entrega no jogo, defina moeda e quantidade ou o item, e aponte o campo do jogador. O casamento é pelo nome do campo, então reordenar campos depois não manda a compra para o jogador errado.
- 6
Compre de você mesmo antes de divulgar
Faça uma compra real com outra conta e acompanhe no console: a compra chegou, foi entregue, foi confirmada. Teste também com o jogador desconectado, para ver a compra esperar e entrar quando ele conectar. Esse teste de dez minutos evita o primeiro cliente descobrir o problema.
A mesma compra pode chegar duas vezes, e o seu código precisa aguentar
Se o servidor cair entre entregar e confirmar, a compra volta para a fila, porque do lado de cá não há como saber se ela foi entregue. Isso é proposital: perder a compra de quem pagou é muito pior que tentar de novo. A consequência é que a sua entrega precisa ser segura contra repetição — conferir se aquela compra já foi creditada antes de creditar. Com o jogador offline, devolva que não entregou: a compra continua na fila e entra quando ele conectar.
O que vender, e o que evitar
- ●Moeda do servidor em pacotes: é o produto mais simples de entregar e de explicar.
- ●VIP com duração: entregue o cargo e controle a expiração do seu lado, com a data gravada no seu banco.
- ●Veículos e itens cosméticos: funcionam bem, desde que o item exista com o mesmo identificador no seu script.
- ●Evite vender vantagem que desequilibra o jogo para quem não paga. Servidor que vira pagar para vencer perde a base de jogadores que dá valor ao VIP.
- ●Confira as regras da plataforma do FiveM sobre monetização antes de montar o catálogo, e deixe claro na loja o que é e o que não é reembolsável.
A loja do GBBOT faz parte do plano Elite. O recurso de FiveM está pronto para instalar; para outros jogos, a mesma fila é acessível por uma API simples, com três chamadas, que o dono do servidor pode integrar.
Na entrega por fila, nada de fora entra no seu servidor. O seu servidor busca a compra, entrega com o seu código e confirma.
Perguntas frequentes
Como funciona a entrega automática no FiveM?
O jogador paga por PIX na loja e a compra entra numa fila. Um recurso instalado no seu servidor pergunta a cada poucos segundos se há compra nova, entrega usando o seu próprio código e confirma. Não é preciso abrir porta nem entregar senha do servidor para ninguém.
Preciso liberar RCON ou abrir porta?
Não. O modelo é o contrário do RCON: em vez de a plataforma entrar no seu servidor, o seu servidor busca as compras. Isso também funciona atrás de proteção contra ataque e em rede fechada, onde a conexão de fora costuma falhar.
E se o jogador estiver offline na hora da compra?
O seu código devolve que não entregou, e a compra continua na fila. Quando o jogador conectar, a próxima busca entrega. Não é preciso criar armazenamento próprio para isso: a fila já faz esse papel.
Por que uma compra foi entregue duas vezes?
Porque o servidor caiu, ou demorou, entre entregar e confirmar, e a compra voltou para a fila. É proposital, para nenhuma compra paga se perder. Escreva a entrega conferindo se aquela compra já foi creditada antes de creditar de novo.
O painel diz que a compra foi puxada muitas vezes e nunca confirmada. O que é?
Quase sempre o trecho de entrega do arquivo de configuração ainda está com o código de exemplo, que devolve que não entregou. Escreva a entrega real, usando o seu framework, e a compra passa a ser confirmada.
Funciona para Minecraft e outros jogos?
O recurso pronto é o de FiveM. Para outros jogos, a mesma fila é acessível por uma API simples, com três chamadas, que o dono do servidor pode integrar ao próprio plugin ou script. A loja com entrega no jogo faz parte do plano Elite.