Discord2Fivepy

Discord2Fivepy – Administración Remota del Servidor a través de Discord

Manage your FiveM ESX server directly from Discord with this powerful Python-based bot that bridges Discord commands to in-game server operations. Built for server owners and administrators who need remote control capabilities, this bot handles player management, resource control, economy operations, and server monitoring without requiring in-game access. Perfect for managing your server while away from your PC or coordinating administrative actions with your staff team through Discord.

Por qué existe este bot

Este proyecto fue creado para resolver un problema común: los bots de administración Discord para servidores FiveM eran extremadamente caros o severamente limitados en funcionalidad. En lugar de pagar precios premium por características básicas, esta alternativa de código abierto proporciona control completo del servidor a un precio asequible. Está diseñado para dueños de servidores que desean herramientas de administración profesionales sin tarifas de suscripción o restricciones de características.

A diferencia de los paneles web que requieren reenvío de puertos y configuración de seguridad, Discord2Fivepy aprovecha la infraestructura existente de Discord. Su personal ya usa Discord para la comunicación, ahora también pueden usarlo para la administración del servidor.

Suite de Comandos Completa

Comandos de gestión de jugadores – Verifique el estado del servidor con conteos de jugadores en tiempo real y métricas de rendimiento del servidor (=status). Reviva a los jugadores derribados al instante sin iniciar sesión en el juego (=revive). Expulse a los jugadores problemáticos con mensajes personalizados (=kick). Todos los comandos de jugadores admiten tanto los IDs de los jugadores como la coincidencia parcial de nombres para una acción administrativa rápida.

Control de Economía e Inventario – Conceder dinero de cuenta directamente a las cuentas de banco, efectivo o dinero negro de los jugadores (=giveaccountmoney). Añadir elementos a los inventarios de los jugadores para eventos, compensaciones o pruebas (=giveitem). Entregar armas a las fuerzas del orden, seguridad o participantes en eventos (=giveweapon). Todos los comandos económicos incluyen validación de cantidad y registro para evitar abusos.

Gestión de trabajos y permisos – Asignar jugadores a trabajos con grados específicos al instante (=setjob). Útil para procesos de contratación, promociones o corrección de errores relacionados con trabajos sin requerir que los jugadores se desconecten. Soporta todos los trabajos ESX y marcos de trabajo personalizados con verificación de grado adecuada.

Gestión de recursos – Actualice la lista de recursos del servidor para detectar scripts recién añadidos (=refresh). Inicie recursos que estén detenidos o recién instalados (=start). Detenga los recursos que se comporten mal o sean problemáticos de inmediato (=stop). Reinicie los recursos para aplicar cambios de configuración sin reinicios completos del servidor (=restart). Estos comandos le dan control total sobre la ejecución de su servidor sin acceso SSH.

Anuncios del Servidor – Broadcast server-wide announcements to all connected players (=announce). Perfect for maintenance warnings, event notifications, or server-wide messages. Announcements appear in-game with configurable styling and duration.

Arquitectura técnica

Discord2Fivepy se ejecuta como una aplicación Python independiente que se conecta a su servidor FiveM y al bot Discord simultáneamente. El bot escucha los comandos Discord en los canales de administración designados, valida los permisos, ejecuta las operaciones correspondientes del lado del servidor y devuelve los resultados a través de los embeds Discord. Toda la comunicación está segura y cifrada.

El script de Python maneja la limitación de tasa para evitar el spam de comandos, incluye el manejo de errores para entradas no válidas y registra todas las acciones administrativas para rendir cuentas. Si falla un comando (jugador no encontrado, el recurso no existe, permisos insuficientes), el bot responde con mensajes de error detallados y sugerencias.

Integración de Webhook y Registro

Cada comando ejecutado a través del bot envía registros detallados a un webhook de Discord configurable. Estos registros incluyen: quién ejecutó el comando, qué comando se ejecutó, jugadores/recursos afectados, estado de éxito/fracaso y marcas de tiempo. Esto crea un registro completo de auditoría de todas las acciones administrativas realizadas a través del bot.

Los webhooks de error notifican a los administradores cuando fallan los comandos, ayudándote a solucionar problemas rápidamente. Si un jugador intenta usar =giveaccountmoney pero especifica un tipo de cuenta no válido, el webhook muestra exactamente qué salió mal y cómo solucionarlo.

Personalización y Configuración

All Discord embeds sent by the bot are fully customizable. Change embed colors to match your server branding, modify titles and descriptions, add custom footers with server names or branding, and include thumbnail images or server logos. The bot’s responses look professional and cohesive with your Discord server’s aesthetic.

Los permisos de los comandos se basan en roles. Asigne roles específicos de Discord que puedan usar cada categoría de comandos: todo el personal puede usar =status y =announce, los moderadores pueden =kick y =revive, pero solo los administradores senior pueden =giveaccountmoney y =setjob. Este sistema de permisos granulares evita que el personal junior acceda a comandos sensibles de la economía.

El archivo de configuración incluye comentarios detallados que explican cada configuración: token del bot Discord, IP y puerto del servidor FiveM, prefijos de comandos (cambiar = a ! o . si se desea), IDs de roles de permisos, URLs de webhooks, temporizadores de espera y opciones de estilo de incrustación.

Características de seguridad

