X1 · Ajuda
Comandos do bot
No Telegram, @gocai_x1_player_bot; no WhatsApp, o número da X1.
Toda tela do bot é uma lista para tocar: toque no item, responda o que ele pedir, confira o resumo e confirme com
/ok. /cancelar desiste. /ajuda fecha qualquer menu e mostra os comandos do seu papel.
Sou jogador
Entrar, seguir jogos, inscrever-se em campeonato, jogar as disputas, subir na ladder.
Sou staff ou admin
Aprovar jogadores e inscrições, confirmar resultados, criar temporada e campeonato, montar o chaveamento.
Jogar pelo site
O mesmo, sem comandos: a trilha pelo site e as regras em uma olhada.
Jogador
Trilha sugerida
- 1. Entrar
/start. Espere a aprovação de um staff (você é avisado). - 2. Dizer o que joga
/seguir_jogoe/seguir_console: é assim que você recebe aviso de campeonato. - 3. Nome
/nick SeuNomeé o nome que aparece no ranking. - 4. Site
/vinculardá um código de 6 dígitos; digite no site para usar a mesma conta nos dois. - 5. Campeonato
/champsquando as inscrições abrirem; toque no campeonato e/ok. Aguarde a confirmação. - 6. DisputaO bot te chama. Jogue, e um dos dois registra com
/resultado. O chaveamento está em/report_champs. - 7. LadderAo fim do campeonato você já está na ladder (
/ladder). Chegou depois?/entrar_ladderte põe na zona dos novatos; o primeiro desafio fechado te dá a posição. - 8. Subir
/desafiaralguém acima. Vença e assuma o lugar dele. Defenda duas vezes e ganhe um escudo. - 9. Acompanhar
/meuperfil,/ranking,/desafios,/partidas, e a sua página aqui no site.
Começar
| Comando | O que faz |
|---|---|
/start | Pede a inscrição na plataforma. Um staff aprova; você recebe o aviso. |
/ajuda | Lista os seus comandos. Também fecha qualquer menu aberto. |
/tgram_id | Seu ID do Telegram (se um staff pedir). |
/nick Nome | Troca o nome exibido. Único; sem acentos vira o seu comando nas listas. |
/vincular | Usar a mesma conta no site, no WhatsApp e no Telegram: o comando dá um código de 6 dígitos (vale 60 s) para digitar no outro lado. Já vinculado, pergunta se quer desvincular. |
Seus filtros (notificações)
| Comando | O que faz |
|---|---|
/seguir_jogo | /deixar_jogo | Seguir ou deixar de seguir jogos. Você só recebe aviso de campeonato dos jogos que segue. |
/seguir_console | /deixar_console | Suas plataformas. /zhumano é o console de quem joga sem console (par ou ímpar, jokenpô). |
/jogos, /consoles, /temporadas | Catálogo de jogos, de consoles e as temporadas. |
Campeonato
| Comando | O que faz |
|---|---|
/champs | Campeonatos da temporada e o estado de cada um. Com inscrições abertas, toque no campeonato e /ok para se inscrever. |
/report_champs | O chaveamento inteiro, com quem está jogando agora. |
/campeonatos, /eventos | Lista simples e os seus. |
Resultado das suas partidas (ladder e campeonato)
| Comando | O que faz |
|---|---|
/resultado | Registrar o placar da partida (série e, se a ladder pedir, personagens). Qualquer um dos dois registra. |
/venci_wo | O adversário não apareceu: W.O. a seu favor. |
/confirmar | Confirmar o que o adversário registrou. Fecha a partida na hora: pontua, move a ladder ou avança o chaveamento. |
/corrigir | O placar que o adversário registrou está errado: você manda a sua versão e ele confirma. |
/contestar | Há problema no resultado: abre uma disputa e a curadoria da X1 decide. Até lá, ninguém sobe nem desce. |
/partidas | Suas partidas em andamento e o que falta em cada uma. |
/notificar | Lembrar o adversário de uma partida pendente. |
Ladder de desafios
| Comando | O que faz |
|---|---|
/ranking | Sua posição por jogo: lugar na ladder, energia (❤️), escudo (🛡), coringas (🃏), férias (🏖) e 🚨 se há partida em andamento. |
/ladder | A ladder: posições, escudos, férias, quem está em desafio, a zona dos novatos, e sua energia e coringas. |
/entrar_ladder | /sair_ladder | Entrar (pela zona dos novatos) ou sair. |
/desafiar | Lista quem está ao seu alcance (até 3 acima; no top 3, 1). Gasta 1 de energia. Formato /bo3 ou /bo5, conforme a ladder. |
/aceitar | Aceitar o desafio recebido. É obrigatório: sem resposta no prazo, quem desafiou vence por W.O. |
/desistir | Retirar um desafio seu ainda não aceito. |
/coringa | Desafiar qualquer um acima, ignorando o alcance. Gasta 1 coringa do saldo. |
/escudo | Ativar um escudo da sua mochila: 24 h sem poder ser desafiado. Desafiar com o escudo ativo perde o escudo. |
/ferias | Congelar sua posição por alguns dias (saldo de 30 por temporada). /ferias de novo para voltar antes. |
/desafios | Seus desafios em andamento e o que falta em cada um. |
/historico | Seus últimos desafios encerrados. |
Se algo travar
O bot ficou mudo? Há um menu aberto: /ajuda fecha tudo. Recebeu um desafio e não vê o
/aceitar? /desafios mostra o que está pendente. Erro num resultado? /corrigir
ou /contestar; o staff também corrige com /definir. Problema com a conta?
Abra um chamado de suporte aqui no site.
Staff e admin
Staff cura: aprova gente, inscrições e resultados. Admin faz tudo isso e também cria temporada e campeonato, monta o chaveamento, corrige e configura.
Trilha do staff (dia a dia)
- 1. Fila de espera
/pendentes: toque nos nomes,/ok. O aprovado é avisado na hora. - 2. Inscrições
/inscricoes: toque,/okconfirma,/recusarrecusa. A ordem de confirmação é a cabeça de chave. - 3. Resultados
/partidasmostra tudo em andamento./confirmarfecha o que foi reportado;/resultadoregistra em nome dos dois;/corrigirconserta um placar. - 4. Ausências
/wonuma disputa do chaveamento: quem faltou./notificarlembra o adversário. - 5. Gente
/jogadores(toque para a ficha),/staffs.
Trilha do admin (uma temporada)
- 1. Temporada
/temporada: nome, jogos,/ok. Nasce ativa com ranking de pontos e ladder vazia por jogo./temporada_datasajusta início e fim. - 2. Campeonato
/incchamp: jogo, console, nome, data, formato. Nasce «em breve»; quem segue o jogo é avisado. - 3. Inscrições
/inic_inscabre (seguidores avisados). Staff confirma em/inscricoes. - 4. Chaveamento
/inic_champ: fecha inscrições, monta a dupla eliminação, chama a rodada 1. - 5. Durante
/confirmar,/wo,/definir(corrigir ou anular),/report_champs. - 6. ConclusãoAutomática na grande final: colocações, pontos, ladder semeada, +1 coringa ao campeão.
- 7. Ladder
/config_ranking(alcance, top, escudo, prazos),/posicionar,/inccoringa,/varredura. - 8. SiteO site mostra na hora o que o bot muda: é a mesma base. O site anterior, em /alpha, atualiza a cada uns 8 minutos.
Curadoria (staff e admin)
| Comando | O que faz |
|---|---|
/pendentes | Fila de espera como lista; toque e /ok aprova. |
↳ /aprova_geral | Aprova todos os pendentes de uma vez. |
/inscricoes | Inscrições pendentes em campeonato: /ok confirma (seed = ordem), /recusar recusa. |
/partidas | Todas as partidas em andamento e o que falta em cada uma. |
/confirmar | Partidas e desafios reportados. /ok confirma: pontua, move a ladder ou avança o chaveamento. |
/resultado | Registrar o resultado de qualquer partida, em nome dos dois. |
/corrigir | Corrigir o placar de uma partida (outro staff confirma depois). |
/notificar | Lembrar o adversário de uma partida pendente. |
/wo | Disputa do chaveamento em andamento: /faltou_a, /faltou_b ou /faltaram. |
/jogadores | Todos os jogadores, com ID, status e papel; toque para a ficha. |
Só admin — pessoas e suporte
| Comando | O que faz |
|---|---|
/admins, /staffs | Quem é quem. |
/incstaff | /remstaff | Promover ou tirar staff (lista). |
/incadmin | /remadmin | Promover ou tirar admin (lista). Admin fixo só sai pelo arquivo .env. |
/banir | Blacklist: o bot ignora o banido. |
↳ /banidos | Lista os banidos e desbane. |
/remover | Excluir um perfil (LGPD: anonimiza se já tem histórico). |
/ticket_suporte | Chamados de suporte abertos pelos jogadores no site: novo → em atendimento → aguardando usuário → concluído. |
| Digitando o ID | Todo comando de pessoa tem a variante _id: /incstaff_id 123, /posicionar_id 123 4. |
Só admin — temporada, campeonato e ladder
| Comando | O que faz |
|---|---|
/temporada | Criar temporada (a anterior encerra). |
↳ /temporadas | Lista as temporadas. |
↳ /temporada_datas | Alterar o início e o fim de uma temporada. |
/incchamp | /remchamp | Criar campeonato «em breve» | cancelar antes de iniciar. |
↳ /inic_insc | Abrir inscrições; seguidores do jogo e console são avisados com o comando. |
↳ /inic_champ | Fechar inscrições e montar o chaveamento (byes automáticos). |
/startgg_champ | Campeonato realizado no start.gg: a URL dele define a ladder. |
/definir | Definir ou anular o resultado de uma partida, desafio ou disputa. |
/cadastrar_ranking | Ladder extra num jogo (a de cada temporada já nasce com ela). |
/config_ranking | Parâmetros da instância: alcance, top, formato, prazos, escudo (defesas, mochila, duração), coringas de entrada, férias, inatividade, pesos. |
/posicionar | Colocar alguém numa posição da ladder (semear ou ajustar). |
/inccoringa | +1 coringa para um jogador. |
/varredura | Rodar agora os prazos da ladder (W.O. por aceite vencido, férias, rebaixamento semanal). |
/zerar_ranking | Recomeçar um jogo do zero na temporada: apaga campeonatos, ladder e partidas dele (jogadores, filtros e temporada ficam). Não tem volta. |
/arquivar, /arquivados, /reativar | Esconder temporada, campeonato, ranking ou jogo; ver o que está escondido; trazer de volta. /excluir_arquivado … confirmo apaga de vez. |
/report_global | Raio-x da plataforma. |
Só admin — catálogo de jogos e consoles
| Comando | O que faz |
|---|---|
/cadastrar_jogo | Jogo novo na plataforma: nome → consoles em que se joga (/zhumano para jogo sem console) → /ok. Para ter ladder na temporada: /cadastrar_ranking. |
/excluir_jogo | Tira um jogo do catálogo. Histórico, campeonatos e filtros ficam; ele some das listas e do site. Jogo da temporada ativa não sai. |
/jogo_url | Link do jogo no site (/jogo_url <jogo> <url> [rótulo]; para tirar, … remover <url>). |
/cadastrar_console | Console novo: nome → /ok. Aparece em /consoles e nos menus. |
/excluir_console | Tira um console do catálogo. Quem o tinha marcado continua com ele no histórico. |
Regras que o staff precisa saber de cor
- Nada pontua nem move antes da confirmação: um jogador reporta, o outro (ou o staff) confirma. No topo da ladder, só o staff.
- Quem é desafiado tem de aceitar. Sem resposta em 72 h, W.O. para quem desafiou (a varredura faz isso sozinha).
- Desafiar gasta 1 de energia; volta 1 a cada 40 min. Duas defesas vencidas com placar dão um escudo na mochila (7 dias); ativado, vale 24 h.
- Quem entra na ladder passa pela zona dos novatos: sem posição e sem ser desafiado até fechar o primeiro desafio.
- Coringa: 1 ao entrar na tabela, +1 campeão, +1 a cada 5 seguidas, +1 se o admin der.
- O bot e o site são a mesma base: o que um muda o outro mostra na hora.