← Voltar para Here To Slay

Here To Slay, parte 6: uma mesa que conversa

O "estou pronto" no lobby e um chat que passa pelo mesmo caminho das jogadas, com limite de tamanho, limite de ritmo e histórico para quem chega depois.

#tecnico#kafka

No jogo físico, metade da graça acontece fora das cartas. É a reclamação de quem foi roubado, o “vou te desafiar” antes de alguém jogar um herói, a negociação para todo mundo se juntar contra quem está ganhando. Na versão digital, até aqui, nada disso existia: cada um jogava calado, e a única forma de falar com a mesa era por outro aplicativo.

Durante o redesign da parte 5, ficou claro que a conversa precisava estar dentro do jogo, em dois lugares: na sala de espera, antes da partida, e na própria mesa.

Primeiro, o “estou pronto”

A sala de espera tinha um problema antes mesmo do chat. Na versão das partes 2 a 4, a contagem regressiva começava sozinha assim que o número mínimo de jogadores entrava, e a partida abria cinco segundos depois. Não dava tempo de esperar um amigo que ainda estava entrando, nem de combinar nada.

Agora cada assento tem um botão “Estou pronto”, e a regra para começar ficou em uma linha:

public boolean isReadyToStart() {
    return players.size() >= minPlayers && readyPlayers.containsAll(players);
}

A contagem só começa quando o mínimo foi atingido e todo mundo que está na sala marcou pronto. Se alguém desmarca, ou se entra uma pessoa nova que ainda não está pronta, a contagem para.

Na tela, cada assento mostra quem já está pronto. Aqui o João já marcou, a Maria ainda não, e o centro da mesa avisa que a contagem só começa quando os dois estiverem prontos. Do lado, o chat da sala já tem a primeira conversa, uma mensagem digitada e um “Boa sorte!” mandado com um clique:

A sala de espera vista pela Maria: João com o selo Pronto, Maria ainda se preparando, o aviso 1 de 2 prontos no centro da mesa, o botão Estou pronto embaixo e, à direita, o chat com a mensagem do João, o Boa sorte! da Maria e as frases rápidas

O mesmo caminho das jogadas

O chat não ganhou um servidor próprio. Uma mensagem segue exatamente o caminho de qualquer outra ação, que é o da parte 3: o cliente manda pelo WebSocket, o gateway publica no Kafka e o serviço dono daquela sala responde.

  • Na sala de espera, a mensagem vai para o lobby-actions-in, com a chave do lobby, e quem cuida dela é o serviço de lobby.
  • Na partida, ela vai para o game-actions-in, com a chave da partida, e quem cuida é a engine.

Com isso, o chat herdou de graça tudo o que a arquitetura já fazia: as mensagens de uma mesma sala caem sempre na mesma partição e chegam na ordem em que foram enviadas, e quem responde é sempre o mesmo processo, que já tem a lista de quem está naquela mesa.

O que o servidor guarda

Cada sala e cada partida têm o seu próprio registro de conversa, uma classe pequena que faz três coisas:

public synchronized JSONObject append(String playerId, String username, String rawText) {
    String text = sanitize(rawText);
    if (text.isEmpty()) return null;
    long now = System.currentTimeMillis();
    Long previous = lastSentAt.get(playerId);
    if (previous != null && now - previous < MIN_INTERVAL_MS) return null;
    // ... grava a mensagem e mantém só as últimas 40
}
  • Limpa o texto: caracteres de controle e espaços repetidos saem, e a mensagem é cortada em 200 caracteres.
  • Limita o ritmo: cada jogador pode mandar no máximo uma mensagem a cada 0,6 segundo. É o suficiente para uma conversa normal e impede que alguém trave a mesa colando texto sem parar.
  • Guarda um histórico curto: as últimas 40 mensagens ficam na memória. Quem entra depois, ou quem cai e reconecta no meio da partida, recebe esse histórico e não perde o fio da conversa.

O servidor nunca confia no cliente para nada disso. Mesmo que alguém modifique o app, o limite de tamanho e de ritmo continua valendo, porque é aplicado do lado de lá.

Do lado da tela

Digitar no meio de uma partida é lento, e as falas mais comuns de uma mesa de Here To Slay são sempre as mesmas. Por isso o chat tem frases rápidas, que vão com um clique: “Boa sorte!”, “Bem jogado”, “Ops…”, “Vou te desafiar” e “GG” na sala de espera. Na partida, o “Boa sorte!” dá lugar a um “Socorro!”.

Na mesa, o chat fica numa coluna ao lado, que dá para recolher para ganhar espaço. Recolhido, ele vira uma aba com o número de mensagens não lidas, para ninguém perder um “não faz isso” enquanto está escolhendo o alvo de um efeito. Essa foi uma das mudanças que vieram de jogar de verdade: a conversa é mais importante justamente nos momentos de decisão, então ela não pode ficar escondida atrás de um botão.

Durante a partida, a conversa fica na coluna da direita, ao lado da mesa:

A mesa com o chat aberto à direita mostrando a mensagem do João, Se jogar herói agora eu desafio, hein, as frases rápidas com Socorro! e o campo para digitar, ao lado do painel de pontos de ação

E, com a coluna recolhida, a mensagem nova vira um número na aba lateral:

A mesa com o chat recolhido numa aba vertical na lateral direita, escrita Conversa, com um selo vermelho indicando 1 mensagem não lida

As mensagens não são traduzidas. A interface aparece em português, inglês ou espanhol, mas o que os jogadores escrevem chega do jeito que foi escrito.

Na parte 7, a maior mudança por baixo dessa interface nova: a engine que roda as regras do jogo.