Para conectar txAdmin a Discord, crea una aplicación y un bot de Discord dedicados, invítalo al servidor correcto con solo los permisos que necesita, copia el token del bot en la configuración de Discord de txAdmin y configura los mensajes de estado y el acceso basado en roles como funciones separadas. Mantén el token privado: autentica el bot y nunca debe aparecer en capturas de pantalla, archivos del cliente o un repositorio público.
Revisado el 12 de agosto de 2026 contra la documentación oficial Documentación de Cfx.re txAdmin, de Discord configuración de la aplicación y Documentación de OAuth2. Las etiquetas pueden moverse entre las versiones de txAdmin, así que usa la configuración que muestra tu versión instalada.
Separa las cuatro partes móviles
| Parte | Objetivo | Fallo típico |
|---|---|---|
| Aplicación y bot de Discord | Identidad utilizada por txAdmin | Aplicación incorrecta, bot deshabilitado o token regenerado |
| Estado del servidor | Publica o actualiza el estado en un canal elegido | Canal incorrecto o permisos de vista/envío/incrustación faltantes |
| Roles o lista blanca | Mapea la membresía/roles de Discord a la regla de acceso configurada | ID de servidor/rol o requisito de intención de miembro incorrecto, jerarquía de roles |
| Permisos de txAdmin | Controla quién puede administrar el servidor de FiveM | Rol de Discord que se asume para otorgar derechos de txAdmin automáticamente |
No depures estos como una sola característica. Primero demuestra que el bot está en línea, luego demuestra que puede acceder a un canal, luego agrega el comportamiento de estado y solo entonces prueba la lógica opcional de roles o listas blancas.
Paso 1: crea una aplicación de Discord dedicada
- Abra el Portal de desarrolladores de Discord y cree una nueva aplicación para este servidor.
- Agregue un bot a la aplicación.
- Asígnele un nombre claro para que el personal pueda distinguir Producción de staging.
- Genere o restablezca el token solo cuando esté listo para almacenarlo de forma segura.
Un token de bot es un secreto, no una ID de aplicación o clave pública. Si se expone, restablézcalo en Discord y actualice txAdmin inmediatamente. Almacene el reemplazo solo en la configuración del lado del servidor destinada al token.
Paso 2: invite al bot con permisos mínimos
Utilice el flujo de instalación de OAuth2 de Discord para la aplicación y seleccione el alcance del bot requerido por la configuración actual. Comience con los permisos de canal más pequeños que satisfagan la función: ver el canal seleccionado, enviar mensajes, incrustar enlaces y leer el historial de mensajes donde la actualización de estado lo necesite. Evite el Administrador a menos que la integración oficial lo requiera explícitamente y haya revisado el motivo.
Restrinja el bot a un estado dedicado o canal de administración cuando sea práctico. Después de invitarlo, confirme que aparece en el servidor Discord previsto. Es de esperar que aparezca como desconectado hasta que txAdmin inicie sesión correctamente con el token.
Paso 3: configure el bot en txAdmin
Abra txAdmin como administrador autorizado y localice la configuración de integración de Discord en su versión instalada. Pegue el token en el campo del token sin comillas ni espacios en blanco adicionales. Seleccione el servidor y el canal Discord previstos utilizando las entradas que proporciona txAdmin. Guarde y luego reinicie solo el componente o el servidor si la interfaz lo solicita.
Si está construyendo el lado FiveM desde cero, use la ruta de configuración del servidor FiveM primero. Discord no puede reparar un FXServer en mal estado o una instancia de txAdmin inalcanzable.
Configurar mensajes de estado por separado
Habilite la función de estado y seleccione un canal donde el bot pueda publicar. Comience con una actualización de prueba simple antes de agregar texto o incrustaciones personalizadas. Confirme que el mensaje cambia cuando el servidor FiveM se inicia, se detiene o cambia el recuento de jugadores de acuerdo con el comportamiento documentado por su versión de txAdmin.
Si el bot inicia sesión pero no aparece ningún estado, verifique la ID del canal seleccionado y las anulaciones específicas del canal. Un rol a nivel de servidor puede permitir el envío mientras que una anulación de canal lo niega. También inspeccione la salida de la consola/registro de txAdmin para la respuesta API de Discord en lugar de regenerar el token repetidamente.
Configurar roles o reglas de lista blanca por separado
El acceso basado en roles requiere el servidor Discord exacto y los identificadores de rol esperados por la integración. Habilite el modo de desarrollador de Discord para copiar las ID cuando la configuración actual las solicite. Los nombres de los roles no son identificadores estables y dos roles pueden compartir un nombre similar.
Pruebe con una cuenta que tenga el rol requerido y otra que no. Elimine y vuelva a agregar el rol, vuelva a conectarse y confirme cuando la integración actualice la membresía. No asuma que un rol de Discord otorga automáticamente permisos de administrador de txAdmin; el propio modelo de permisos de txAdmin sigue siendo un control separado a menos que la función documentada los asigne explícitamente.
Proteja el token y el límite de permisos
- Nunca pegue el token en el chat de Discord, un ticket de soporte visible para otros o un recurso del lado del cliente.
- No lo envíe a Git ni lo almacene en una captura de pantalla pública.
- Limite el acceso tanto a la aplicación del Portal de desarrolladores de Discord como a la configuración de txAdmin.
- Restablezca el token después de la exposición o cuando un administrador con acceso se vaya.
- Revise periódicamente los permisos de servidor y canal del bot.
Lista de verificación de solución de problemas
| Síntoma | Controlar |
|---|---|
| El bot permanece desconectado | El token pertenece al bot correcto, no contiene espacios en blanco, no se ha restablecido y los registros de txAdmin muestran un intento de inicio de sesión |
| El bot está en línea pero no puede publicar | Canal seleccionado, permisos de ver/enviar/incrustar y anulaciones de canal |
| El estado nunca se actualiza | Función de estado habilitada, canal correcto, estado de txAdmin/FXServer y registro de integración |
| El miembro del rol es rechazado | ID de servidor/rol correcto, rol realmente asignado, comportamiento de actualización/reconexión y cualquier intención de miembro requerida |
| El miembro no autorizado es aceptado | Reglas de acceso de respaldo, múltiples roles permitidos y configuración de permisos del lado del servidor |
| Se detuvo después de un restablecimiento de token | txAdmin todavía tiene el token antiguo; guarde el nuevo y reinicie según sea necesario |
Verificación final
- El bot inicia sesión después de un reinicio limpio sin errores de token.
- El estado se publica solo en el canal previsto.
- El rol mínimo del bot puede actualizar el mensaje sin privilegios de servidor más amplios.
- El usuario de prueba permitido pasa la regla de rol/lista blanca.
- El usuario de prueba no permitido falla la misma regla.
- Ni el acceso a Discord ni un botón oculto de UI anulan los propios permisos de administrador de txAdmin.
Una vez que estas comprobaciones pasan de forma independiente, la integración es más fácil de mantener: una identidad de bot, un secreto protegido, acceso a canales de alcance limitado y reglas explícitas para el estado, la lista blanca y la administración.
