Instalación y configuración de tu plantilla de servidor FiveM

¡Bienvenido! Acabas de adquirir uno de nuestros Plantillas de servidor premium de FiveM – una opción fantástica para impulsar tu comunidad con una experiencia preconfigurada y llena de funciones. Ya seas un administrador de servidores experimentado o estés comenzando, esta guía completa te guiará en cada paso para descargar, instalar y lanzar tu plantilla de servidor de manera efectiva.

Si has comprado un paquete de servidor completo de nosotros y te preguntas “¿Qué sigue?”, estás en el lugar exacto. Convertiremos ese archivo .zip descargado en un servidor vivo y funcional. El servidor FiveM está listo para los jugadores.

---

¿Por qué elegir una plantilla de servidor completa de FiveMX.com?

Antes de sumergirnos, recapitulemos rápidamente por qué comenzar con una plantilla FiveMX acelera tu viaje:

• Ahorro de tiempo: Construir un servidor FiveM estable desde cero implica incontables horas de instalación de recursos, configuración de scripts, depuración de conflictos y configuración de bases de datos. Nuestras plantillas agrupan todo este trabajo, ahorrándole potencialmente semanas o incluso meses.

• Elementos esenciales preconfigurados: Incluimos y configuramos marcos cruciales (como ESX o QBCore, según la plantilla), scripts esenciales (trabajos, inventarios, vehículos, conceptos básicos anti-trampas), mapas optimizados y configuraciones básicas.

• Estabilidad probada: Nos esforzamos por garantizar que los recursos incluidos funcionen bien juntos, reduciendo los dolores de cabeza comunes por conflictos de scripts y problemas de rendimiento que se encuentran en servidores ensamblados de forma desordenada.

• Fundación para el crecimiento: Aunque están listas para usar, nuestras plantillas son configurables. Obtienes una base sólida sobre la cual puedes agregar fácilmente funciones, vehículos o scripts únicos específicos para la visión de tu comunidad.

• Soporte dedicado: No estás solo. FiveMX ofrece actualizaciones continuas para las plantillas compradas y acceso a nuestros canales de soporte (como Discord) para resolución de problemas y asesoramiento.

Antes de comenzar: Lista de verificación de requisitos previos

Asegúrese de tener lo siguiente listo:

1. Su plantilla de servidor FiveMX: Descargado de su cuenta de FiveMX.com.

2. Alojamiento de servidores (ver nuestra comparación): Un lugar para ejecutar tu servidor. Puede ser:

   • VPS (Servidor Privado Virtual) o Servidor Dedicado: Recomendado para servidores públicos. Proveedores como Zap-Hosting (a menudo socios de FiveM), OVH, Hetzner o Contabo son opciones populares. Asegúrate de que cumpla con las especificaciones recomendadas de FiveM (consulta los documentos Cfx.re para las recomendaciones actuales).

   • PC con Windows (host local): Adecuado para probar o jugar con amigos localmente, pero generalmente no es lo suficientemente potente ni confiable para una gran comunidad pública.

3. Artefactos del servidor FiveM: El núcleo Archivos del servidor FiveM (para Windows). – Si está encendido Linux, haga clic aquí

4. Software de base de datos: MySQL o MariaDB (MariaDB Generalmente se recomienda como reemplazo directo de MySQL).

5. Herramienta de gestión de bases de datos: HeidiSQL (Gratis, recomendado), phpMyAdmin (basado en web) o MySQL Workbench.

6. Editor de texto: Un buen editor de texto como Código de Visual Studio (Gratuito, Recomendado), Notepad++ o Sublime Text. Evita el Bloc de Notas de Windows, ya que puede alterar las codificaciones de archivos.

7. Clave de licencia de FiveM: Obtenible del keymaster de FiveM

8. (Ventanas) Visual C++ Redistribuible: La última versión es crucial. Descargar desde el sitio oficial de Microsoft.

---

Paso 1: Descargando Tu Plantilla de Servidor

¡Esta es la parte más fácil!

1. Inicie sesión en FiveMX.com: Accede a tu cuenta en nuestro sitio web.

2. Ir a Descargas: Busque la sección “Mi cuenta” o “Descargas”.

