Un bot de Discord para servidores de FiveM con ESX, QBCore, Qbox, ox_core y vRP
Por Termi5 min de lectura
FiveBot es un bot de Discord para tickets, moderación y respuestas con IA a partir de tus propias normas. También incluye un recurso de FiveM, fivebot_bridge, que conecta tu servidor de juego con el mismo panel. La parte de Discord funciona sin él. Con él, los tickets, los reportes y los baneos saben quién es el jugador en la ciudad.
Qué funciona sin el servidor de juego
Todo lo que ocurre en Discord funciona en cualquier servidor, sea de FiveM o no. En todos los planes tienes paneles de tickets con asignación libre y transcripciones permanentes, anti-spam, anti-raid y anti-nuke, solicitudes en formularios web, roles por reacción y comandos personalizados. Desde Starter, los tickets también tienen respuestas de IA con cita de tus normas, traducción en los dos sentidos y Hollo, una burbuja de chat para tu web.
Muchas comunidades de FiveM empiezan por ahí e instalan el bridge cuando la parte de Discord ya está asentada.
Qué añade el bridge
El bridge funciona en todos los planes. Es un solo recurso, sin dependencias obligatorias, y añade las partes que necesitan el juego. La tarjeta del jugador necesita Starter, y el desarrollador con IA y los NPC con IA necesitan Pro.
- Un contador de jugadores en directo en un canal de Discord, que se envía cada dos minutos.
- Baneos, advertencias, expulsiones y baneos levantados desde txAdmin, cada uno con el admin que lo puso y el motivo. Nueve anticheats, entre ellos WaveShield, Fiveguard y ElectronAC, también reportan los suyos, y cada baneo llega con lo que el servidor vio hacer al jugador antes. Cualquier otro menú de admin o anticheat puede reportar con un solo export. Cómo llegan las acciones de txAdmin a FiveBot.
- Reportes en el juego. Un jugador escribe
/report 12 shot me at the banky tu staff recibe la misma tarjeta de reporte que uno de Discord, con los dos personajes y la distancia entre ellos. Más sobre los reportes en el juego. - Pagos de la tienda. Cuando un jugador dice que una compra no le llegó, FiveBot se lo pregunta al bridge y el bridge se lo pregunta a la tienda. Tebex funciona por sí solo, Skalp se conecta solo y cualquier otra tienda puede conectarse con un export. Cómo gestionar el "pagué y no me llegó nada".
- Errores de scripts de la consola del servidor, reunidos en el panel sin contraseñas, tokens, direcciones IP ni correos. Recibes un correo cuando se disparan y un resumen breve una vez al día. Alertas de errores de scripts.
- Una tarjeta del jugador en el panel con dinero, objetos, trabajo y coches, y cambios como dar dinero o poner un trabajo con un botón. Revisar a un jugador.
- Cambios de configs y scripts a partir de una petición sencilla, que ves antes de que se guarden y que se deshacen si el script falla. El desarrollador con IA.
- Cada comando que ejecuta tu staff en el servidor de juego, por admin. El registro de comandos de admin.
- NPC con IA que están en tu ciudad y hablan con los jugadores. Cómo funcionan.
Frameworks que lee
Al arrancar, el bridge busca un framework y lee el nombre, el trabajo, el rango y la banda de un personaje. Así un NPC saluda a un policía por su rango y una tarjeta de reporte nombra a los personajes implicados.
| Framework | Recurso | Qué lee |
|---|---|---|
| ESX Legacy y ESX anteriores | es_extended | Nombre, trabajo, etiqueta del rango y el trabajo oculto como banda en los forks que lo tienen |
Forks de ESX con GetPlayerFromIdClass | es_extended | Nombre y apellido, trabajo, etiqueta del rango, trabajo oculto |
| Qbox | qbx_core | Datos del personaje, trabajo, rango, banda |
| QBCore | qb-core | Datos del personaje, trabajo, rango, banda |
| ox_core | ox_core | Nombre del personaje, grupo activo y su rango |
| vRP (versiones vRPex) | vrp | Identidad y el grupo de tipo trabajo |
Sin framework, el bridge funciona solo con los identificadores del jugador, y es una configuración admitida. Si un framework arranca después del bridge, se detecta cuando arranca. Para forzar uno, pon fivebot_framework en esx, qbcore, qbox, ox, vrp o none. Un núcleo renombrado se encuentra por sus exports, igual que el inventario y el script médico. Frameworks e inventarios compatibles.
Instalación
- En el panel, abre Ajustes, Puente con el servidor de juego, descarga
fivebot_bridgey crea un token de servidor. El secreto compartido se muestra una sola vez, así que cópialo enseguida. - Pon
fivebot_bridgeenresources/. - Añade las líneas de abajo a
server.cfgy reinicia. Si falta alguna línea, la consola del servidor dice cuál.
set fivebot_api_url "https://api.fivebot.ai"
set fivebot_server_token "srv_..."
set fivebot_shared_secret "..."
ensure fivebot_bridge
El token y el secreto viven en server.cfg, fuera de la carpeta del recurso. Los recursos se copian, se comprimen y se comparten, y un token dentro de la carpeta viajaría con cada copia.
Los personajes con IA los genera el servidor y necesitan OneSync, que txAdmin activa por defecto. Todo lo demás funciona sin él. ox_lib, oxmysql y un framework son opcionales.
Qué deja en paz
FiveM informa un identificador ip: junto con los demás, y el bridge lo descarta antes de guardar o enviar nada. Tampoco guarda ninguna lista de baneos en tu servidor: los baneos se consultan a FiveBot cuando hace falta.
Los archivos de lógica del bridge están ofuscados. Dos archivos siguen siendo legibles y son tuyos para editar: config.lua para los tiempos y client/chat.lua para cómo llegan al jugador las líneas de FiveBot. Una actualización reemplaza todo lo demás, así que guarda tus cambios en esos dos.
Cuánto tráfico genera
Las entradas y salidas se envían en lotes cada dos segundos, nunca una petición por evento. El contador de jugadores se envía cada dos minutos. El bridge comprueba si hay acciones del panel cada tres a cuatro segundos y medio. Cuando no se puede llegar a la API, cada ruta que falla se registra una vez, y otra vez cuando se recupera, así que un token incorrecto no inunda la consola.
Preguntas frecuentes
¿Necesito Pro para el bot de Discord?
No. Entry y Starter incluyen tickets, moderación, seguridad y, en Starter, respuestas de IA y Hollo. El bridge funciona en todos los planes y lee los datos de personaje de ESX, QBCore, Qbox, ox_core o vRP. Los NPC con IA y Bodycam empiezan en Pro. Los precios actuales están en fivebot.ai/pricing.
¿Funciona con txAdmin desde el primer momento?
Sí. El bridge escucha los eventos propios de txAdmin, así que los baneos, las advertencias y las expulsiones llegan sin configurar nada en txAdmin.
¿Puedo usarlo junto a mis otros bots?
Sí. FiveBot no tiene que ser el único bot del servidor, así que puedes mantener tu bot de tickets actual mientras comparas.
¿FiveBot tiene alguna relación con Cfx.re?
No. FiveBot no tiene ninguna relación con Cfx.re, Rockstar Games ni Take-Two Interactive.