Instalace map

Mapy a interiéry (MLO) se do FiveM přidávají jako běžný resource se speciální složkou stream. Soubory z ní se automaticky posílají klientům.

Struktura mapového resource

- - fxmanifest.lua
  - - interior.ymap
    - interior.ytyp
    - props.ydr

Postup

Nahraj resource

Rozbalenou složku nahraj přes FTP do resources/[maps]/.

Zkontroluj manifest

fxmanifest.lua


fx_version 'cerulean'
game 'gta5'
 
this_is_a_map 'yes'
 
files {
  'interior.ytyp'
}
 
data_file 'DLC_ITYP_REQUEST' 'interior.ytyp'

Přidej ensure

server.cfg


ensure moje-mapa

Restartuj a ověř

Zajeď na souřadnice mapy a zkontroluj, že se objekty načetly.

Bez data_file 'DLC_ITYP_REQUEST' se interiér načte jako prázdná díra — hráč propadne pod mapu. Je to nejčastější chyba u MLO.

Kolize dvou map

Dvě mapy na stejném místě se překreslují a hráči vidí blikající objekty. Zkontroluj souřadnice v .ymap a jednu z map odeber.

Pokud mapa nahrazuje výchozí lokaci (např. policejní stanice), používá se často soubor s příponou .ymap se stejným názvem jako originál. To je záměrné — přepíše vanilla verzi.

Vliv na výkon

Každý stream soubor si klient musí stáhnout. Velké mapové balíky prodlužují připojení a zvyšují spotřebu paměti klienta.

Velikost `stream`	Dopad
do 200 MB	zanedbatelný
200 MB – 1 GB	delší první připojení
nad 1 GB	riziko pádů klienta na slabších PC

Tipy

Komprimuj textury. Většina map obsahuje zbytečně velké .ytd.
Přidávej mapy postupně a po každé zkontroluj FPS na místě.

Nenahrávej stream soubory do složky [scripts]. Server je sice pošle, ale ztratíš přehled a při odinstalaci mapy zapomeneš smazat polovinu souborů.

Poznámka

Změny ve stream složce vyžadují restart serveru, refresh nestačí.