Whitelist FiveM con Discord y txAdmin: guía completa
Con txAdmin, la whitelist de tu servidor FiveM puede depender de un solo rol de Discord: los jugadores con el rol @Whitelist entran, los demás se quedan en la puerta. Añade un bot de postulaciones que dé ese rol cuando tu staff acepta, y aceptar una postulación basta para meter a un jugador en la whitelist. Sin licencias que copiar ni comandos de consola.
Toscio funciona con la whitelist por rol de Discord de txAdmin: el rol que se da al aceptar deja entrar al jugador. Esta guía lleva unos 15 minutos, de cero a tu primera postulación aceptada.
Cómo funciona
Tres piezas, una tarea cada una:
| Pieza | Qué hace |
|---|---|
| El rol @Whitelist | La llave de tu servidor FiveM |
| Toscio | Recibe las postulaciones en Discord y da el rol cuando el staff acepta |
| txAdmin | Comprueba el rol en cada conexión y rechaza a quien no lo tiene |
Para el jugador: entra a tu Discord, hace clic en Postular, rellena el formulario de whitelist, recibe un MD de «solicitud aceptada», abre FiveM y se conecta. Nadie de tu equipo tuvo que abrir txAdmin.
Esta guía sigue los menús de txAdmin 8 que vienen con las versiones recientes de FXServer. Los nombres de las opciones pueden moverse un poco de una versión a otra.
Antes de empezar
Necesitas:
- un servidor FiveM con txAdmin, y una cuenta de txAdmin con permiso para cambiar los ajustes;
- el permiso Gestionar servidor en tu Discord;
- el Modo desarrollador de Discord, para copiar los ID: Ajustes de usuario → Avanzado → Modo desarrollador.
1. Crea el rol @Whitelist
- En tu Discord, abre Ajustes del servidor → Roles → Crear rol.
- Llámalo Whitelist (o WL, Ciudadano… el nombre da igual).
- Haz clic derecho en el rol y elige Copiar ID del rol. Guarda ese número a mano.
¿Haces una entrevista de aduana o una etapa de visitante? Crea también un rol @Visitante: Toscio puede quitarlo cuando se acepta la postulación.
2. Crea el bot de Discord de txAdmin
txAdmin necesita su propio bot para leer los roles de tus jugadores. No es Toscio: es tu propio bot, que solo usa txAdmin.
- Ve al Discord Developer Portal y haz clic en New Application. Ponle el nombre de tu servidor.
- En la pestaña Bot, haz clic en Reset Token y copia el token. No lo compartas nunca: da el control total del bot.
- Todavía en Bot, activa Server Members Intent y guarda. Sin él, txAdmin no ve los roles.
- En OAuth2 → URL Generator, marca el scope bot, abre el enlace generado y añade el bot a tu servidor de Discord.
Si guardar los ajustes de Discord en txAdmin falla o se queda colgado, casi siempre es por el Server Members Intent.
3. Conecta el bot en txAdmin
- En txAdmin, abre Settings y luego la pestaña Discord.
- Activa Discord Bot.
- Pega el token en Token.
- En Guild/Server ID, pega el ID de tu servidor de Discord (clic derecho en el nombre del servidor, Copiar ID del servidor).
- Guarda.
4. Pasa txAdmin a una whitelist por rol de Discord
- Todavía en Settings, abre la pestaña Whitelist.
- En Allowlist Mode, elige Discord Server Roles.
- En Allowlisted Discord Roles, pega el ID del rol @Whitelist. Puedes añadir varios, separados por comas (por ejemplo @Whitelist y @Staff).
- En Allowlist Instructions, explica a los jugadores rechazados cómo postularse, por ejemplo: «Entra a discord.gg/tuservidor y postúlate en #postular.»
- Guarda.
A partir de ahora, txAdmin rechaza a todos los jugadores sin el rol. Dátelo a ti y a tu staff antes de probar.
5. Recibe las postulaciones con Toscio
Solo falta dar el rol automáticamente.
- Añade Toscio a tu Discord.
- En Ajustes del servidor → Roles, arrastra el rol Toscio por encima de @Whitelist. Discord solo deja que un bot dé roles que estén por debajo del suyo.
- Usa
/toscio setupcon:template: Whitelist RP;channel: donde se postulan los jugadores, por ejemplo#postular;staff-channel: un canal privado para tu equipo de whitelist, por ejemplo#staff-wl;role: @Whitelist;staff-role: tu rol del staff de whitelist, si tienes uno.
Toscio publica el panel con el botón Postular y te confirma adónde llegarán las solicitudes. Tu primer formulario incluye 14 días de Premium gratis, sin tarjeta: la whitelist completa con todas sus preguntas.
Para elegir tus preguntas, revisa las 53 preguntas para la whitelist FiveM y luego edita el formulario en el editor de formulario. En los ajustes del formulario también puedes hacer que se quite @Visitante al aceptar.
6. Prueba todo el proceso
Con una segunda cuenta de Discord, o con un amigo:
- Haz clic en Postular, rellena la whitelist y envíala.
- En
#staff-wl, haz clic en Aceptar en la ficha de la solicitud. - Comprueba que la cuenta recibió @Whitelist y el MD de confirmación.
- Abre la aplicación de escritorio de Discord, inicia FiveM y conéctate: entras.
- Quita el rol y vuelve a intentarlo: txAdmin te rechaza con tu mensaje de instrucciones.
Lo que ve tu staff
Cada solicitud llega al canal del staff con las respuestas, la antigüedad de la cuenta de Discord y cuándo entró el jugador a tu servidor, además de tres botones:
- Aceptar: Toscio da @Whitelist y envía un MD al jugador en su idioma. Puede conectarse al momento.
- Rechazar: con un motivo, para que el jugador sepa qué mejorar. Una espera de 24 horas (ajustable) frena el spam de postulaciones.
- Entrevista: se abre un hilo privado con el jugador. Útil para hacerle más preguntas por escrito.
¿Haces una entrevista por voz (la aduana) antes de dejar entrar a los jugadores? Activa la etapa antes de la aceptación final en el editor de formulario y llámala «Entrevista». El botón verde de la ficha pasa a ser Validar → Entrevista: el jugador recibe un rol @Entrevista y un MD con la hora, y tu staff recibe un recordatorio si la entrevista se alarga. Después, Aceptar da @Whitelist y quita @Entrevista. La etapa es gratuita.
Errores frecuentes
| Mensaje o síntoma | Causa | Solución |
|---|---|---|
| “You do not have the discord identifier” | FiveM no encuentra la cuenta de Discord del jugador | Abrir la aplicación de escritorio de Discord (no el navegador) antes de iniciar FiveM |
| “You are required to join our Discord server” | El jugador no está en el Discord configurado en txAdmin | Revisar el Guild/Server ID, y que el jugador entró al servidor correcto |
| “You do not have a allowlisted role” | Al jugador le falta el rol, o el ID pegado es incorrecto | Revisar el ID del rol en la pestaña Whitelist |
| Aceptar falla en Toscio | El rol de Toscio está por debajo de @Whitelist | Subir el rol de Toscio en Ajustes del servidor → Roles |
| txAdmin no guarda los ajustes de Discord | Falta el intent | Activar Server Members Intent en el Developer Portal |
El jugador tiene que usar la misma cuenta de Discord con la que se postuló: txAdmin comprueba el rol de la cuenta de Discord abierta en su PC.
¿Y la whitelist por licencia?
txAdmin también ofrece el modo Approved License: cada jugador tiene que aprobarse a mano en la página Allowlist de txAdmin, con un ID de solicitud. Funciona, pero alguien de tu equipo tiene que hacerlo con cada jugador, además de leer su postulación.
Con un rol de Discord, la decisión y el acceso son lo mismo. Quitar el rol quita el acceso, puedes meter a tu staff en la whitelist con un segundo rol, y todo el historial de la whitelist se queda en Discord.
Para ir más lejos
- Apelaciones de ban: un jugador baneado de tu Discord ya no puede postularse. Con el formulario web y las apelaciones de ban, apela desde una página web y Toscio lo desbanea si tu staff acepta.
- Votos del staff (Premium): varios miembros del staff de whitelist votan cada solicitud, y Toscio decide cuando hay votos suficientes.
- Quiz de normas: 3 o 4 preguntas de opción puntuadas (RDM, NLR, metagaming…) con un mínimo para aprobar. Un jugador que suspende se rechaza automáticamente y recibe su nota, nunca las respuestas correctas. Es gratis.
- Webhooks hacia tu CAD/MDT (Premium): cada solicitud recibida, pasada a la etapa, aceptada o rechazada se envía en JSON firmado a la dirección https que elijas (CAD/MDT, hoja de cálculo, script). Toscio no tiene recurso FiveM dentro del juego: es tu propia herramienta la que recibe el evento y hace con él lo que quieras.
- Postularse antes de entrar al Discord (Premium): txAdmin exige que el jugador esté en tu Discord. Con el formulario web abierto a personas que aún no están en el servidor, se postula desde tu web; una vez aceptado, entra a tu Discord en un clic con @Whitelist y puede conectarse a FiveM.
- Varios formularios: whitelist civil, policía, EMS, staff… cada uno con su rol y su canal. Mira la página de la whitelist FiveM.
¿Dudas con FiveApply? Mira Toscio vs FiveApply.
Preguntas
¿Cómo hago la whitelist de FiveM con Discord?
En txAdmin, activa el bot de Discord (pestaña Discord) y luego elige el modo “Discord Server Roles” en la pestaña Whitelist y pega el ID de tu rol @Whitelist. Solo los jugadores con ese rol en tu Discord pueden conectarse. Un bot de postulaciones como Toscio da el rol cuando tu staff acepta la postulación.
¿Por qué un jugador recibe “You do not have the discord identifier”?
FiveM no encontró su cuenta de Discord. El jugador tiene que abrir la aplicación de escritorio de Discord (no la versión del navegador) antes de iniciar FiveM, y volver a conectarse.
¿txAdmin necesita su propio bot de Discord además de Toscio?
Sí. txAdmin usa su propio bot, creado en el Discord Developer Portal, para leer los roles de los jugadores. Toscio gestiona las postulaciones y da el rol. Los dos funcionan a la vez sin molestarse.
¿Cómo saco a alguien de la whitelist?
Quítale el rol @Whitelist en Discord. txAdmin comprueba el rol en cada conexión, así que se le rechazará en su próximo intento.
¿La whitelist por rol de Discord funciona con ESX y QBCore?
Sí. txAdmin hace la comprobación cuando el jugador se conecta, antes de que intervenga el framework. Funciona igual con ESX, QBCore, Qbox o un framework propio.


