FiveMPublicado el 6 de febrero de 2026Lectura de 5 min

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

Los mapeos FiveM (o mappings) añaden al mapa de GTA V edificios, interiores, decorados o zonas enteras. Esta guía explica qué es un mapeo, cómo está estructurado y cómo instalarlo en tu servidor FiveM con OuiPanel, el panel de juego de OuiHeberg. También trata los interiores MLO y los errores más habituales.


¿Qué es un mapeo exactamente?

Un mapeo (o mapa) modifica el entorno de GTA V para añadir elementos al mundo del juego. Puede ser varias cosas.

  • Edificios y estructuras exteriores.

  • Interiores accesibles, llamados MLO.

  • Muebles y objetos de decoración.

  • Cambios en el terreno.

  • Zonas totalmente nuevas.

Un mapeo funciona como cualquier otro recurso de FiveM. Lo colocas en la carpeta resources, lo declaras en server.cfg y el servidor lo carga al arrancar.


Estructura de un mapeo

Un mapeo bien organizado sigue siempre la misma estructura de carpetas.

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

Los archivos principales

El archivo fxmanifest.lua es obligatorio. Le indica a FiveM cómo cargar el recurso.

La carpeta stream/ contiene los archivos del propio mapeo.

  • .ymap define la posición y la colocación de los objetos.

  • .ytyp define los tipos de objetos.

  • .ybn gestiona las colisiones, para que los jugadores no atraviesen los objetos.

  • .ytd contiene las texturas, si el mapeo usa texturas propias.

La carpeta data/, opcional, contiene archivos .meta para ajustes adicionales.


Crear un fxmanifest.lua si el mapeo no tiene uno

Algunos mapeos descargados no tienen manifest. Sin él, FiveM no puede cargar el recurso. Así se crea uno.

Manifest sencillo

Si el mapeo solo tiene una carpeta stream/ con archivos .ymap, .ytyp y .ybn, usa 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 imprescindible. Indica a FiveM que el recurso es un mapeo y que debe cargar por sí solo los archivos de la carpeta stream/.

Manifest con archivos data

Si el mapeo tiene también 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 interior más complejos. Su estructura es así.

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

Y este es el manifest que le corresponde.

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

files {
    'stream/*.ytyp'
}

data_file 'DLC_ITYP_REQUEST' 'stream/*.ytyp'

Algunos MLO necesitan scripts adicionales para definir los puntos de entrada y salida. Lee la documentación del mapeo que instalas.


Instalar el mapeo en tu servidor

Subir la carpeta del mapeo

  1. En OuiPanel, abre tu servidor FiveM y haz clic en Gestor de archivos en el menú lateral.

  2. Abre la carpeta resources.

  3. Si tienes varios mapeos, haz clic en Crear una carpeta y llámala [mapeos]. Ábrela.

  4. En tu ordenador, comprime la carpeta del mapeo en .zip. Arrastra el archivo a la página. Cuando aparezca «Arrastra tus archivos aquí», suéltalo.

  5. Haz clic en los tres puntos de la línea del archivo y luego en Descomprimir. Después, elimina el .zip.

Comprueba que la carpeta descomprimida contiene directamente fxmanifest.lua y stream/, sin carpeta intermedia. La subida está limitada a 100 MB por archivo. Por encima, usa el SFTP como explica la guía Cómo conectarse por SFTP con FileZilla.

Carpeta resources en el Gestor de archivos con el botón Crear una carpeta

Declarar el mapeo en server.cfg

Abre server.cfg en la raíz del servidor, añade una línea ensure para el mapeo y haz clic en Guardar.

ensure nombre-del-mapeo

Con varios mapeos, añade una línea por mapeo.

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

Ventana Edición de server.cfg con las líneas ensure de los recursos

Para los mapeos, usa siempre ensure en lugar de start. Es el comando más fiable para este tipo de recurso.

Respetar el orden de carga

El orden de los recursos en server.cfg puede importar. Por regla general, carga los mapeos después del framework y antes de los scripts de trabajo que los usan.

# Framework
ensure es_extended
ensure esx_skin

# Mapeos
ensure mapeo-comisaria
ensure mapeo-hospital

# Scripts de trabajo
ensure esx_policejob
ensure esx_ambulancejob

Reiniciar el servidor

En la Consola, haz clic en Reiniciar para cargar los mapeos. Luego lee las líneas del arranque. Si todo va bien, ningún error menciona tus mapeos.


Verificar que el mapeo funciona

Entra en el juego y ve a las coordenadas del mapeo. La mayoría de los creadores las indican en la descripción o en un archivo readme.

Si no tienes las coordenadas, búscalas en los archivos .ymap del mapeo, o usa un comando de teletransporte si tienes un menú de administración.


Resolver problemas comunes

El mapeo no aparece

  • Comprueba que fxmanifest.lua existe y contiene this_is_a_map 'yes'.

  • Comprueba que la línea ensure está en server.cfg.

  • Busca errores de carga en la Consola.

  • Asegúrate de estar en las coordenadas correctas en el juego.

Las colisiones no funcionan

Si los jugadores atraviesan los objetos, probablemente falta el archivo .ybn o tiene un nombre incorrecto. Comprueba que corresponde al mapeo.

Error al arrancar el servidor

  • Lee el mensaje de error en la Consola.

  • Revisa la sintaxis de fxmanifest.lua.

  • Asegúrate de que todos los archivos citados existen.

Un mapeo actualizado sigue con su versión antigua

El servidor guarda en caché los archivos que envía a los jugadores. En Configuración FiveM, haz clic en Eliminar el cache, confirma y reinicia el servidor.

El mapeo provoca lag

Los mapeos muy detallados pueden afectar al rendimiento. Algunas ideas.

  • Reduce la distancia de dibujado en los ajustes del mapeo, si la tiene.

  • No acumules demasiados mapeos en una misma zona.

  • Prefiere mapeos optimizados y probados por la comunidad.


Buenas prácticas

Organizar tus mapeos

Agrupa tus mapeos en una carpeta [mapeos] dentro de resources. Así la gestión y el mantenimiento son más fáciles.

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

Probar antes de publicar

Prueba cada mapeo nuevo en un servidor de pruebas antes de añadirlo al servidor principal. Así evitas sorpresas delante de tus jugadores.

Hacer una copia antes de cada cambio

Antes de añadir o modificar un mapeo, crea una copia de seguridad. En el menú lateral, haz clic en Copias de seguridad y luego en Crear copia de seguridad.

Página Copias de seguridad con el botón Crear copia de seguridad y una copia correcta


¿Necesitas ayuda?

Abre un ticket desde Tickets › Abrir un ticket, o desde el recuadro Contactar con el soporte al pie de la ficha de tu servidor en el área de cliente. También puedes preguntar en el Discord de OuiHeberg.

¿Te ha sido útil este artículo?

2290 vistas
Compartir este artículo
FiveM
¿Necesitas un servidor GTA/FiveM?

Descubre nuestros planes de alojamiento GTA V / FiveM desde 2,99 €/mes, con tu servidor listo en 60 segundos.

Ver ofertas →
FiveM
¿Necesitas un servidor GTA/FiveM?

Descubre nuestros planes de alojamiento GTA V / FiveM desde 2,99 €/mes, con tu servidor listo en 60 segundos.

Ver ofertas →

Artículos relacionados

¿No encontraste lo que buscabas?

El equipo de soporte responde 7 días a la semana.

Abrir un ticketDesde tu área de clienteDiscord de la comunidadAyuda y anunciosEstado de los serviciosstatus.ouiheberg.com