$ USD
Come aggiungere un MLO FiveM al tuo server
Stai testando una mappa gratuita?
Le MLO gratuite sono utili per i prototipi. Per un server RP live, confronta gli interni premium e i pacchetti server prima del lancio.
Pubblico: Proprietari di server e sviluppatori che gestiscono già un'istanza FiveM funzionale e desiderano estenderla con risorse di mappe interne/esterne (MLO) personalizzate.
1 · Prerequisiti
| Requisito | Versione minima | Perché è importante |
|---|---|---|
| Artefatto del server FiveM | 6016 (build 7116) o più recente | Gli artefatti più vecchi non possono caricare quelli moderni ceruleo fx si manifesta. |
| Caricatore di mappe (già integrato) | Nativo per impostazione predefinita | Nessun plugin aggiuntivo necessario:FiveM streams map files automatically. |
| Accesso al server | SFTP/SSH + permessi di scrittura | Devi caricare i file e modificarli server.cfg. |
| licenza legale | Prova d'acquisto / termini di utilizzo gratuito | Il GDPR dell'UE e la politica di Rockstar vietano la distribuzione di risorse senza licenza. |
2 · Scarica e ispeziona il pacchetto MLO
- Integrità della fonte – Preferire fornitori con zip firmati SHA-256 o tag Git pubblici.
- Verifica la struttura – Una risorsa conforme assomiglia a:
my-mlo/ ├─ stream/ │ ├─ *.ydr ↰ (modelli) │ ├─ *.ytyp ↰ (definizioni degli elementi) │ ├─ *.ybn ↰ (collisioni‑―se fornite) │ └─ *.ytd ↰ (texture) ├─ fxmanifest.lua └─ README.md (facoltativo)
- Creare
fxmanifest.luase mancante – Modello minimo:
fx_version 'cerulean' giochi { 'gta5' } autore 'YourName' descrizione 'Il mio MLO personalizzato' versione '1.0.0' this_is_a_map 'yes' file { 'stream/**/*.ydr', 'stream/**/*.ytyp', 'stream/**/*.ytd', 'stream/**/*.ybn' } data_file 'DLC_ITYP_REQUEST' 'stream/**/*.ytyp'
ℹ️ I manifesti delle risorse standard seguono lo schema in Documentazione FiveM → “Manifesto delle risorse” (impegno 20b7b15, 2025-03-11)
3 · Carica la risorsa
- Connettiti tramite SFTP alla radice del tuo server.
- Vai a
/risorse/[mappe]/—crea la cartella bracket-folder se non esiste. - Carica l'intero
mio-mloelenco invariatoEvitare spazi e maiuscole nei nomi delle cartelle per prevenire problemi di percorso in Linux.
4 · Registrati in server.cfg
Aggiungi (o sostituisci inizio) Dopo risorse di base essenziali:
assicura che my-mlo # venga caricato all'avvio; si riavvia automaticamente al riavvio software di txAdmin
Salva il file e ricomincia il server o eseguire aggiornare ➜ assicurati my-mlo nella console live.
5 · Cancella la cache e riavvia (se necessario)
FiveM memorizza nella cache i dati delle mappe. Per evitare ghost di versioni precedenti:
# Linux rm -rf cache/* ./run.sh +exec server.cfg # Windows (PowerShell) Remove-Item -Recurse -Force .cache* run.cmd +exec server.cfg
Come cancellare la cache dei server FiveM
6 · Lista di controllo per la verifica in gioco
| Controllo | Comando/strumento | Criteri di superamento |
| Teletrasporto | vMenu → Varie → Teletrasporto → Inserisci coordinate | Il giocatore appare nel nuovo interno/esterno. |
| Integrità della trama | profilo_frame poi cammina in giro | Nessun segnaposto rosa/bianco; perdita di FPS < 10%. |
| Collisione | Muri e rampe pedonali | Nessuna barriera invisibile o caduta attraverso il pavimento. |
| Illuminazione | Cambiamento del ciclo temporale con /tempo 23 0 | L'interno si scurisce/illumina correttamente senza artefatti. |
Se si verificano errori, rivedere l'elenco dei file mancanti .anno corrente O .ybn è il solito colpevole.
7 · Streaming di più MLO in modo sicuro
- Una risorsa per MLOIn questo modo si evitano le collisioni di hash.
- Aggiungere il prefisso ai nomi con il tag del fornitore, ad esempio
bh-bank-lobby, per una disattivazione più semplice. - Utilizzare la stessa versione del manifesto per tutte le risorse della mappa per evitare avvisi di analisi.
8 · Risoluzione dei problemi Quick-Ref
| Sintomo | Probabile causa | Risoluzione |
| Consolle: Impossibile analizzare il manifesto | Sintassi Lua errata | Correre lua -p fxmanifest.lua localmente; correggere virgolette/virgole. |
| MLO visibile, texture mancanti | .anno corrente file non referenziati | Aggiungili a file{} o posto in flusso/. |
| I giocatori si bloccano all'ingresso | Hash prop duplicato su tutte le mappe | Rinomina duplicato .ydr oppure scaricare la risorsa in conflitto. |
| Long download time | Grande .anno corrente texture | Comprimi le texture (DXT5 / BC3) o riduci la scala. |
9 · Note sulla conformità e sulla protezione dei dati
| Regolamento / Politica | Cosa devi fare |
| Politica di Rockstar Modding (2015-09-15) | Non vendere asset contenenti IP Rockstar. |
| GDPR UE artt. 44-49 | Conservare le fatture dei fornitori; comunicare l'origine delle risorse su richiesta dell'utente. |
| FiveM ToS §3.2 | Mantieni intatti i crediti; non ridistribuire pubblicamente le mod a pagamento. |
Conclusione
Carica → garantire → riavvia; se il manifesto è valido, il tuo nuovo interno sarà attivo entro due minuti.
Hai bisogno di nuovi MLO?
Fonti
- FiveM Docs – Manifesti delle risorse (consultato il 22 maggio 2025)
- Rockstar Games – Politica di modding, 15 settembre 2015
- Regolamento (UE) 2016/679 (GDPR), articoli 44-49
Lista di controllo pratica
Utilizzate questa guida come checklist di preparazione prima di apportare modifiche a un server FiveM in produzione. Verificate la versione corrente dell'artefatto del server, la versione del framework, le dipendenze delle risorse, le modifiche al database e tutti i file lato client prima di applicare la modifica.
- Eseguire il backup dei file di configurazione e delle tabelle del database interessati.
- Applica la modifica prima su un server di test.
- Monitorare la console del server e la console F8 del client per rilevare eventuali errori.
- Verifica se la modifica influisce su lavori, inventario, veicoli, mappe, voce, permessi o dati dei giocatori.
- Documenta esattamente il file, il comando o l'impostazione che hai modificato, in modo da poterli ripristinare rapidamente.
Test prima della produzione
Dopo il primo test, accedi con un account giocatore normale e ripeti il flusso dal punto di vista del giocatore. Se l'argomento riguarda le prestazioni, misura prima e dopo con lo stesso numero di giocatori, percorso e set di risorse. Se riguarda strumenti di amministrazione o autorizzazioni, verifica sia gli utenti autorizzati che quelli a cui è negato l'accesso.
Errori comuni
La maggior parte dei problemi con FiveM deriva da dipendenze mancanti, cache obsoleta, nomi di cartelle errati, incompatibilità del framework o configurazione copiata da un altro server. Evita di modificare più sistemi contemporaneamente; apporta una modifica, testala e poi continua.
Risorse correlate
Per le risorse pronte per la produzione, confronta le risorse a pagamento nel Negozio FiveMX. Per risorse gratuite, sfoglia script gratuiti FiveM e testare ogni risorsa prima di utilizzarla pubblicamente.
Note di avvio della produzione
Before using this guidance on a live FiveM server, define the exact outcome you expect from the change. For How to Add a FiveM MLO to Your Server, that means checking which resource, setting, command, or workflow is affected and confirming that the change fits your current framework, artifact version, and server rules. Keep the rollout small enough that you can reverse it quickly if players report errors.
Utilizza un server di staging con lo stesso framework, schema del database, ordine delle risorse e dipendenze chiave dell'ambiente di produzione. Se la modifica riguarda il gameplay, i permessi, la grafica, le voci, i veicoli, le mappe, l'inventario o il comportamento dell'economia, esegui dei test con almeno un account amministratore e un account giocatore normale. Monitora l'output della console del server, i log F8 del client e i tempi di utilizzo delle risorse, ripetendo esattamente il flusso di gioco che si verificherà sul server di produzione.
Lista di controllo per il rollback
- Prima di apportare qualsiasi modifica, salva il file di configurazione precedente, la cartella delle risorse e lo stato del database.
- Annota la versione della risorsa, il commit, la pagina di download o il valore dell'impostazione che hai testato.
- Se possibile, riavvia prima solo la risorsa interessata, poi riavvia l'intero server se le dipendenze lo richiedono.
- Se si verificano errori, ripristinare la singola risorsa o impostazione modificata prima di provare un'altra soluzione.
Guida alla manutenzione
Rivedete questa configurazione dopo gli aggiornamenti degli artefatti FiveM, gli aggiornamenti del framework o le modifiche sostanziali alle risorse. Una configurazione che funziona oggi potrebbe smettere di funzionare dopo gli aggiornamenti delle dipendenze, la ridenominazione delle esportazioni, la modifica degli eventi o le migrazioni del database. Conservate le note insieme alla documentazione del server in modo che i futuri amministratori possano comprendere cosa è stato modificato, perché è stato modificato e come verificarlo nuovamente.
Revisione in corso
Recheck How to Add a FiveM MLO to Your Server after major FiveM artifact updates, framework changes, or resource migrations. Confirm that the advice still matches current server behavior, that any linked source remains available, and that installation steps still match the files a server owner will actually download or configure.
Per i server pubblici, tenete un breve registro delle modifiche accanto alla documentazione del server. Annotate cosa è stato testato, cosa è cambiato, quali account sono stati utilizzati per la verifica e come ripristinare la versione precedente. Questo velocizza la manutenzione futura ed evita che le vecchie note di configurazione diventino poco chiare o pericolose per i giocatori.
