Instalación y configuración de su 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 repleta de funciones. Tanto si eres un propietario de servidores experimentado como si estás empezando, esta guía completa te guiará paso a paso para descargar, instalar y ejecutar tu plantilla de servidor de forma eficaz.

If you’ve purchased a complete server package from us and are wondering “What next?”, you’re in the exact right place. We’ll turn that downloaded .zip file into a living, breathing El servidor FiveM está listo para los jugadores.

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

Before we dive in, let’s quickly recap why starting with a FiveMX template accelerates your journey:

• 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: Nuestras plantillas están listas para usar y son totalmente personalizables. Obtendrás una base sólida sobre la que podrás agregar fácilmente características, vehículos o guiones únicos que se ajusten a 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 (que suele colaborar con FiveM), OVH, Hetzner o Contabo son opciones populares. Asegúrate de que cumpla con las especificaciones recomendadas por FiveM (consulta la documentación de Cfx.re para obtener 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 (Free, Recommended), Notepad++, or Sublime Text. Avoid Windows Notepad as it can mess up file encodings.

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: Descargar la plantilla de su 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: Locate the server template you bought and click the download button. It will arrive as a .zip archive. Save it somewhere easily accessible, like your Desktop or a dedicated “FiveM Server” folder.

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 sin problemas. ¡No lo omitas!

1. Configurar su servidor base FiveM:

   • Download Artifacts: Go to the official FiveM documentation (docs.cfx.re) and find the link for the latest recommended server artifacts for your operating system (Windows or Linux). Download these.

   • Crear directorio del servidor: Create a main folder for your server (e.g., C:FXServer or /home/user/FXServer).

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

   • Create server-data Directory: Inside your main server directory, create a sub-folder named server-data. This is where your resources and configuration will live, keeping things organized and separate from the core server files. Our template files will go inside this server-data folder.

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

   • ¿Por qué? Servidores FiveM, especialmente servidores de juego de rol que utilizan marcos como ESX o 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: Download the MySQL Community Server installer or MariaDB installer from their official websites. Follow the installation wizard. During installation, securely note down the root password you set.

     • Linux (Debian/Ubuntu): Use the package manager: sudo apt update && sudo apt install mariadb-server. Run sudo mysql_secure_installation afterwards to set the root password and secure the installation.

     • Linux (CentOS/RHEL): Use the package manager: sudo yum update && sudo yum install mariadb-server. Start the service sudo systemctl start mariadb and enable it on boot sudo systemctl enable mariadb. Run sudo mysql_secure_installation.

   • Verificación: Ensure the database service is running (services.msc on Windows, sudo systemctl status mariadb on Linux).

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

   • ¿Por qué? While you can manage MySQL/MariaDB via the command line, a graphical tool makes creating databases, importing data, and browsing tables much easier.

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

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

   • ¿Por qué? Many FiveM resources, and FiveM itself, rely on Microsoft’s Visual C++ libraries. Missing these is a very common cause of server startup failures or script errors.

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

Paso 3: Instalación de la plantilla del servidor

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

1. Extraer los archivos de plantilla:

   • Open the .zip file you downloaded from FiveMX.com.

   • Extract its entire contents directly into the server-data folder you created in Step 2.

   • Crucial: Ensure the file structure is correct. You should see folders like resources and potentially files like server.cfg directly inside server-data, not nested within an extra folder named after the template (e.g., NOT server-data/MyTemplateName/resources, but server-data/resources).

2. Configurar la base de datos:

   • Localice el archivo SQL: Inside the extracted template files (likely within the main server-data directory or a dedicated _INSTALL folder), find the database file. It usually ends with .sql (e.g., 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 (or localhost) if the database is on the same machine as HeidiSQL. If your database is hosted elsewhere, use its IP address.

     • User: root (or the specific user you created, though root is fine for local setups).

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

     • Port: Usually 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”.

     • Execute the command: CREATE DATABASE IF NOT EXISTS your_database_name; (Replace your_database_name with a name you choose, e.g., 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.

     • Go to File -> Run SQL file….

     • Navigate to and select the .sql file from your template.

     • 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: The exact location varies between templates and frameworks (ESX, QBCore). Common places include:

     • Directly in server-data/server.cfg.

     • In a specific resource’s config file, like server-data/resources/[esx]/es_extended/config.lua or server-data/resources/[qb]/qb-core/config.lua.

     • Sometimes in a dedicated database connection script like ghmattimysql or oxmysql. Check the template’s documentation or server.cfg for start or ensure lines related to 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: Replace “YourPassword” with your actual database root password and “your_database_name” with the exact database name you created in HeidiSQL. Ensure the host (127.0.0.1 or localhost) and user (root) are correct.

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

4. Review and Configure server.cfg:

   • Open the server-data/server.cfg file with your text editor. This is the main configuration file for your FiveM server.

   • Configuraciones esenciales:

     • sv_licenseKey “your_license_key”: Replace “your_license_key” with the key you generated from the FiveM Keymaster. Esto es obligatorio para que el servidor aparezca en la lista y funcione correctamente.

     • sv_hostname “My Awesome FiveMX Server”: Change this to your desired server name as it will appear in the server list. Use colors and emojis if you like (using Códigos de formato de FiveM).

     • sv_maxclients 48: Set the maximum player slots (ensure your license type supports this number – standard keys support up to 48, higher tiers via Patreon).

     • sv_projectDesc “A description of my server.”: Set a short description that appears in some server lists or details panels.

     • sets steam_webApiKey “YOUR_STEAM_API_KEY”: 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 …: These lines load your resources. The FiveMX template should have these pre-configured. The order can sometimes matter, especially for frameworks (e.g., ensure es_extended before ESX addons). Don’t change the order unless you know what you’re doing or following specific instructions.

   • Revisar otras configuraciones: Look through the file for any other settings specific to the template (like locale, starting money, script-specific convars) and adjust as needed. Comments (# or — at the start of a line) often explain what settings do.

   • Save the server.cfg file.

Listo por ahora.

Paso 4: Iniciar su servidor

¡Es hora de ponerlo en línea!

• Navegue al directorio correcto: Open your server’s main directory (e.g., C:FXServer or /home/user/FXServer), the one containing the FXServer.exe or run.sh file, NO the server-data directory.

• Para usuarios de Windows:

  1. Find run.cmd or similar: Look for a batch file typically named run.cmd or sometimes start.bat. Often it will reference the server-data directory, like +exec server.cfg +set txAdminPort 40120.

  2. Doble clic: Double-click the run.cmd (or equivalent) file.

  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): Ensure the start script is executable: chmod +x run.sh.

  3. Ejecutar el script: Execute the start script: ./run.sh +exec server.cfg. (The +exec server.cfg part might already be inside the run.sh script itself).

  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: Look for messages indicating resources are starting (often green text like Started resource MyResource).

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

  • Authentication failure: Could not connect to database. (Check Step 3.3 – Database Credentials).

  • Could not find resource X. (Check if the resource folder exists in resources and the ensure X line in server.cfg matches the folder name exactly).

  • Script ERROR: … (Indicates a problem within a specific script’s code. May require debugging or checking for compatibility issues).

  • 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. Type connect 127.0.0.1:30120 (if running the server on the same machine you’re playing on) or connect YOUR_SERVER_IP:30120 (if the server is hosted elsewhere, use its public IP address). The default port is 30120 unless changed in your startup script or server.cfg.

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

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

Your server is running, but now you want to make it yours.

• ¡Primero la copia de seguridad! Before making major changes, stop the server and make a backup of your server-data folder and your database (use HeidiSQL’s export feature).

• Cambiar logotipos/pantallas de carga: Look for resources related to visuals (e.g., loadingscreen, scoreboard) and check their html, css, js files or config.lua for customization options. Replace image files (like logo.png) with your own, keeping dimensions similar.

• Configurar trabajos/actividades: Explore the configuration files (config.lua is common) within specific resource folders (e.g., resources/[jobs]/policejob/config.lua) to adjust job payouts, locations, required ranks, etc.

• Agregar/Eliminar vehículos: To add custom vehicles, you typically place the vehicle resource folder into your resources directory and add ensure vehicle_resource_name to your server.cfg. Consult guides specific to adding vehicles. Removing is the reverse (delete folder, remove ensure line).

• 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.

Paso 6: Administración y mantenimiento de su servidor

Ejecutar un servidor es un proceso continuo:

• Copias de seguridad periódicas: Seriously, automate this if possible. Back up your server-data folder (especially the resources subfolder and server.cfg) and your database (.sql dump) daily or at least several times a week. Store backups off-site if possible. Check out our dedicated backup tutorial [Link to your backup tutorial here]!

• Manténgase actualizado:

  • Artefactos FiveM: Periodically check the FiveM documentation for new recommended server builds and update your core server files (usually involves replacing the files outside server-data). Read changelogs first!

  • 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: Individual script creators often update their resources on platforms like GitHub. Updating requires replacing the resource folder and checking for configuration changes. Be cautious, as updates can sometimes break things or conflict with other scripts.

• Monitorizar el rendimiento: Use server monitoring tools (like txAdmin included with FiveM, or resource monitors like htop on Linux / Task Manager on Windows) to check CPU/RAM usage. High usage might indicate poorly optimized scripts.

• 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: Scroll up in the server console window/log file. Look for the first error message. This often points to the root cause.

   • Check 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) Reinstall Visual C++ Redistributable. Ensure all required base resources (like mysql-async or oxmysql, es_extended, qb-core) are present and started before dependent resources in 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: Ensure your server’s firewall (Windows Firewall, ufw on Linux, or your hosting provider’s firewall) allows incoming TCP and UDP traffic on port 30120 (and 30110 if using server list features, plus TxAdmin port if used e.g. 40120).

   • IP/Puerto correcto: Are you using the correct public IP address and port in the FiveM client? (Use 127.0.0.1 only if connecting from the same machine).

   • 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: Check the server console (F8 console in-game often shows client-side errors, but server console shows loading issues). Look for Could not find resource or Script ERROR related to specific resources.

   • ensure Name: Ensure the name in server.cfg (ensure resource_name) exactly matches the folder name in the resources directory (case-sensitive on Linux!).

   • Dependencias: Did you forget to ensure a required resource before the one that’s erroring? (e.g., trying to use an ESX función antes de asegurar es_extended).

   • Tablas de base de datos faltantes: If scripts complain about nil values or unknown tables, your database import might have failed, or the script expects tables that weren’t included. Check the script’s documentation.

• ¿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 a jugadores, construyendo tu comunidad y creando experiencias únicas.

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.