3. Descargar tu compra: Localiza la plantilla de servidor que compraste y haz clic en el botón de descarga. Llegará como un archivo .zip. Guárdalo en un lugar de fácil acceso, como tu Escritorio o una carpeta dedicada “FiveM Server”.

Importante: ¡Los archivos del servidor que compraste también te serán enviados por correo electrónico (enlace)!

Paso 2: Preparación del entorno del servidor

Este paso es crucial para una instalación fluida. ¡No lo omitas!

1. Configurar su servidor base FiveM:

   • Descarga los Artifacts: Ve a la documentación oficial de FiveM (docs.cfx.re) y encuentra el enlace para los últimos artifacts de servidor recomendados para tu sistema operativo (Windows o Linux). Descárgalos.

   • Crear directorio del servidor: Crea una carpeta principal para tu servidor (por ejemplo, C:FXServer o /home/user/FXServer).

   • Extraer artefactos: Extraiga los artefactos del servidor descargados directamente en esta carpeta.

   • Crea el directorio server-data: Dentro del directorio principal de tu servidor, crea una subcarpeta llamada server-data. Aquí residirán tus recursos y configuración, manteniendo todo organizado y separado de los archivos principales del servidor. Los archivos de nuestra plantilla irán dentro de esta carpeta server-data.

2. Instalar el software de base de datos (MySQL/MariaDB):

   • ¿Por qué? Servidores FiveM, especialmente servidores de juego de rol que utilizan frameworks like ESX or QBCore, dependen en gran medida de bases de datos para almacenar datos persistentes: cuentas de jugadores, información de personajes, inventario, propiedad de vehículos, estados comerciales, registros, etc. Sin una base de datos, ninguna de esta información se puede guardar entre sesiones.

   • ¿Cómo?

     • Ventanas: Descarga el instalador de MySQL Community Server o MariaDB desde sus sitios web oficiales. Sigue el asistente de instalación. Durante la instalación, anota de forma segura la contraseña de root que establezcas.

     • Linux (Debian/Ubuntu): Usa el gestor de paquetes: sudo apt update && sudo apt install mariadb-server. Ejecuta sudo mysql_secure_installation después para establecer la contraseña de root y asegurar la instalación.

     • Linux (CentOS/RHEL): Usa el gestor de paquetes: sudo yum update && sudo yum install mariadb-server. Inicia el servicio sudo systemctl start mariadb y habilítalo al arranque sudo systemctl enable mariadb. Ejecuta sudo mysql_secure_installation.

   • Verificación: Asegúrate de que el servicio de base de datos esté ejecutándose (services.msc en Windows, sudo systemctl status mariadb en Linux).

3. Instalar la herramienta de administración de bases de datos (se recomienda HeidiSQL):

   • ¿Por qué? Aunque puedes gestionar MySQL/MariaDB mediante la línea de comandos, una herramienta gráfica facilita mucho la creación de bases de datos, importación de datos y navegación de tablas.

   • ¿Cómo? Descarga HeidiSQL desde su sitio web oficial e instálalo. Es ligero y utilizable.

4. (Solo Windows) Instalar Visual C++ Redistributable:

   • ¿Por qué? Muchos recursos de FiveM, y FiveM mismo, dependen de las bibliotecas Microsoft Visual C++. La falta de estas es una causa muy común de fallos al iniciar el servidor o errores de scripts.

   • ¿Cómo? Descargue la última versión x64 directamente desde Microsoft y ejecute el instalador. Reinicie el equipo si se le solicita.

Paso 3: Instalando la Plantilla del Servidor

Ahora fusionamos la plantilla descargada con su entorno de servidor preparado.

1. Extraer los archivos de plantilla:

   • Abre el archivo .zip que descargaste de FiveMX.com.

   • Extrae todo su contenido directamente en la carpeta server-data que creaste en el Paso 2.

   • Crucial: Asegúrate de que la estructura de archivos sea correcta. Deberías ver carpetas como resources y posiblemente archivos como server.cfg directamente dentro de server-data, no anidados dentro de una carpeta adicional con el nombre de la plantilla (por ejemplo, NO server-data/NombrePlantilla/resources, sino server-data/resources).

