Área de cliente
FiveM•6 de febrero de 2026• 42 vistas

Cómo agregar un mapeo en su servidor FiveM: la guía completa

Cómo agregar un mapeo en su servidor FiveM: la guía completa

Cómo añadir un mapeo en tu servidor FiveM: la guía completa

Personalizar el mapa de tu servidor FiveM es lo que marca la diferencia entre un servidor genérico y un universo realmente inmersivo. Los mapeos te permiten añadir edificios, interiores, decoraciones y zonas enteras que no existen en GTA V por defecto.

En esta guía, vamos a ver qué es exactamente un mapeo, cómo está estructurado, cómo instalarlo correctamente en tu servidor y cómo evitar los errores clásicos. Ya sea que añadas una comisaría personalizada, un hospital o un interior MLO completo, tendrás todas las claves en mano.

¿Qué es un mapeo exactamente?

Un mapeo (o map) es una modificación del entorno de GTA V que permite añadir elementos al mundo del juego. Concretamente, puede ser:

  • Edificios y estructuras exteriores
  • Interiores accesibles (MLO)
  • Mobiliario y objetos de decoración
  • Modificaciones del terreno
  • Zonas completamente nuevas

Los mapeos funcionan como cualquier recurso de FiveM: los colocas en tu carpeta de resources, los declaras en el server.cfg, y el servidor los carga al inicio.

Estructura de un mapeo

Un mapeo bien organizado siempre sigue la misma estructura de carpetas. Así es como se ve:

nombre-del-mapeo/
├── fxmanifest.lua
├── stream/
│   ├── archivo1.ymap
│   ├── archivo2.ytyp
│   └── archivo3.ybn
└── data/ (opcional)
    └── archivo.meta

Los archivos principales

fxmanifest.lua — El archivo de configuración obligatorio que indica a FiveM cómo cargar el recurso.

Carpeta stream/ — Contiene los archivos del mapeo propiamente dicho:

  • .ymap: posiciones y colocaciones de los objetos
  • .ytyp: definiciones de los tipos de objetos
  • .ybn: colisiones (para que los jugadores no atraviesen)
  • .ytd: texturas (si el mapeo utiliza texturas personalizadas)

Carpeta data/ (opcional) — Contiene archivos .meta para configuraciones adicionales.

Crear un fxmanifest.lua si el mapeo no tiene uno

Algunos mapeos descargados no tienen un archivo manifest. Sin él, FiveM no puede cargar el recurso. Aquí te mostramos cómo crear uno.

Manifest básico (mapeo simple)

Si tu mapeo contiene únicamente una carpeta stream/ con archivos .ymap, .ytyp y .ybn, utiliza este manifest:

fx_version 'cerulean'
game 'gta5'

author 'TuNombre'
description 'Descripción del mapeo'
version '1.0.0'

this_is_a_map 'yes'

La línea this_is_a_map 'yes' es esencial: indica a FiveM que este recurso es un mapeo y que debe cargar automáticamente los archivos de la carpeta stream/.

Manifest con archivos data

Si tu mapeo también contiene una carpeta data/ con archivos .meta o .ytyp, añade las declaraciones correspondientes:

fx_version 'cerulean'
game 'gta5'

author 'TuNombre'
description 'Descripción del mapeo'
version '1.0.0'

this_is_a_map 'yes'

files {
    'data/*.meta'
}

data_file 'DLC_ITYP_REQUEST' 'data/*.ytyp'

Manifest para un MLO (interior)

Los MLO son mapeos de interiores más complejos. Su estructura se parece a esto:

mlo-interior/
├── fxmanifest.lua
└── stream/
    ├── interior.ymap
    ├── interior.ytyp
    ├── interior_shell.ybn
    └── textures.ytd

Y el manifest correspondiente:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

files {
    'stream/*.ytyp'
}

data_file 'DLC_ITYP_REQUEST' 'stream/*.ytyp'

Nota: Algunos MLO requieren scripts adicionales para definir los puntos de entrada y salida. Verifica la documentación del mapeo que estás instalando.

Instalar el mapeo en tu servidor

Una vez que tu mapeo esté listo con su fxmanifest.lua, la instalación es simple.

Paso 1: Subir la carpeta

