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.
.ymapdefine la posición y la colocación de los objetos..ytypdefine los tipos de objetos..ybngestiona las colisiones, para que los jugadores no atraviesen los objetos..ytdcontiene 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
En OuiPanel, abre tu servidor FiveM y haz clic en Gestor de archivos en el menú lateral.
Abre la carpeta
resources.Si tienes varios mapeos, haz clic en Crear una carpeta y llámala
[mapeos]. Ábrela.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.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.

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

Para los mapeos, usa siempre
ensureen lugar destart. 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.luaexiste y contienethis_is_a_map 'yes'.Comprueba que la línea
ensureestá enserver.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.

¿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.
Descubre nuestros planes de alojamiento GTA V / FiveM desde 2,99 €/mes, con tu servidor listo en 60 segundos.
Ver ofertas →