2. Configurar la base de datos:

   • Localice el archivo SQL: Dentro de los archivos extraídos de la plantilla (probablemente en el directorio principal server-data o en una carpeta _INSTALL dedicada), encuentra el archivo de base de datos. Generalmente termina en .sql (por ejemplo, database.sql, install.sql, esx_legacy.sql).

   • Abra HeidiSQL (o su herramienta): Inicie su herramienta de gestión de bases de datos.

   • Conectarse a la base de datos: Crear una nueva sesión de conexión.

     • Hostname/IP: 127.0.0.1 (o localhost) si la base de datos está en la misma máquina que HeidiSQL. Si tu base de datos está alojada en otro lugar, usa su dirección IP.

     • Usuario: root (o el usuario específico que creaste, aunque root es suficiente para configuraciones locales).

     • Contraseña: la contraseña que configuró durante la instalación de MySQL/MariaDB.

     • Puerto: Generalmente 3306.

     • Haga clic en “Abrir” o “Conectar”.

   • Crear la base de datos:

     • Haga clic derecho en el panel izquierdo (donde se enumeran las conexiones del servidor) o vaya a la pestaña “Consulta”.

     • Ejecuta el comando: CREATE DATABASE IF NOT EXISTS nombre_de_tu_base_de_datos; (Reemplaza nombre_de_tu_base_de_datos con un nombre que elijas, por ejemplo, fivemx_server. ¡Recuerde este nombre!). Use un nombre descriptivo. Presione F9 o haga clic en el botón "Ejecutar".

     • Actualice la lista de bases de datos (F5). Debería ver su nueva base de datos vacía.

   • Importar el archivo SQL:

     • Seleccione la base de datos recién creada en el panel izquierdo para activarla.

     • Ve a Archivo -> Ejecutar archivo SQL….

     • Navega y selecciona el archivo .sql de tu plantilla.

     • Haga clic en "Abrir". HeidiSQL ejecutará todos los comandos del archivo, creando las tablas necesarias y, posiblemente, insertando los datos predeterminados requeridos por los scripts de la plantilla. Esto puede tardar entre unos segundos y un minuto, dependiendo de la complejidad de la plantilla. Revise el registro de salida en la parte inferior para detectar cualquier error.

3. Configurar la conexión a la base de datos en los archivos del servidor:

   • ¿Por qué? Tu servidor FiveM necesita saber cómo conectarse a la base de datos que acabas de configurar. La plantilla incluye scripts que requieren estas credenciales.

   • Encuentra la configuración: La ubicación exacta varía entre plantillas y frameworks (ESX, QBCore). Los lugares comunes incluyen:

     • Directamente en server-data/server.cfg.

     • En el archivo de configuración de un recurso específico, como server-data/resources/[esx]/es_extended/config.lua o server-data/resources/[qb]/qb-core/config.lua.

     • A veces en un script de conexión de base de datos dedicado como ghmattimysql o oxmysql. Revisa la documentación de la plantilla o server.cfg para líneas start o ensure relacionadas con mysql async/oxmysql.

   • Editar la configuración: Abra los archivos correspondientes con su editor de texto (VS Code, Notepad++). Busque líneas similares a esta (la sintaxis puede variar ligeramente entre Lua, JS y JSON):

     -- Example for ESX/QBCore style Lua configs
     Config.MySQLConnection = "mysql://root:YourPassword@127.0.0.1/your_database_name?charset=utf8mb4"
     -- or separate fields:
     set mysql_connection_string "server=127.0.0.1;database=your_database_name;userid=root;password=YourPassword;" -- Often found directly in server.cfg for older setups or specific resources
     -- or in JSON format for some resources:
     // { "host": "127.0.0.1", "user": "root", "password": "YourPassword", "database": "your_database_name" }

      

   • Actualizar valores: Reemplaza “TuContraseña” con tu contraseña real de root de la base de datos y “nombre_de_tu_base_de_datos” con el nombre exacto de la base de datos que creaste en HeidiSQL. Asegúrate de que el host (127.0.0.1 o localhost) y el usuario (root) sean correctos.

   • Guarde el(los) archivo(s). Verifique nuevamente que haya actualizado todas las cadenas de conexión necesarias si hay varias.

