How to Set Up a Discord Whitelist for Your FiveM Server (…

Audiencia: Propietarios y desarrolladores de servidores FiveM
Dificultad: Fácil → Intermedio
Resultado: Lista blanca basada en roles que utiliza roles de Discord (con lista negra opcional), mantenimiento mínimo y comentarios claros de los jugadores.

Nota sobre las versiones:El repositorio de código abierto FAXES/Lista blanca de Discord Es un servicio mantenido por la comunidad y su última actualización fue en 2022. Sigue funcionando en muchos servidores. Existe una versión comercial con mantenimiento; si necesita soporte o un acuerdo de nivel de servicio (SLA), considérelo. Esta guía cubre la versión gratuita de GitHub.

---

Resumen

1. Crear un Discord Bot → habilitar Intención de los miembros del servidor → invítalo a tu Discord.
2. Copia tu ID del gremio (servidor) y ID de rol(es).
3. Descargar: FAXES/DiscordLista blanca en GitHub → ponerlo en recursos/ → configurar servidor.js.
4. Agregar Asegurar la lista blanca de Discord a servidor.cfg (o iniciar en txAdmin).
5. Prueba: unirse sin el rol (bloqueado) → agregar rol → volver a unirse (permitido).

Tutoriales relacionados:
• Lista blanca de FiveM: guía completa (txAdmin, scripts, base de datos)
• Cómo crear niveles de donación en Discord

---

¿Por qué listas blancas basadas en Discord?

• Dinámica:Otorgar o denegar acceso agregando o quitando un rol de Discord (sin ediciones de ACE o DB).
• Escalable:Los mods pueden administrar el acceso desde Discord en dispositivos móviles.
• Auditable:El historial de roles + los registros de moderación muestran quién permitió a quién.

---

Prerrequisitos

• Un servidor de Discord (eres administrador/propietario).
• Servidor FiveM con txAdmin o control manual.
• Los jugadores deben tener la Aplicación de escritorio Discord en ejecución al conectarse (por lo que FiveM expone una discordia: identificador).

---

Paso 1: Crea un bot de Discord y habilita las intenciones

1. Ir a la Portal para desarrolladores de Discord → Nueva aplicación → nombrarlo (por ejemplo, Bot de lista blanca FiveMX).
2. Agregar un bot (Pestaña del bot) → Restablecer token → copiar el Token de bot (guárdelo de forma segura).
3. Bajo Intenciones de puerta de enlace privilegiada, permitir Intención de los miembros del servidor. (No se requiere intención de presencia).
4. Invitar al bot a tu Discord: OAuth2 → Generador de URL → Ámbitos: botPermisos: mínimos (solo se permiten los de unirse). Usa la URL generada y agrégala a tu gremio.

Seguridad: Trata el token del bot como si fuera una contraseña. no Confírmalo en Git o compártelo en capturas de pantalla. Rota la información si se filtra.

---

Paso 2: Obtén tus identificaciones (gremio y roles)

• En Discord → Configuración de usuario → Avanzado → Modo de desarrollador: EN.
• Haga clic derecho en su nombre del servidor → Copiar ID del servidor.
• Configuración del servidor → Roles → haga clic derecho en el rol que usará como lista blanca (por ejemplo, En la lista blanca) → Copiar ID de rol.
• (Opcional) Copie los ID de cualquier rol que desee lista negra (p.ej, Prohibido).

Tenga estos a mano:

• ID_GREMIO = 123456789012345678
• LISTA BLANCA_IDS_DE_ROL = ["11111111111111111", "22222222222222222"]
• ID DE ROL DE LISTA NEGRA = ["333333333333333333"]

---

Paso 3: Descargue e instale el recurso

1. Descargar El código postal de Lista blanca de FAXES/Discord (GitHub).
2. Extraer a su servidor en:
   recursos/[discord]/Lista blanca de Discord
3. Verifique que la carpeta contenga al menos:
   • fxmanifest.lua
   • servidor.js
   • paquete.json

servidor.cfg (o txAdmin Receta / Inicio):

# Comience después de sus proveedores de identificadores y antes de la lógica de unión que depende de él para garantizar la lista blanca de Discord.

En txAdmin → Recursos, marca Lista blanca de Discord para iniciar en el arranque (si administra recursos a través de la interfaz de usuario).

¿Está planificando su estrategia de acceso? Lea nuestra guía más amplia: Lista blanca de FiveM: guía completa (txAdmin, scripts, base de datos) para alternativas (ACE, DB, híbrido) y cuándo utilizar cada una.

---

Paso 4 — Configurar servidor.js

Abierto recursos/[discord]/DiscordWhitelist/server.js y configure el bloque de configuración. Es posible que el archivo ya muestre un objeto de configuración simple; ajuste los valores según corresponda. Una configuración típica se ve así:

// Configuración de la lista blanca de Discord: ejemplo const config = { botToken: "PASTE_YOUR_DISCORD_BOT_TOKEN_HERE", guildId: "123456789012345678", // Tu ID de servidor (gremio) // Los jugadores deben tener al menos UNO de estos ID de rol para unirse a whitelistRoles: [ "111111111111111111", // En la lista blanca // "222222222222222222", // Personal (opcional) ], // Si un jugador tiene CUALQUIERA de estos roles, rechaza la conexión blacklistRoles: [ // "33333333333333333", // Baneado ], // Almacena en caché los datos de rol obtenidos para reducir las llamadas a la API de Discord (segundos) cacheMaxTime: 90, // Mensajes de aplazamiento messages: { noDiscord: "Abre Discord y vuelve a unirte. Tu La aplicación Discord debe estar ejecutándose.", notWhitelisted: "No estás en la lista blanca. Únete a nuestro Discord: discord.gg/yourinvite", blacklisted: "Acceso denegado. Por favor, contacta al personal.", welcome: "Bienvenido, estás verificado. Cargando…" }, };

Consejo de monetización: Si su servidor utiliza ventajas, combine esto con Niveles de donación de Discord para automatizar los beneficios basados en roles para los simpatizantes/donantes.

Guarde el archivo.

---

Paso 5: reiniciar y probar

1. Reanudar solo el recurso o todo el servidor: txAdmin → Reiniciar recurso o consola refrescar entonces reiniciar DiscordLista blanca.
2. Prueba negativa:Intenta conectarte sin el rol de lista blanca → deberías ver el mensaje de aplazamiento y ser expulsado.
3. Prueba positiva: Concédase el rol de lista blanca → reconéctese → debería poder ingresar.

---

Opcional: Funciones múltiples y omisión de personal

• Agregar varios roles de lista blanca para permitir múltiples embudos (por ejemplo, Donatario, Policía, Servicios médicos de emergencia).
• Agregar roles en la lista negra para bloqueos duros independientemente de la lista blanca (por ejemplo, Prohibido).
• Puedes incluir un rol del personal en roles de lista blanca para garantizar el acceso a los administradores.

---

Consejos operativos

• Automatización: Conecte la asignación de roles de Discord a su formularios de solicitud o aprobaciones de tickets (por ejemplo, con un bot, Formularios de Google → webhook → agregar rol).
• Experiencia de usuario del jugador:Pincha un 1TP13Cómo incluir en la lista blanca Publicación con ✅ requisitos del rol y la invitación de tu servidor.
• Moderación:Registrar cambios de roles en un registro privado Registros de #mod canal.

---

Solución de problemas

“Bot desconectado” o nunca actualiza los roles

• Token incorrecto o bot no invitado al gremio correcto.
• Intención de los miembros del servidor no habilitado
• El firewall bloquea el protocolo HTTPS saliente desde el host de tu juego (permite la API de Discord).

“No se encontró ningún identificador de Discord” / todos bloqueados

• Los jugadores deben ejecutar el Aplicación de escritorio de Discord Antes de iniciar FiveM, pídeles que reinicien Discord y luego FiveM.

Los cambios de roles solo se aplican después de un reinicio

• Reducir tiempo máximo de caché entre 30 y 60 segundos.
• Si lo configura extremadamente bajo y aún ve demoras, verifique los límites de velocidad y evite reiniciar con frecuencia.

403/Error de permisos al obtener miembros del gremio

• Asegúrese de que el bot esté en el gremio objetivo y La intención de los miembros del servidor está habilitada.
• El bot lo hace no Necesita permisos de administrador para leer los roles de los miembros.

Alto uso de API/limitación de velocidad

• Aumentar tiempo máximo de caché. Evite reinicios/expulsiones masivas que generan spam en las llamadas API.

---

Mejores prácticas de seguridad

• Almacenar el Token de bot Fuera del control de versiones. Si alojas tus propias configuraciones, considera leerlas desde una variable de entorno o una variable de configuración server.cfg, no en texto plano enviado a Git.
• Girar el token si se filtró.
• Restringir quién tiene acceso de escritura al recurso.

---

Desinstalar / Deshabilitar

• Eliminar Asegurar la lista blanca de Discord de servidor.cfg (o deshabilitar en txAdmin → Recursos).
• Eliminar la carpeta de recursos/ Si lo estás desmantelando.

---

Preguntas frecuentes

¿Los jugadores necesitan que Discord esté en funcionamiento?
Sí. Sin el discordia: Identificador, el script no puede verificar roles.

¿Qué intenciones necesito?
Solo Intención de los miembros del servidor.

¿Puedo utilizar múltiples roles de lista blanca?
Sí. Se concede acceso si el usuario tiene cualquier de los roles enumerados.

¿Puedo rechazar categóricamente ciertos roles?
Sí. Agrégalos a Roles de lista negra.

Dejó de funcionar después de que cambié los roles.
Más bajo tiempo máximo de cachéLuego, prueba de nuevo. Asegúrate de que el bot esté conectado con el token y el gremio correctos.

¿Existe una versión mantenida?
Sí. Existe una edición comercial con mantenimiento activo si necesita actualizaciones o soporte.

---

Apéndice — Ejemplo servidor.cfg

# Lista blanca de Discord garantizar DiscordWhitelist # (Opcional) colocar recursos de Discord relacionados aquí como un bloque # garantizar discord_perms # garantizar discordrolesync

Apéndice: Ejemplo de mensajes para jugadores (aplazamientos)

Mantenga los mensajes breves y prácticos:

mensajes: { noDiscord: "Abre Discord y vuelve a unirte. Tu aplicación de Discord debe estar ejecutándose.", notWhitelisted: "No está en la lista blanca. Solicita en #how-to-whitelist → discord.gg/yourinvite", blacklisted: "Acceso denegado. Contacta al personal mediante un ticket.", welcome: "Verificado — cargando ciudad…" }

---

Registro de cambios (de cara al editor)

• v1.1 — Se agregaron enlaces internos naturales a los niveles de donación, la guía completa de la lista blanca de FiveM y la descarga de GitHub.
• v1.0 — Guía inicial: creación de bots, intenciones, ID, instalación, configuración, pruebas, preguntas frecuentes.