{"id":26660563,"url":"https://github.com/infamesdev/tx-ban-discord","last_synced_at":"2026-04-12T05:35:51.264Z","repository":{"id":284330815,"uuid":"952104228","full_name":"infamesdev/Tx-Ban-Discord","owner":"infamesdev","description":"Bot de discord destinado a consultar los baneos de TX-Admin.","archived":false,"fork":false,"pushed_at":"2025-03-25T10:05:48.000Z","size":21,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-03-25T11:23:02.561Z","etag":null,"topics":["discord","fivem","linux","puppeteer","server","tx","tx-admin","txadmin","windows"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/infamesdev.png","metadata":{"files":{"readme":"README.md","changelog":"history.js","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-20T18:32:25.000Z","updated_at":"2025-03-25T10:05:52.000Z","dependencies_parsed_at":"2025-03-25T11:33:06.299Z","dependency_job_id":null,"html_url":"https://github.com/infamesdev/Tx-Ban-Discord","commit_stats":null,"previous_names":["infamesdev/tx-ban-discord"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/infamesdev%2FTx-Ban-Discord","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/infamesdev%2FTx-Ban-Discord/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/infamesdev%2FTx-Ban-Discord/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/infamesdev%2FTx-Ban-Discord/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/infamesdev","download_url":"https://codeload.github.com/infamesdev/Tx-Ban-Discord/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245458711,"owners_count":20618697,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["discord","fivem","linux","puppeteer","server","tx","tx-admin","txadmin","windows"],"created_at":"2025-03-25T12:18:19.658Z","updated_at":"2025-12-30T23:26:24.556Z","avatar_url":"https://github.com/infamesdev.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TxAdmin - Discord Bot\n\nEsta es una herramienta de Discord que permite consultar los usuarios baneados en tu servidor de FiveM. Su propósito es facilitar la gestión de baneos directamente desde Discord, sin necesidad de iniciar el juego o acceder al servidor FiveM.\n\n\u003e [!IMPORTANTE]\n\u003e Es necesario tener acceso al panel de TxAdmin para utilizar esta herramienta.\n\nEl bot puede funcionar desde localhost o instalado en otro servidor, siempre que tenga acceso a la URL de TxAdmin.\n\n## Configuración\n\nPara configurar el bot, es necesario editar el archivo `.env` con los parámetros de tu servidor FiveM y Discord. Puedes encontrar un ejemplo en [`data/config/.env.example`](./data/config/.env.example).\n\n### Parámetros requeridos:\n\n```env\n# TXADMIN\nTX_ADMIN_BASE_URL=    # URL de tu instancia de TXAdmin (ej. http://XXX.XXX.XXX.XXX:40120 o http://localhost:40120)\nTX_ADMIN_USERNAME=    # Nombre de usuario de TXAdmin (se recomienda usuario con permisos limitados a ban)\nTX_ADMIN_PASSWORD=    # Contraseña de TXAdmin\n\n# RUTAS\nERROR_SCREENSHOTS_PATH=./data/errors\nDATA_STORAGE_PATH=./data/storage\n\n# ENTORNO\nNODE_ENV=production   # development | production\n\n# DISCORD\nDISCORD_BOT_TOKEN=    # Token del bot de Discord\nallowedChannelsCommand=1315766185740206080 # ID del canal de Discord donde el bot escuchará los comandos\n```\n\n## Ejecución\n\nPara ejecutar el bot:\n\n```bash\n# Instalar dependencias\nnpm install\n\n# Ejecutar en modo producción (configuración por defecto)\nnpm start\n\n# Otros modos de ejecución\nnpm run dev    # Modo desarrollo\nnpm run prod   # Modo producción explícito\n```\n\n## Gestión de errores\n\nEl bot guarda capturas de pantalla de los errores en la carpeta `data/errors`. Estas capturas se pueden consultar en caso de que el bot no funcione correctamente. Además, el bot registra un log de errores en la consola y en `data/errors/error-log.txt`.\n\n## Documentación técnica\n\n### Descripción General\nEste proyecto implementa un sistema automatizado de gestión para servidores FiveM a través de la interfaz txAdmin, permitiendo la autenticación programática y ejecución de operaciones administrativas.\n\n### Estructura del Proyecto\n\n#### Módulos Principales\n\n1. **`error.js`**: Manejo y registro de errores\n    - Captura de pantalla automática cuando ocurren errores\n    - Registro detallado con contexto y trazas\n    - Organización de archivos por timestamp\n\n2. **`config.js`**: Gestión de configuración\n    - Carga de variables de entorno desde `.env`\n    - Configuración del navegador según el entorno\n    - Obtención centralizada de parámetros\n\n3. **`login.js`**: Autenticación con txAdmin\n    - Automatización del inicio de sesión\n    - Manejo de elementos de interfaz\n    - Extracción de cookies y tokens de seguridad\n\n4. **`index.js`**: Punto de entrada\n    - Orquestación del proceso completo\n    - Integración de los módulos\n\n### Características Principales\n\n- **Automatización del navegador**: Soporte para modos headless/visible\n- **Persistencia de sesión**: Almacenamiento de credenciales entre ejecuciones\n- **Gestión de configuración**: Adaptación según el entorno\n- **Robustez**: Manejo detallado de errores y excepciones\n\n### Requisitos del Sistema\n- Node.js\n- Puppeteer\n- Archivo `.env` configurado\n- Permisos de escritura en disco\n\n### Flujo de Ejecución\n1. Carga de configuración\n2. Inicialización del navegador\n3. Autenticación en txAdmin\n4. Extracción y almacenamiento de credenciales\n\n### Próximas Funcionalidades\n- Integración avanzada con Discord","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finfamesdev%2Ftx-ban-discord","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finfamesdev%2Ftx-ban-discord","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finfamesdev%2Ftx-ban-discord/lists"}