4. Revisa y configura server.cfg:

   • Abre el archivo server-data/server.cfg con tu editor de texto. Este es el archivo de configuración principal de tu servidor FiveM.

   • Configuraciones esenciales:

     • sv_licenseKey “tu_licencia_key”: Reemplaza “tu_licencia_key” con la clave que generaste desde el FiveM Keymaster. Esto es obligatorio para que el servidor aparezca en la lista y funcione correctamente.

     • sv_hostname “Mi Asombroso Servidor FiveMX”: Cambia esto al nombre deseado para tu servidor, tal como aparecerá en la lista de servidores. Puedes usar colores y emojis si lo deseas (usando Códigos de formato de FiveM).

     • sv_maxclients 48: Establece el número máximo de jugadores (asegúrate de que tu tipo de licencia soporte este número; las claves estándar soportan hasta 48, niveles superiores mediante Patreon).

     • sv_projectDesc “Una descripción de mi servidor.”: Establece una breve descripción que aparecerá en algunas listas de servidores o paneles de detalles.

     • sets steam_webApiKey “TU_CLAVE_API_DE_STEAM”: Necesario para muchos frameworks/scripts. Obtén uno en el sitio web para desarrolladores de Steam. Agrega esta línea si falta y tu framework lo requiere.

     • ensure …: Estas líneas cargan tus recursos. La plantilla FiveMX debería tenerlos preconfigurados. El orden a veces puede importar, especialmente para frameworks (por ejemplo, asegúrate de cargar es_extended antes que los addons de ESX). No cambies el orden a menos que sepas lo que haces o sigas instrucciones específicas.

   • Revisar otras configuraciones: Revisa el archivo en busca de otras configuraciones específicas de la plantilla (como locale, dinero inicial, convars específicos de scripts) y ajústalas según sea necesario. Los comentarios (# o — al inicio de una línea) suelen explicar qué hacen las configuraciones.

   • Guarda el archivo server.cfg.

Listo por ahora.

Paso 4: Iniciando tu servidor

¡Es hora de ponerlo en línea!

• Navegue al directorio correcto: Abre el directorio principal de tu servidor (por ejemplo, C:FXServer o /home/usuario/FXServer), el que contiene el archivo FXServer.exe o run.sh, NO el directorio server-data.

• Para usuarios de Windows:

  1. Busca run.cmd o similar: Busca un archivo batch típicamente llamado run.cmd o a veces start.bat. A menudo hará referencia al directorio server-data, como +exec server.cfg +set txAdminPort 40120.

  2. Doble clic: Haz doble clic en el archivo run.cmd (o equivalente).

  3. Ventana de consola: Aparecerá una ventana del símbolo del sistema (o varias, si usa TxAdmin). Esta es la consola de su servidor. ¡Esté atento!

• Para usuarios de Linux:

  1. Abrir terminal: Abra una ventana de terminal en el directorio de su servidor principal.

  2. Hacer ejecutable (si es necesario): Asegúrate de que el script de inicio sea ejecutable: chmod +x run.sh.

  3. Ejecutar el Script: Ejecuta el script de inicio: ./run.sh +exec server.cfg. (La parte +exec server.cfg podría ya estar dentro del script run.sh).

  4. Salida de consola: La salida de la consola del servidor aparecerá directamente en su terminal.

Verifique que el servidor esté ejecutándose:

• Mira la consola: Busca mensajes que indiquen que los recursos están iniciando (a menudo texto verde como Started resource MyResource).

• Comprobar errores: Busque críticamente ROJO Mensajes de error. Los errores más comunes incluyen:

  • Error de autenticación: No se pudo conectar a la base de datos. (Revisa el Paso 3.3 – Credenciales de la Base de Datos).

  • No se pudo encontrar el recurso X. (Verifica que la carpeta del recurso exista en resources y que la línea ensure X en server.cfg coincida exactamente con el nombre de la carpeta).

  • ERROR de Script: … (Indica un problema dentro del código de un script específico. Puede requerir depuración o verificar problemas de compatibilidad).

  • Errores relacionados con dependencias faltantes (como Visual C++ Redistributable en Windows).

• Mensaje de éxito: Lo ideal es que después de cargar todos los recursos veas mensajes que indican que el servidor está activo, escuchando en un puerto y autenticado con los servicios de FiveM.

• Conectarse en el juego:

  1. Ejecuta FiveM en tu PC para juegos.

  2. Presione F8 para abrir la consola del cliente.

  3. Escribe connect 127.0.0.1:30120 (si ejecutas el servidor en la misma máquina desde la que juegas) o connect TU_IP_DEL_SERVIDOR:30120 (si el servidor está alojado en otro lugar, usa su dirección IP pública). El puerto predeterminado es 30120 a menos que se cambie en tu script de inicio o server.cfg.

  4. Si todo está correcto ¡deberías comenzar a conectarte a tu servidor!

---

Personalización básica (después de la instalación)

Tu servidor está funcionando, pero ahora quieres hacerlo tuyo.

• ¡Primero la copia de seguridad! Antes de hacer cambios importantes, detén el servidor y haz una copia de seguridad de tu carpeta server-data y de tu base de datos (usa la función de exportación de HeidiSQL).

• Cambiar logotipos/pantallas de carga: Busca recursos relacionados con lo visual (por ejemplo, loadingscreen, scoreboard) y revisa sus archivos html, css, js o config.lua para opciones de personalización. Reemplaza los archivos de imagen (como logo.png) con los tuyos, manteniendo dimensiones similares.

• Configurar trabajos/actividades: Explora los archivos de configuración (config.lua es común) dentro de carpetas de recursos específicas (por ejemplo, resources/[jobs]/policejob/config.lua) para ajustar pagos de trabajos, ubicaciones, rangos requeridos, etc.

• Agregar/Eliminar vehículos: Para agregar vehículos personalizados, normalmente colocas la carpeta del recurso del vehículo en tu directorio resources y agregas ensure nombre_del_recurso_del_vehículo a tu server.cfg. Consulta guías específicas para agregar vehículos. Eliminarlos es el proceso inverso (eliminar carpeta, quitar la línea ensure).

• Ajuste económico: Las configuraciones del framework (ESX/QBCore) suelen controlar el efectivo inicial, los intervalos salariales y los precios base de los artículos. Ajústelos cuidadosamente.

Packs de servidor

Explora productos de servidor completos para lanzamientos y renovaciones.

Packs de servidorPlantilla de servidor ESX Pro$136.99 El precio original era: $136.99.$116.44El precio actual es: $116.44.

Packs de servidorServidor completo QBus / QBCore v4.1$43.99 El precio original era: $43.99.$37.39El precio actual es: $37.39.

Packs de servidorNoPixel 3.5 Paquete VIP Inspirado V4$136.99 El precio original era: $136.99.$116.44El precio actual es: $116.44.

Paso 6: Administración y mantenimiento de su servidor

Ejecutar un servidor es un proceso continuo:

• Copias de seguridad periódicas: En serio, automatiza esto si es posible. Haz una copia de seguridad de tu carpeta server-data (especialmente la subcarpeta resources y server.cfg) y de tu base de datos (volcado .sql) diariamente o al menos varias veces a la semana. Almacena las copias de seguridad fuera del sitio si es posible. Consulta nuestro tutorial de copia de seguridad dedicado!

• Manténgase actualizado:

  • Artefactos FiveM: Revisa periódicamente la documentación de FiveM para conocer nuevas compilaciones de servidor recomendadas y actualiza tus archivos principales del servidor (generalmente implica reemplazar los archivos fuera de server-data). ¡Lee primero los registros de cambios!

  • Actualizaciones de la plantilla FiveMX: Manténgase al tanto de las actualizaciones de su plantilla en FiveMX.com. Estas actualizaciones pueden incluir correcciones de errores, nuevas funciones o mejoras de compatibilidad. Siga atentamente nuestras instrucciones de actualización.

  • Actualizaciones de recursos: Los creadores de scripts individuales suelen actualizar sus recursos en plataformas como GitHub. Actualizar requiere reemplazar la carpeta del recurso y verificar los cambios de configuración. Ten cuidado, ya que las actualizaciones a veces pueden romper cosas o entrar en conflicto con otros scripts.

• Monitorizar el rendimiento: Usa herramientas de monitoreo del servidor (como txAdmin incluido con FiveM, o monitores de recursos como htop en Linux / Administrador de tareas en Windows) para verificar el uso de CPU/RAM. Un uso elevado puede indicar scripts mal optimizados.

• Interactúe con su comunidad: Escuche los comentarios de los jugadores para obtener informes de errores y sugerencias.

• Utilice los canales de soporte: Si encuentra problemas relacionados con la plantilla FiveMX, no dude en utilizar nuestro Discord o nuestros foros de soporte.

Solución de problemas comunes

Los problemas ocurren. Aquí te explicamos cómo abordarlos:

1. El servidor no se inicia o se bloquea inmediatamente:

   • Comprobar consola: Desplázate hacia arriba en la ventana de la consola del servidor/archivo de registro. Busca el primer mensaje de error. Esto suele señalar la causa raíz.

   • Revisa server.cfg: Errores de sintaxis (comillas faltantes, comas), clave de licencia incorrecta.

   • Conexión a la base de datos: Verifique las credenciales en los archivos de configuración (Paso 3.3). Asegúrese de que el servicio MySQL/MariaDB esté en ejecución.

   • Dependencias faltantes: (Windows) Reinstala el paquete redistribuible de Visual C++. Asegúrate de que todos los recursos base necesarios (como mysql-async o oxmysql, es_extended, qb-core) estén presentes y se inicien antes que los recursos dependientes en server.cfg.

   • Conflicto portuario: Asegúrese de que ninguna otra aplicación esté utilizando el puerto 30120 (o cualquier puerto que haya configurado).

2. No se puede conectar / Conexión rechazada:

   • ¿Servidor en ejecución? Verifique nuevamente la consola para asegurarse de que el servidor terminó de iniciarse sin errores críticos.

   • Cortafuegos: Asegúrate de que el firewall de tu servidor (Firewall de Windows, ufw en Linux, o el firewall de tu proveedor de hosting) permita tráfico TCP y UDP entrante en el puerto 30120 (y 30110 si usas funciones de lista de servidores, más el puerto de TxAdmin si se usa, por ejemplo, 40120).

   • IP/Puerto correcto: ¿Estás usando la dirección IP pública y el puerto correctos en el cliente de FiveM? (Usa 127.0.0.1 solo si te conectas desde la misma máquina).

   • Bloqueo de puertos del ISP: Algunos ISP residenciales bloquean puertos que se usan comúnmente para alojamiento.

3. Recursos que no se cargan / Errores en el juego:

   • Errores de consola: Revisa la consola del servidor (la consola F8 en el juego a menudo muestra errores del lado del cliente, pero la consola del servidor muestra problemas de carga). Busca Could not find resource o Script ERROR relacionados con recursos específicos.

   • ensure Name: Asegúrate de que el nombre en server.cfg (ensure resource_name) coincida exactamente con el nombre de la carpeta en el directorio de resources (¡distingue mayúsculas y minúsculas en Linux!).

   • Dependencias: ¿Olvidaste asegurar un recurso requerido antes del que está dando error? (por ejemplo, intentar usar un ESX función antes de asegurar es_extended).

   • Tablas de base de datos faltantes: Si los scripts se quejan de valores nil o tablas desconocidas, es posible que la importación de tu base de datos haya fallado, o que el script espere tablas que no fueron incluidas. Revisa la documentación del script.

• ¿Necesitas más ayuda? Consulte nuestra sección detallada de solución de problemas.

Servidor instalado: ¿qué hacemos ahora?

¡Felicitaciones! Has instalado y ejecutado tu aplicación correctamente. Servidor FiveM Usando una plantilla FiveMX. La base está establecida.

Ahora comienza la verdadera diversión: personalizando los detalles, invitando jugadores, construyendo tu comunidad y creando configuraciones de juego de roles específicas.

Recuerde que ser propietario de un servidor es un proceso de aprendizaje. No tenga miedo de experimentar (con copias de seguridad!), consulte la documentación (la de FiveM, la específica del script y la nuestra) e interactúe con las comunidades más amplias de FiveM y FiveMX.