CH Creations

FiveM

Comandos no produto

Um comando por linha, os marcadores {id}, {quantidade} e {produto} e o ID do jogador.

Cada produto tem o campo Comandos do FiveM, no cadastro do produto. É ali que você diz o que o servidor deve rodar quando alguém compra.

Campo Comandos do FiveM no formulário do produto
Campo Comandos do FiveM no formulário do produto

Como escrever

  • Um comando por linha. Até 20 comandos por produto, cada um com até 180 caracteres.
  • Escreva como você digitaria no console do servidor, sem a barra.
  • Os comandos rodam na ordem em que aparecem.

Marcadores

Na hora da entrega, a loja troca estes marcadores pelos dados da compra:

| Marcador | Vira | | --- | --- | | {id} | O ID do jogador que o comprador informou no checkout (passaporte ou citizenid). | | {quantidade} | A quantidade comprada. | | {produto} | O nome do produto. | | {nome da variável} | O valor que o comprador escolheu numa variável do produto. Ex.: {cor}. |

Exemplos:

group add {id} vip
addmoney {id} bank 50000
givecar {id} {modelo}

O ID do jogador

Quando a compra tem um produto com comandos, o checkout pede o ID no FiveM. O comprador digita o passaporte ou o citizenid. O ID não pode ter espaço, e aceita letras, números e _ . : -, com até 48 caracteres.

Em Configurações > Geral > Checkout, no cartão ID do jogador (FiveM), você muda:

  • Nome do campo: o que o comprador lê, como "Passaporte" ou "ID no servidor".
  • Texto de ajuda: o exemplo dentro do campo.
  • Obrigatório: desligado, o comprador pode deixar em branco. Produto com {id} no comando continua exigindo o ID, porque sem ele o comando não teria para quem entregar.

Confira no seu servidor qual ID o seu comando espera. Se o comando usa o ID do jogo e o comprador digitar outro, a entrega vai para a pessoa errada ou falha.

Segurança

O texto que o comprador digita numa variável passa por um filtro antes de entrar no comando. Caracteres que permitiriam encadear outro comando, como ;, aspas, $, crase, chaves e barras, são recusados no checkout. Valores de opções que você mesmo cadastrou não passam por esse filtro.

Mesmo assim, evite colocar texto livre do comprador em comandos de administração. E lembre que o script nunca roda os comandos da lista Config.Blocked.

Testar antes de vender

Em Pedidos, use Venda de teste. Escolha o produto, informe o ID do jogador e as opções das variáveis, como o comprador faria. Ao aprovar a venda de teste, os comandos entram na fila com esses valores e o script roda no servidor. Assim você confere o comando sem cobrar ninguém.