Batalhas e jogos
Batalhas são somente leitura, mais uma escrita
Você pode listar batalhas, ler uma e cancelar um lobby aberto. Você não pode abrir uma.
Abrir uma batalha é um ato do backend consumidor via S2S: ele carrega uma referência de jogador, um débito de carteira e uma liquidação, e nada disso existe na sessão de um operador. Um botão de console que abrisse batalhas estaria abrindo em nome de um jogador que nunca pediu, com dinheiro que nunca foi debitado.
| Ação | Permissão |
|---|---|
| Listar e ler | battles.read |
| Cancelar um lobby aberto | battles.write |
Cancelar só funciona enquanto a batalha está OPEN. Uma que já começou responde 409.
O que olhar quando algo está errado
Um lobby preso em OPEN passado o prazo significa que a varredura de expiração não está
rodando. Isso é manutenção na instância, e não algo que o console conserte, então reporte ao seu
host. Enquanto isso, todo jogador dentro dele fica impedido de iniciar outra batalha pela regra
de uma batalha ativa.
Uma sequência de FAILED aponta para o gravador: capacidade, credenciais de provedor, ou um
deploy que caiu no meio da batalha.
Assentos presos em FILLED significam que ninguém informou uma URL de sessão de jogo.
FILLED não é READY, e uma mesa que não está toda READY nunca começa.
Jogos: a allowlist
A tela de jogos responde o catálogo inteiro com um booleano por jogo, e não só os liberados, porque uma tela limitada aos jogos liberados não poderia ser usada para liberar um novo.
| Ação | Permissão |
|---|---|
| Ver o catálogo e a allowlist atual | games.read |
| Liberar ou revogar | games.write |
Não é "todos os jogos". Um casino sem nada liberado vê zero jogos na API S2S e toda criação de
batalha falha com 403 game_not_allowed.
Esse é o sintoma mais mal diagnosticado do SlotBattle, porque parece integração quebrada. Liberar jogos faz parte do onboarding.
O catálogo é cacheado, mas o console invalida esse cache a cada liberação e revogação, do mesmo jeito que as configurações invalidam no salvamento, então uma mudança feita aqui aparece na API na hora.
Uma mudança feita fora do console pode levar até 30 segundos para aparecer. Veja Mudanças de allowlist.
status de um jogo
validated foi verificado ponta a ponta: a receita de gravação funciona, a compra de bônus
entra e o vídeo é assistível.
planned significa que existe receita mas não existe perfil. Ele aparece para um operador
ver que está vindo. Não libere para um casino que vai vender.
Revogando um jogo com lobby aberto
Revogar com um lobby aberto não cancela aquele lobby, mas a allowlist é rechecada quando os bots são sentados. Uma batalha cujo jogo foi revogado enquanto ela esperava, portanto, falha no ponto do preenchimento em vez de rodar num jogo que você retirou.
Batalhas RUNNING existentes não são afetadas, porque já foram despachadas.