• Validación de permisos – Cada comando verifica los permisos de rol Discord antes de la ejecución
• Registro de Comandos – Todas las acciones registradas en el webhook con plena responsabilidad
• Limitación de velocidad – Evita el spam y las inundaciones accidentales de comandos
• Saneamiento de entrada – Valida los IDs de los jugadores, las cantidades y los nombres de los recursos
• Comunicación segura – Conexión cifrada entre el bot y el servidor FiveM
• Sin exposición en el juego – El bot opera externamente, no accesible para los jugadores

Perfecto para

• Propietarios de servidores que viajan con frecuencia y necesitan capacidades de administración remota
• Equipos de personal coordinando acciones de administración a través de canales Discord
• Comunidades que desean responsabilidad y registro para acciones administrativas
• Servidores con grandes equipos de administración que necesitan permisos de comandos basados en roles
• Administradores que gestionan múltiples servidores y desean control centralizado
• Eventos que requieren una gestión rápida de jugadores sin menús de administración en el juego

Requisitos y Dependencias

• Python 3.9.2 o versiones más recientes (se recomienda Python 3.10+ para el mejor rendimiento)
• Servidor FX (cualquier versión reciente)
• ESX 1.1 o versiones más nuevas (se admiten versiones Legacy, Final o personalizadas de ESX)
• Discord Bot con permisos y token adecuados
• Servidor Discord con canales de administración dedicados
• Bibliotecas de Python – discord.py, requests, asyncio (instalados automáticamente a través de requirements.txt)

Instalación y configuración

1. Instala Python 3.9.2+ en tu servidor o máquina local
2. Crea un bot de Discord en el Discord Developer Portal y obtén el token
3. Descargar Discord2Fivepy y extraer en una carpeta dedicada
4. Instalar dependencias de Python: pip install -r requirements.txt
5. Configure config.py con su token de Discord, detalles del servidor FiveM y URLs de webhook
6. Configurar permisos de rol Discord para niveles de acceso a comandos
7. Ejecutar el bot: python bot.py
8. Pruebe los comandos en su servidor Discord para verificar la funcionalidad
9. Configura scripts de inicio automático para mantener el bot en funcionamiento 24/7

Referencia de comandos

• =status – Mostrar el estado del servidor, la cantidad de jugadores y las métricas de rendimiento
• =revive [playerID] – Revivir a un jugador derribado al instante
• =giveaccountmoney [playerID] [account] [amount] – Agregar dinero a las cuentas de los jugadores
• =giveitem [playerID] [itemName] [quantity] – Añadir elementos al inventario del jugador
• =giveweapon [playerID] [weaponName] [ammo] – Dar armas a los jugadores
• =refresh – Actualizar la lista de recursos del servidor
• =start [resourceName] – Iniciar un recurso detenido
• =stop [resourceName] – Detener un recurso en ejecución
• =restart [resourceName] – Reiniciar un recurso para aplicar cambios
• =setjob [playerID] [jobName] [grade] – Asignar jugador a un trabajo con grado
• =kick [playerID] [reason] – Expulsar al jugador del servidor con mensaje
• =announce [message] – Transmitir anuncio a todo el servidor

Lo que lo hace destacar

La mayoría de los bots FiveM Discord se centran únicamente en el monitoreo de estado o en conteos básicos de jugadores. Discord2Fivepy proporciona un control administrativo real: puedes gestionar toda la economía de tu servidor, el estado de los recursos y el roster de jugadores desde Discord. El sistema de registro completo crea responsabilidad que los menús de administración en el juego no pueden igualar.

Ser de código abierto significa que puedes modificar el bot para agregar comandos personalizados específicos para las necesidades de tu servidor. ¿Quieres agregar =givevehicle o =teleportplayer? La base de código está estructurada para una expansión fácil. El desarrollador fomenta la personalización mientras ofrece el sistema base como una sólida fundación.

El sistema de permisos basado en roles es particularmente valioso para equipos grandes de personal. Los moderadores junior pueden manejar =revive y =kick para el soporte de jugadores, mientras que los administradores senior controlan =giveaccountmoney y =setjob para la gestión de la economía. Esta separación de poderes previene accidentes y abusos.

Comencé este proyecto porque estaba buscando un Bot de Discord capaz de realizar comandos ESX, encontré uno pero sentí que el precio era demasiado para tan poco.

Requisitos:

• Python 3.9.2
• Servidor FX
• ESX 1.1 o anterior

Comandos:

• Estado (=estado)
• Revivir (=revivir)
• Dar dinero a la cuenta (=dardinerodelacuenta)
• Dar artículo (=dar artículo)
• Dar arma (=dar arma)
• Actualizar recursos (=actualizar)
• Recurso de inicio (=inicio)
• Detener recurso (=detener)
• Reiniciar recurso (=reiniciar)
• Establecer trabajo (=setjob)
• Patear (=patada)
• Anunciar (=anunciar)

El script tiene muchas opciones de personalización dentro de la configuración, todas las incrustaciones que envía el bot son personalizables, incluido el webhook que envía mensajes de error/confirmaciones.

Productos relacionados que podrían gustarte

• FiveM AntiCheat 2025 – Protección esencial del servidor con más de 314 servidores usándolo
• Complemento ESX para EasyAdmin – Herramienta avanzada de administración compatible con sus comandos Discord
• Servidor Super ESX – Base completa del servidor ESX con integración de administración
• Base del servidor ESX (por RibSosay) – Premium server foundation trusted by 292+ servers