Conéctate al gestor de archivos de tu servidor OuiHeberg / OuiPanel y navega hasta la carpeta resources. Crea una subcarpeta para organizar tus mapeos si tienes varios, por ejemplo [mapeos].

Sube la carpeta completa de tu mapeo en resources/[mapeos]/.

[IMAGEN: Captura de pantalla del gestor de archivos mostrando la estructura de resources con una carpeta mapeos que contiene varios mapas]

Paso 2: Declarar en server.cfg

Abre tu archivo server.cfg y añade una línea ensure para cargar el mapeo:

ensure nombre-del-mapeo

Si tienes varios mapeos, añade una línea por mapeo:

# Mapeos
ensure mapeo-comisaria
ensure mapeo-hospital
ensure mapeo-garaje

Importante: Para los mapeos, siempre utiliza ensure en lugar de start. El comando ensure es más fiable para este tipo de recurso.

Paso 3: Respetar el orden de carga

El orden de los recursos en server.cfg puede ser importante. En general, carga tus mapeos después del framework pero antes de los scripts de trabajo que los utilizan:

# Framework
ensure es_extended
ensure esx_skin

# Mapeos
ensure mapeo-comisaria
ensure mapeo-hospital

# Scripts de trabajo
ensure esx_policejob
ensure esx_ambulancejob

Paso 4: Reiniciar el servidor

Reinicia tu servidor para que los mapeos sean cargados. Verifica los logs al inicio: si todo va bien, no deberías ver ningún error relacionado con tus mapeos.

Verificar que el mapeo funciona

Una vez que el servidor se haya reiniciado, conéctate al juego y dirígete a las coordenadas del mapeo. La mayoría de los creadores indican las coordenadas en la descripción o en un archivo readme.

Si no conoces las coordenadas, puedes buscarlas en los archivos .ymap del mapeo o usar un comando de teletransportación si tienes un menú de admin.

Resolver problemas comunes

El mapeo no se muestra

  • Verifica que el fxmanifest.lua existe y contiene this_is_a_map 'yes'
  • Verifica que la línea ensure está presente en server.cfg
  • Verifica los logs del servidor para errores de carga
  • Asegúrate de estar en las coordenadas correctas en el juego

Las colisiones no funcionan (se atraviesan)

  • El archivo .ybn probablemente falta o está mal nombrado
  • Verifica que el archivo de colisión corresponde al mapeo

Error al iniciar el servidor

  • Lee atentamente el mensaje de error en los logs
  • Verifica la sintaxis del fxmanifest.lua
  • Asegúrate de que todos los archivos referenciados existen

El mapeo provoca lags

Algunos mapeos muy detallados pueden impactar el rendimiento. Algunas sugerencias:

  • Reduce la distancia de renderizado en los parámetros del mapeo si es configurable
  • Evita apilar demasiados mapeos en una misma zona
  • Prefiere mapeos optimizados y probados por la comunidad

Buenas prácticas

Organizar tus mapeos

Crea una carpeta [mapeos] en tus resources para agrupar todos tus mapeos. Esto facilita la gestión y el mantenimiento:

resources/
├── [mapeos]/
│   ├── mapeo-comisaria/
│   ├── mapeo-hospital/
│   └── mapeo-garaje/
├── [esx]/
└── ...

Probar antes de desplegar

Siempre prueba un nuevo mapeo en un servidor de prueba antes de añadirlo a tu servidor principal. Esto evita sorpresas desagradables en producción.

Hacer copias de seguridad regularmente

Antes de añadir o modificar mapeos, haz una copia de seguridad de tu servidor. En OuiHeberg, puedes crear backups directamente desde el panel.

En resumen

Agregar mapeos en tu servidor FiveM es bastante simple una vez que entiendes la lógica: una carpeta con los archivos del mapeo, un fxmanifest.lua bien configurado, y una línea ensure en el server.cfg. Los MLO (interiores) a veces requieren un poco más de configuración, pero el principio sigue siendo el mismo.

¿Quieres personalizar tu servidor FiveM con mapeos personalizados? OuiHeberg ofrece planes de alojamiento FiveM con un acceso sencillo a tus archivos para instalar y gestionar tus recursos fácilmente.

Volver a la documentación