05 - Struttura fxmanifest

Struttura fxmanifest.lua

INFO

Il fxmanifest.lua (o __resource.lua per FiveM legacy) è il file di ingresso di ogni risorsa FiveM. Dice al server cosa caricare e come.

Obiettivo	Dettagli
Cosa imparerai	• Strutturare un fxmanifest.lua per diversi tipi di risorsa • Usare la cartella stream/ per il caricamento automatico • Configurare data_file e files {} correttamente
Prerequisiti	• Familiarità con FiveM e le risorse • Un editor di testo (VS Code, Notepad++, ecc.)

---

Anatomia di Base

-- fxmanifest.lua
-- File obbligatorio per ogni risorsa FiveM
 
-- Versione del manifest (usa sempre 'cerulean' per FiveM moderno)
fx_version 'cerulean'
game 'gta5'
 
-- Autore e descrizione (opzionale ma consigliato)
author 'Il Tuo Nome'
description 'Descrizione della risorsa'
version '1.0.0'
 
-- Cosa caricare (file specifici)
files {
    -- Per mappe:
    'stream/*.ydr',
    'stream/*.ybn',
    'stream/*.ytd',
    'stream/*.ytyp',
    'stream/*.ymap',
 
    -- Per armi:
    'stream/*.weaponlayouts.meta',
    'stream/*.weaponanimations.meta',
 
    -- Per ped:
    'stream/*.yft',
    'stream/*.ydd',
    'stream/*.ymt',
 
    -- Per vestiti:
    'stream/*.ydd',
    'stream/*.ytd',
}
 
-- Caricamento automatico nella cartella stream/
data_file 'DLC_ITYP_REQUEST' 'stream/*.ytyp'
data_file 'DLC_WEAPON_PICKUP' 'stream/*.weaponpickups.meta'
 
-- Script Lua (se la risorsa ha logica)
client_script 'client.lua'
server_script 'server.lua'

---

Campi Fondamentali

Campo	Valore	Descrizione
fx_version	cerulean	Versione più recente di FiveM
game	gta5	Gioco target (obbligatorio)
files {}	—	Lista di file da includere nella risorsa
data_file	—	Dichiara tipi di dati speciali al motore
client_script	—	Script eseguito sul client
server_script	—	Script eseguito sul server
stream	—	Cartella speciale: tutti i file qui dentro sono caricati automaticamente

---

Uso della Cartella stream/

FiveM ha una cartella speciale chiamata stream/. Qualsiasi file messo in stream/ viene automaticamente rilevato e caricato dal motore di gioco — non serve elencarli in files {}.

my_resource/
├── fxmanifest.lua
├── client.lua
├── server.lua
└── stream/               ← caricamento automatico
    ├── my_map.ydr
    ├── my_map.ybn
    ├── my_map.ytd
    ├── my_map.ytyp
    └── my_map.ymap

TIP

Regola pratica: Metti TUTTI i file di asset (ydr, ybn, ytd, ytyp, ymap, yft, ydd, ymt) nella cartella stream/. Usa files {} e data_file solo se necessario per file fuori da stream/ o per tipi speciali.

---

Data File Types Comuni

WARNING

I nomi di data_file devono combaciare con la documentazione ufficiale. Quelli sotto sono i più comuni verificati. Per la lista completa vedi Data Files.

-- Per mappe
data_file 'DLC_ITYP_REQUEST' 'stream/*.ytyp'
 
-- Per armi
data_file 'WEAPON_INFO_FILE' 'stream/*.weaponlayouts.meta'
data_file 'WEAPON_ANIMATIONS_FILE' 'stream/*.weaponanimations.meta'
data_file 'WEAPON_PICKUP_FILE' 'stream/*.weaponpickups.meta'
 
-- Per ped
data_file 'PED_METADATA_FILE' 'stream/*.pedpersonality.meta'
 
-- Per veicoli
data_file 'VEHICLE_METADATA_FILE' 'stream/*.vehicles.meta'
data_file 'HANDLING_FILE' 'stream/*.handling.meta'
data_file 'VEHICLE_VARIATION_FILE' 'stream/*.carvariations.meta'
data_file 'CARCOLS_FILE' 'stream/*.carcols.meta'
 
-- Per vestiti
data_file 'SHOP_PED_APPAREL_META_FILE' 'stream/*.shop_ped_apparel.meta'

WARNING

Dimenticare la direttiva data_file è uno degli errori più comuni. Senza di essa, FiveM non caricherà correttamente ytyp, weaponlayouts e altri dati speciali, anche se i file sono nella cartella stream/.

NOTE

Nota di accuratezza: gli esempi di data_file variano per tipo di risorsa. Se una risorsa non carica, confronta sempre il nome del data_file con la doc ufficiale o con un template verificato. Vedi Convenzioni e Disclaimer.

---

Esempio Completo per Diversi Tipi

Risorsa Mappa

fx_version 'cerulean'
game 'gta5'
 
author 'TuoNome'
description 'Mappa Personalizzata - Downtown Mod'
version '1.0.0'
 
data_file 'DLC_ITYP_REQUEST' 'stream/*.ytyp'
 
-- Attenzione: se lo ytyp è in stream/,
-- FiveM lo carica automaticamente, ma
-- il data_file DLC_ITYP_REQUEST è necessario
-- per registrare i tipi di oggetti

Risorsa Arma

fx_version 'cerulean'
game 'gta5'
 
author 'TuoNome'
description 'Arma Custom - M4A1 Tactical'
version '1.0.0'
 
files {
    'stream/*.weaponlayouts.meta',
    'stream/*.weaponanimations.meta',
}
 
data_file 'WEAPON_INFO_FILE' 'stream/*.weaponlayouts.meta'
data_file 'WEAPON_ANIMATIONS_FILE' 'stream/*.weaponanimations.meta'
data_file 'WEAPON_PICKUP_FILE' 'stream/*.weaponpickups.meta'

QUESTION

Sai già che tipo di risorsa creerai? Una mappa, un’arma, un ped o un vestito? La struttura dell’fxmanifest cambia in base al tipo.

---

TIP

Prossimo passo: 06 - FiveM Application Data

---

Torna alla: Indice Generale