Cómo configurar una lista blanca de Discord para FiveM (Guía 2026)

Administrar un servidor de FiveM es un trabajo duro. Pasas horas configurando scripts y coches, así que lo último que quieres es que trolls aleatorios arruinen la diversión. Necesitas controlar quién entra.

La mejor manera de hacerlo es con una Lista blanca de Discord. Esto vincula tu servidor de juego a tu servidor de Discord. Si un jugador no está en tu Discord o no tiene el rol correcto, no puede unirse al juego. Es así de simple.

En esta guía, te mostraré exactamente cómo configurarlo usando los dos mejores métodos para 2026.

El Portal de Desarrolladores de Discord

Antes de descargar cualquier script, tienes que configurar tu bot de Discord. Aquí es donde la mayoría de la gente se atasca, así que sigue estos pasos cuidadosamente.

1. Crear la aplicación

   Ve al Portal de Desarrolladores de Discord. Haz clic en Nueva aplicación y nómbrala como "Server Gatekeeper". Luego, haz clic en la pestaña Bot de la izquierda y haz clic en "Añadir bot".

2. Activa los Intents

   Esta es la parte más importante. Desplázate hasta la sección "Privileged Gateway Intents". Debes activar el Server Members Intent. Si no lo haces, el bot no podrá ver quién está en tu servidor y la lista blanca fallará.

3. Obtén tus claves

   Necesitas tres cosas. Copia tu Token de bot (de la pestaña Bot), tu ID de cliente (de la pestaña OAuth2) y tu ID de gremio (Haz clic derecho en el icono de tu servidor en Discord y haz clic en "Copiar ID"). Guarda esto en un bloc de notas para más tarde.

Destacado

Haz que la espera valga la pena

Una lista blanca segura es vital, pero también añade una barrera de entrada. Una vez que los jugadores son aprobados, no los pierdas por una aburrida pantalla de carga. Nuestra Plantilla Night Raid ofrece una introducción profesional y animada a tu mundo.

Obtener la plantilla

Método 1: El stack "Badger" (ideal para servidores de rol)

Si tienes un servidor de rol, probablemente necesites diferentes permisos para diferentes personas. Por ejemplo, es posible que quieras que la policía tenga acceso a un menú especial, o que los donantes tengan acceso a coches especiales. La mejor manera de hacerlo es combinando dos scripts: Badger_Discord_API y DiscordAcePerms.

• Badger_Discord_API

  Este script hace el trabajo pesado. Se comunica con Discord y recuerda los datos para que tu servidor no se vea limitado por la tasa de solicitudes. Descárgalo aquí.

• DiscordAcePerms

  Este script vincula tus roles de Discord con los permisos de FiveM. Descárgalo aquí.

Cómo instalarlo

Descarga ambas carpetas y colócalas en tu carpeta de recursos. Debes renombrar las carpetas exactamente a Badger_Discord_API y DiscordAcePerms. Elimina cualquier texto adicional como "-master" o los scripts no funcionarán.

A continuación, abre tu archivo server.cfg y añade estas líneas. El orden importa:

# Start the API first
ensure Badger_Discord_API

# Give AcePerms permission to change server settings
add_ace resource.DiscordAcePerms command.add_principal allow
add_ace resource.DiscordAcePerms command.remove_principal allow

# Start the Permission script
ensure DiscordAcePerms

Finalmente, ve a la carpeta DiscordAcePerms y abre config.lua. Verás una lista donde puedes pegar tus ID de rol.

roleList = {
    -- {DiscordRoleID, "AceGroup"}
    {123456789012345678, "group.admin"}, 
    {987654321098765432, "group.member"},
}

Método 2: txAdmin (el método más fácil)

Si no quieres lidiar con archivos de código, puedes usar txAdmin. Este es el panel web que viene con FiveM. Tiene una lista blanca incorporada que es muy fácil de usar.

1. Abrir configuración

   Ve a tu página de txAdmin en tu navegador (normalmente localhost:40120). Haz clic en Configuración y luego en Bot de Discord.

2. Introducir claves

   Pega el Token, el ID de cliente y el ID de gremio que guardaste anteriormente.

3. Activar lista blanca

   Ve a la pestaña Administrador de jugadores pestaña. Cambia el modo a "Roles de servidor de Discord". Luego, simplemente escribe los ID de rol de las personas a las que quieres permitir el acceso.

¿Por qué no funciona?

Si configuraste todo, pero los jugadores siguen siendo expulsados, revisa estos tres problemas comunes.

"Identificador no encontrado"

Esto sucede cuando FiveM no puede comunicarse con la aplicación de Discord en la PC del jugador. Para solucionar esto, diles a tus jugadores que:

• Cierren FiveM completamente.
• Abran Discord y asegúrense de que no esté minimizado.
• Vuelvan a abrir FiveM. Es posible que vean una ventana emergente en Discord pidiendo "Autorizar". Deben hacer clic en sí.

"Roles == Falso"

Si la consola dice que los roles son falsos o faltan, probablemente olvidaste los Intents de Gateway en el Portal de Desarrolladores. Vuelve al primer paso de esta guía y asegúrate de que esos interruptores estén activados.

¿Qué método deberías usar?

Si solo quieres evitar que se unan personas al azar, usa txAdmin. Es más rápido y fácil. Si quieres un servidor de rol complejo donde la policía y los administradores tengan diferentes poderes automáticamente, usa el Badger Stack.

Para aquellos que también quieren un bot que maneje el chat y la moderación, también pueden considerar zdiscord, pero requiere un poco más de trabajo configurarlo.