Por qué importa la integración con Discord
Discord es el hub central de comunicación de prácticamente toda comunidad de FiveM, por lo que integrar tu servidor de Discord con el de juego es esencial para una operativa fluida. La integración permite sincronización automática de roles para que los jugadores con roles de whitelist puedan conectar, logging de eventos in-game como entradas, kills y baneos hacia canales de Discord, y actualizaciones de estado en tiempo real mostrando número de jugadores y salud del servidor. Un bot bien configurado convierte la gestión de comunidad de un proceso manual en un sistema automatizado que funciona 24/7. Más allá de la comodidad, la integración también aporta una capa de seguridad, dejándote verificar identidades y controlar el acceso mediante roles de Discord en lugar de depender solo de sistemas in-game.
Configurar webhooks de Discord
La forma más sencilla de integración son los webhooks, que permiten a tu servidor de FiveM enviar mensajes a canales concretos de Discord sin necesidad de una aplicación bot completa. Creas una URL de webhook en los ajustes del canal y la usas desde tus scripts de FiveM para publicar mensajes con formato. Los webhooks son perfectos para sistemas de logging donde quieras registrar eventos como conexiones, desconexiones, acciones de admin, compras y actividad sospechosa. En tus scripts Lua del servidor puedes usar la native PerformHttpRequest para enviar peticiones POST a la URL del webhook con contenido embebido. Estructura los mensajes usando el formato embed de Discord para obtener logs limpios y legibles con timestamps, identificadores de jugador y niveles de severidad codificados por color que faciliten monitorizar la actividad de tu servidor.
Construir un bot de Discord
Para integraciones más avanzadas querrás un bot completo que pueda enviar y recibir información. Un bot puede responder a comandos de la comunidad, consultar estadísticas de jugadores, procesar solicitudes de whitelist e incluso controlar funciones del servidor como reinicios o gestión de recursos directamente desde Discord. Construye tu bot con discord.js para JavaScript o discord.py para Python y alójalo en la misma máquina que tu servidor de FiveM o en un VPS aparte. El bot se comunica con tu servidor de FiveM a través de una base de datos compartida, una API REST expuesta por un recurso de FiveM o peticiones HTTP directas entre los dos sistemas. Mantén seguro el token del bot y no lo expongas nunca en repos públicos ni en código del lado del cliente.
Whitelist y sincronización de roles
El whitelisting basado en Discord es el método de control de acceso más común para servidores de rol serios. Los jugadores deben estar en tu Discord y tener un rol concreto antes de poder conectar al servidor de juego. Recursos como badger_discordapi o soluciones propias comprueban en tiempo real los roles de Discord del jugador que conecta y permiten o deniegan el acceso. La sincronización de roles va un paso más allá y mantiene los roles de Discord y los permisos in-game alineados en ambas direcciones. Si a un jugador lo ascienden a sargento de policía in-game, su rol de Discord se actualiza solo. Cuando un admin asigna un rol de whitelist en Discord, el jugador gana acceso in-game en su próxima conexión. Esta integración reduce mucho la carga administrativa y asegura coherencia entre la estructura de la comunidad en Discord y la jerarquía in-game.
Buenas prácticas de logging
Un logging efectivo mediante Discord es de las herramientas más valiosas para administrar y moderar el servidor. Crea canales dedicados para distintas categorías de log: conexiones, transacciones económicas, acciones de admin, combates y reportes. Cada entrada debería incluir el ID de servidor del jugador, su ID de Discord, nombre del personaje y un timestamp para poder cruzar eventos rápidamente durante las investigaciones. Aplica rate limiting a tus llamadas de webhook para no chocar con los límites de la API de Discord, que pueden desactivar temporalmente tus webhooks. Para eventos muy frecuentes como spawns de vehículo o acciones de inventario, plantéate agrupar varios eventos en un único mensaje enviado a intervalos en lugar de disparar un webhook por cada acción individual. Guarda los logs detallados en tu base de datos como registro principal y usa Discord como una interfaz de monitorización cómoda.