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 características 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.
Separa los cuatro componentes
| 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 incorrecto, jerarquía de roles o requisito del intent de miembros |
| 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
- Abre el Portal de desarrolladores de Discord y crea una nueva aplicación para este servidor.
- Agrega un bot a la aplicación.
- Asígnale un nombre claro para que el personal pueda distinguir Producción de staging.
- Genera o restablece el token solo cuando estés 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écelo en Discord y actualiza txAdmin inmediatamente. Almacena el reemplazo solo en la configuración del lado del servidor destinada al token.
Paso 2: invita al bot con permisos mínimos
Utiliza el flujo de instalación OAuth2 de Discord para la aplicación y selecciona el alcance del bot requerido por la configuración actual. Comienza 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. Evita el Administrador a menos que la integración oficial lo requiera explícitamente y hayas revisado por qué.
Limita el bot a un canal específico de estado o administración cuando sea posible. Después de invitarlo, confirma que aparece en el servidor de Discord previsto. Es normal que figure como desconectado hasta que txAdmin inicie sesión correctamente con el token.
Paso 3: configura el bot en txAdmin
Abre txAdmin como administrador autorizado y localiza la configuración de integración de Discord en tu versión instalada. Pega el token en el campo del token sin comillas ni espacios en blanco adicionales. Selecciona el servidor y el canal Discord previstos utilizando las entradas que proporciona txAdmin. Guarda y luego reinicia solo el componente o el servidor si la interfaz lo solicita.
Si estás construyendo el lado FiveM desde cero, usa la ruta de configuración del servidor FiveM primero. Discord no puede reparar un FXServer en mal estado o una instancia de txAdmin inalcanzable.
Configura los mensajes de estado por separado
Habilita la función de estado y selecciona un canal donde el bot pueda publicar. Comienza con una actualización de prueba simple antes de añadir texto o incrustaciones personalizadas. Confirma 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 tu versión de txAdmin.
Si el bot inicia sesión pero no aparece ningún estado, comprueba el ID del canal seleccionado y las anulaciones específicas del canal. Un rol de todo el servidor puede permitir el envío, mientras que una anulación de canal lo deniega. También inspecciona la salida de la consola/registro de txAdmin para la respuesta de la API de Discord en lugar de regenerar el token repetidamente.
Configura los roles o las reglas de la lista blanca por separado
El acceso basado en roles requiere los identificadores exactos del servidor y del rol de Discord que espera la integración. Habilita el modo de desarrollador de Discord para copiar los ID cuando la configuración actual los solicite. Los nombres de los roles no son identificadores estables y dos roles pueden compartir un nombre similar.
Prueba con una cuenta que tenga el rol requerido y otra que no. Elimina y vuelve a añadir el rol, vuelve a conectar y confirma cuándo la integración actualiza la membresía. No asumas 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.
Protege el token y el límite de permisos
- Nunca pegues el token en el chat de Discord, en un ticket de soporte visible para otros o en un recurso del lado del cliente.
- No lo subas a Git ni lo almacenes en una captura de pantalla pública.
- Limita el acceso tanto a la aplicación del Portal de desarrolladores de Discord como a la configuración de txAdmin.
- Restablece el token después de una exposición o cuando un administrador con acceso se vaya.
- Revisa periódicamente los permisos del bot en el servidor y en los canales.
Lista de verificación para la solución de problemas
| Síntoma | Comprueba |
|---|---|
| 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 intent de miembros requerido. |
| 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; guarda el nuevo y reinicia 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 de interfaz de usuario oculto 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.
Documentación de referencia
Cfx.re — txAdmin · Fuente: docs.discord.com · Fuente: docs.discord.com