Jogos & APIs
Descrição
Guia do Usuário
Conecte as APIs dos seus jogos ao seu servidor: seus membros vinculam a conta, consultam suas estatísticas, acompanham o estado dos servidores do jogo e se comparam em um ranking. 23 jogos vêm prontos para uso, e você pode adicionar outros por conta própria.
O que ele faz
- Permite que cada membro vincule sua conta de jogo ao servidor.
- Exibe estatísticas de jogador sob demanda.
- Publica o estado dos servidores de um jogo em uma mensagem mantida atualizada, e pode renomear um canal de voz contador.
- Divulga automaticamente as notícias de um jogo em um canal.
- Gera um ranking dos membros que vincularam sua conta.
- Oferece uma busca nas bases de dados de alguns jogos.
- Um construtor permite conectar qualquer API que devolva JSON, sem escrever código.
Início rápido (Admin)
- Abra o dashboard, módulo Jogos & APIs, aba Catálogo.
- Encontre seu jogo e clique em Ativar. As configurações do jogo se abrem em seguida.
- Se o jogo estiver marcado como "Chave obrigatória", cole sua chave de API no cartão Chave de API. Quando a indicação "Chave TennoCore" aparecer, uma chave já é fornecida e você não precisa fazer nada.
- Se quiser, ative as automações: Notícias, Status, Ranking — cada uma pede um canal e um intervalo.
- Use o botão Testar para verificar se a API responde e depois Salvar.
- Divulgue
/game listaos seus membros: nele eles veem os jogos disponíveis e vinculam a conta com/game link.
Comandos
Todos os comandos estão disponíveis a todos os membros e respondem em privado quando se trata de vincular uma conta.
| Comando | Descrição |
|---|---|
/game list | Lista os jogos ativados no servidor, com o que cada um sabe fazer. |
/game link | Abre um formulário para vincular sua conta ao jogo escolhido. |
/game unlink | Remove o vínculo da sua conta com esse jogo. |
/game stats | Exibe as estatísticas de um membro (você mesmo, por padrão). |
/game status | Exibe o estado dos servidores do jogo. |
/game lookup | Busca um item na base de dados do jogo. |
/game leaderboard | Classifica os membros do servidor que vincularam sua conta. |
Jogos que já vêm com o bot
23 conectores são fornecidos. Cada um oferece uma ou mais capacidades: Estatísticas de jogador, Status dos servidores, Notícias, Busca.
| Jogo | Capacidades | Chave de API |
|---|---|---|
| Apex Legends | Estatísticas de jogador | Obrigatória |
| Brawl Stars | Estatísticas de jogador | Obrigatória |
| Chess.com | Estatísticas de jogador | Não |
| Clash Royale | Estatísticas de jogador | Obrigatória |
| Destiny 2 | Estatísticas de jogador | Obrigatória |
| Epic Games – Jogos gratuitos | Notícias | Não |
| Fortnite | Estatísticas de jogador | Obrigatória |
| Free-To-Game – Lançamentos F2P | Notícias, Busca | Não |
| Genshin Impact | Estatísticas de jogador | Não |
| Hypixel (Minecraft) | Estatísticas de jogador | Obrigatória |
| League of Legends | Estatísticas de jogador, Status dos servidores | Obrigatória |
| Lichess | Estatísticas de jogador | Não |
| Minecraft – Jogador | Estatísticas de jogador | Não |
| Minecraft – Servidor | Status dos servidores | Não |
| osu! | Estatísticas de jogador | Obrigatória |
| Pokédex (PokéAPI) | Busca | Não |
| RAWG – Base de dados de jogos | Busca, Notícias | Obrigatória |
| Roblox | Estatísticas de jogador | Não |
| Status (Statuspage genérico) | Status dos servidores | Não |
| Steam – Notícias de um jogo | Notícias | Não |
| Steam – Perfil | Estatísticas de jogador | Obrigatória |
| Valorant | Estatísticas de jogador | Obrigatória |
| Warframe – Mundo | Status dos servidores, Notícias | Não |
Configuração pelo dashboard
O módulo é composto por cinco abas.
- Catálogo — todos os jogos disponíveis, filtráveis por categoria ou por nome. Cada cartão indica as capacidades do jogo e se ele precisa de chave. Botões Ativar, Duplicar (para partir de um conector existente) e link para a documentação da API.
- Meus jogos — os jogos ativados neste servidor: estado, automações ativas, número de contas vinculadas, origem da chave, último incidente registrado. O botão Configurar abre as opções:
- Geral: jogo ativo ou pausado, e cargo atribuído automaticamente ao membro que vincula a conta.
- Chave de API: sua chave, armazenada de forma criptografada e nunca reexibida. Deixe o campo vazio para não alterar nada.
- Parâmetros do conector: as configurações próprias do jogo (ID de aplicativo Steam, região…).
- Notícias: canal, intervalo (5 a 1440 minutos, 30 por padrão) e menção opcional a um cargo.
- Status: canal do painel, intervalo (10 minutos por padrão) e canal de voz contador com o modelo de nome a ser usado.
- Ranking: canal, intervalo (60 minutos por padrão) e indicação da estatística de referência.
- Cada automação tem um botão Publicar agora.
- Construtor — criação de um conector próprio: informações gerais, autenticação, campos solicitados ao membro, etapas de chamada e descrição da mensagem a produzir. Um banco de testes faz uma chamada real e exibe a árvore da resposta: clique em um valor para copiar seu caminho e reutilizá-lo na exibição.
- Jogadores — todas as contas vinculadas do servidor, com a possibilidade de desvincular um membro.
- Registro — as 50 últimas chamadas às APIs, com duração, resultado e detalhe do erro.
Bom saber
- Um jogo precisa estar ativado para existir. O preenchimento automático dos comandos só oferece os jogos ativados, e apenas aqueles compatíveis com o comando usado: um jogo que só fornece notícias não aparecerá em
/game stats. - O vínculo é verificado imediatamente.
/game linkfaz uma chamada real à API: se a conta não for encontrada, nada é salvo e o membro recebe o erro devolvido pelo jogo. Uma conta vinculada é, portanto, sempre uma conta que funciona. - O formulário de vínculo é limitado a 5 campos, limite imposto pelo Discord.
- Chaves de API em modo híbrido: sua chave sempre tem prioridade; na falta dela, a chave global do TennoCore é usada, quando existir. Informar a sua lhe dá sua própria cota. Uma chave salva nunca é reexibida na interface.
- Cotas: cada conector define seu limite de chamadas (30 por minuto e por servidor, em geral). Acima disso, o bot responde que é preciso aguardar um minuto. As respostas ficam em cache por alguns minutos, o que absorve pedidos repetidos.
- Ranking: no máximo 40 contas vinculadas são consultadas e as 20 primeiras exibidas. As chamadas são deliberadamente espaçadas para não esgotar a cota do servidor — prefira um intervalo amplo se muitos membros estiverem vinculados. O ranking fica vazio se o conector não definir uma estatística de referência.
- Primeira passagem de um feed de notícias: nada é publicado, o bot apenas registra o histórico existente. Isso é intencional, para não inundar o canal. As publicações começam na passagem seguinte.
- Canal de voz contador: o Discord permite apenas 2 renomeações a cada 10 minutos. Um intervalo muito curto será silenciosamente ignorado pelo Discord.
/game listexibe no máximo 25 jogos, e o preenchimento automático, 25 sugestões.- Remover um jogo apaga suas configurações e o histórico de notícias, mas mantém as contas vinculadas dos membros.
- As mensagens do módulo usam o novo formato de exibição do Discord: cada campo ocupa sua própria linha, não há disposição em colunas.
- Conectores próprios: os endereços chamados devem apontar para uma API pública. Qualquer endereço interno ou privado é recusado, por segurança.
- O registro de chamadas é mantido por 7 dias.
- O módulo está na categoria "Em desenvolvimento" do dashboard: sua interface ainda pode mudar.