06 - FiveM Application Data

2 min read

FiveM Application Data

INFO

Capire dove FiveM cerca i file è fondamentale per il debug. Se una risorsa non funziona, il 90% delle volte è un problema di percorso.

ObiettivoDettagli
Cosa imparerai• La struttura delle directory di FiveM (client e server)
• Dove installare le risorse per test locale e produzione
• Diagnosticare errori comuni di percorso
Prerequisiti• FiveM installato
• Aver completato i moduli precedenti sugli strumenti

Struttura Directory

%localappdata%/FiveM/
├── FiveM.app/
│   ├── mods/              ← (mod singole, non server)
│   ├── data/              ← cache, update, etc
│   └── citadel/           ← plugin e componenti
│
└── FiveM Server Data/     ← (se hai installato il server)
    └── resources/         ← QUI metti le tue risorse
        ├── [local]/       ← risorse per test locali
        └── [esx]/         ← framework ESX

Dove Installare le Tue Risorse

Server Locale (Test)

%localappdata%/FiveM/FiveM Server Data/resources/
└── my_custom_map/
    ├── fxmanifest.lua
    └── stream/

Avvia il server locale e aggiungi ensure my_custom_map nel server.cfg.

Server Remoto (Produzione)

Su un server dedicato (es. ZAP-Hosting, GTANet, tua VPS):

/home/fivem/server-data/resources/
└── my_custom_map/
    ├── fxmanifest.lua
    └── stream/

Differenza tra Client e Server

AspettoServerClient
Esegue script lato server✅❌
Carica modelli 3D❌✅
Carica texture❌✅
Applica data_file❌✅ (ma dichiarati nel manifest)
Verifica permessi✅❌

INFO

I modelli 3D e le texture vengono caricate SOLO dal client. Il server deve solo sapere che la risorsa esiste e avviarla con ensure.

Risorse [local]

Per testare localmente una risorsa senza un server dedicato:

  1. Avvia FiveM
  2. Vai su Play > Play Solo (local) — ma attenzione: questo non carica risorse custom!
  3. Usa invece il server locale:
    • Scarica FXServer da runtime.fivem.net
    • Configura server.cfg con sv_licenseKey "your_key"
    • Metti le risorse in resources/
    • Avvia con run.cmd + +exec server.cfg

WARNING

La modalità “Play Solo (local)” di FiveM non carica risorse custom. Per testare le tue risorse devi usare un server locale FXServer.

Errori Comuni di Path

ErroreCausaSoluzione
”resource not found”Risorsa non nella cartella resources/Sposta la cartella o controlla server.cfg
”unknown resource”La risorsa non è avviataAggiungi ensure nome_risorsa nel cfg
”file not found”Percorso sbagliato nel fxmanifestControlla files {} — usa * per match
”YMAP not loaded”Manca data_file 'DLC_ITYP_REQUEST'Aggiungi la direttiva nel fxmanifest

QUESTION

Hai già incontrato qualche errore di percorso mentre lavoravi con FiveM? Rivedi la tabella per ricordare le soluzioni più comuni.

TIP

Modulo completato! Ora sei pronto per iniziare con le Mappe Custom.

Torna alla: Indice Generale