Juegos y API
Descripción
Guía de Usuario
Conecte las API de sus juegos a su servidor: sus miembros vinculan su cuenta, consultan sus estadísticas, siguen el estado de los servidores del juego y se comparan en una clasificación. Se incluyen 23 juegos listos para usar, y usted mismo puede añadir más.
Qué hace
- Permite a cada miembro vincular su cuenta de juego al servidor.
- Muestra estadísticas de jugador a petición.
- Publica el estado de los servidores de un juego en un mensaje que se mantiene actualizado, y puede renombrar un canal de voz contador.
- Difunde automáticamente las noticias de un juego en un canal.
- Genera una clasificación de los miembros que han vinculado su cuenta.
- Ofrece una búsqueda en las bases de datos de algunos juegos.
- Un constructor permite conectar cualquier API que devuelva JSON, sin escribir código.
Inicio Rápido (Admin)
- Abra el panel de control, módulo Juegos y API, pestaña Catálogo.
- Busque su juego y haga clic en Activar. Los ajustes del juego se abren de inmediato.
- Si el juego está marcado como «Clave requerida», pegue su clave de API en la tarjeta Clave de API. Cuando aparece la mención «Clave TennoCore», ya se proporciona una clave y no tiene que hacer nada.
- Active si lo desea las automatizaciones: Noticias, Estado, Clasificación — cada una requiere un canal y un intervalo.
- Use el botón Probar para comprobar que la API responde y luego Guardar.
- Anuncie
/game lista sus miembros: allí verán los juegos disponibles y vincularán su cuenta con/game link.
Comandos
Todos los comandos son accesibles a todos los miembros y responden en privado cuando se trata de una vinculación de cuenta.
| Comando | Descripción |
|---|---|
/game list | Lista los juegos activados en el servidor, con lo que cada uno sabe hacer. |
/game link | Abre un formulario para vincular su cuenta al juego elegido. |
/game unlink | Elimina la vinculación de su cuenta para ese juego. |
/game stats | Muestra las estadísticas de un miembro (usted mismo por defecto). |
/game status | Muestra el estado de los servidores del juego. |
/game lookup | Busca un elemento en la base de datos del juego. |
/game leaderboard | Clasifica a los miembros del servidor que han vinculado su cuenta. |
Juegos incluidos con el bot
Se proporcionan 23 conectores. Cada uno expone una o varias capacidades: Estadísticas de jugador, Estado de servidores, Noticias, Búsqueda.
| Juego | Capacidades | Clave de API |
|---|---|---|
| Apex Legends | Estadísticas de jugador | Requerida |
| Brawl Stars | Estadísticas de jugador | Requerida |
| Chess.com | Estadísticas de jugador | No |
| Clash Royale | Estadísticas de jugador | Requerida |
| Destiny 2 | Estadísticas de jugador | Requerida |
| Epic Games – Juegos gratuitos | Noticias | No |
| Fortnite | Estadísticas de jugador | Requerida |
| Free-To-Game – Lanzamientos F2P | Noticias, Búsqueda | No |
| Genshin Impact | Estadísticas de jugador | No |
| Hypixel (Minecraft) | Estadísticas de jugador | Requerida |
| League of Legends | Estadísticas de jugador, Estado de servidores | Requerida |
| Lichess | Estadísticas de jugador | No |
| Minecraft – Jugador | Estadísticas de jugador | No |
| Minecraft – Servidor | Estado de servidores | No |
| osu! | Estadísticas de jugador | Requerida |
| Pokédex (PokéAPI) | Búsqueda | No |
| RAWG – Base de datos de juegos | Búsqueda, Noticias | Requerida |
| Roblox | Estadísticas de jugador | No |
| Estado (Statuspage genérico) | Estado de servidores | No |
| Steam – Noticias de un juego | Noticias | No |
| Steam – Perfil | Estadísticas de jugador | Requerida |
| Valorant | Estadísticas de jugador | Requerida |
| Warframe – Mundo | Estado de servidores, Noticias | No |
Ajustes desde el panel de control
El módulo se compone de cinco pestañas.
- Catálogo — todos los juegos disponibles, filtrables por categoría o por nombre. Cada tarjeta indica las capacidades del juego y si necesita clave. Botones Activar, Duplicar (para partir de un conector existente) y enlace a la documentación de la API.
- Mis juegos — los juegos activados en este servidor: estado, automatizaciones activas, número de cuentas vinculadas, origen de la clave, último incidente registrado. El botón Configurar abre los ajustes:
- General: juego activo o en pausa, y rol asignado automáticamente al miembro que vincula su cuenta.
- Clave de API: su clave, almacenada cifrada y nunca mostrada de nuevo. Deje el campo vacío para no cambiar nada.
- Parámetros del conector: los ajustes propios del juego (identificador de aplicación de Steam, región…).
- Noticias: canal, intervalo (5 a 1440 minutos, 30 por defecto) y mención opcional de un rol.
- Estado: canal del panel, intervalo (10 minutos por defecto) y canal de voz contador con la plantilla de nombre que usar.
- Clasificación: canal, intervalo (60 minutos por defecto) y recordatorio de la estadística de referencia.
- Cada automatización dispone de un botón Publicar ahora.
- Constructor — creación de un conector propio: información general, autenticación, campos solicitados al miembro, pasos de llamada y descripción del mensaje que se producirá. Un banco de pruebas lanza una llamada real y muestra el árbol de la respuesta: haga clic en un valor para copiar su ruta y reutilizarla en la visualización.
- Jugadores — todas las cuentas vinculadas del servidor, con la posibilidad de desvincular a un miembro.
- Registro — las 50 últimas llamadas salientes hacia las API, con duración, resultado y detalle del error.
Bueno saberlo
- Un juego debe estar activado para existir. El autocompletado de los comandos solo propone los juegos activados, y únicamente los compatibles con el comando utilizado: un juego que solo ofrece noticias no aparecerá en
/game stats. - La vinculación se comprueba de inmediato.
/game linklanza una llamada real a la API: si no se encuentra la cuenta, no se guarda nada y el miembro recibe el error devuelto por el juego. Una cuenta vinculada es por tanto siempre una cuenta que funciona. - El formulario de vinculación está limitado a 5 campos, límite impuesto por Discord.
- Claves de API en modo híbrido: su clave tiene siempre prioridad; en su defecto, se utiliza la clave global de TennoCore cuando existe. Introducir la suya le da su propia cuota. Una clave guardada nunca se vuelve a mostrar en la interfaz.
- Cuotas: cada conector define su límite de llamadas (30 por minuto y por servidor en general). Por encima de ese límite, el bot responde que hay que esperar un minuto. Las respuestas se almacenan en caché unos minutos, lo que absorbe las peticiones repetidas.
- Clasificación: se consultan como máximo 40 cuentas vinculadas y se muestran las 20 primeras. Las llamadas se espacian a propósito para no agotar la cuota del servidor — prevea un intervalo amplio si hay muchos miembros vinculados. La clasificación queda vacía si el conector no define ninguna estadística de referencia.
- Primera pasada de un feed de noticias: no se publica nada, el bot solo registra el historial existente. Es intencionado, para no inundar el canal. Las publicaciones empiezan en la pasada siguiente.
- Canal de voz contador: Discord solo permite 2 cambios de nombre por cada 10 minutos. Un intervalo demasiado corto será ignorado en silencio por Discord.
/game listmuestra como máximo 25 juegos, y el autocompletado 25 propuestas.- Retirar un juego borra sus ajustes y el historial de noticias, pero conserva las cuentas vinculadas de los miembros.
- Los mensajes del módulo utilizan el nuevo formato de visualización de Discord: cada campo ocupa su propia línea, no hay disposición en columnas.
- Conectores propios: las direcciones llamadas deben apuntar a una API pública. Cualquier dirección interna o privada se rechaza, por seguridad.
- El registro de llamadas se conserva 7 días.
- El módulo figura en la categoría «En desarrollo» del panel de control: su interfaz aún puede cambiar.