__resource.lua a fxmanifest.lua: come convertire uno script vecchio

Inizi uno script vecchio e la console avverte che ancora utilizza __resource.lua, che è deprecato. Lo script potrebbe ancora funzionare, ma è bloccato nel vecchio formato del manifest e non può utilizzare opzioni più recenti come Lua 5.4. Questa guida lo converte a fxmanifest.lua in pochi minuti.

#Cosa è cambiato

Ogni risorsa ha bisogno di un manifest che dice a FiveM quali file caricare. Il vecchio formato era __resource.lua. Il formato attuale è fxmanifest.lua. Le direttive che conosci (client_script, server_script, ui_page, files) sono le stesse. Quello che cambia è l'intestazione.

Un vecchio manifest sembra così:

resource_manifest_version '44febabe-d386-4d18-afbe-5e627f4af937'

client_script 'client.lua'
server_script 'server.lua'

ui_page 'html/index.html'
files {
    'html/index.html',
    'html/script.js',
    'html/style.css',
}

#La nuova intestazione

Sostituisci la riga resource_manifest_version con due righe:

fx_version 'cerulean'
game 'gta5'

fx_version è obbligatorio. Seleziona il comportamento del manifest, e cerulean è la versione che gli script attuali usano. game 'gta5' dice che la risorsa è per GTA V. Il vecchio UUID in resource_manifest_version è sostituito da fx_version: non hai bisogno di tradurlo a un vecchio nome specifico di versione, solo eliminalo.

#Il file completo convertito

fx_version 'cerulean'
game 'gta5'

lua54 'yes'

author 'Your name'
description 'What the resource does'
version '1.0.0'

client_scripts {
    'client.lua',
}

server_scripts {
    'server.lua',
}

ui_page 'html/index.html'

files {
    'html/index.html',
    'html/script.js',
    'html/style.css',
}

Note su ogni parte:

• client_scripts e server_scripts prendono un elenco. Il singolare client_script 'file.lua' funziona ancora per un file.
• shared_scripts carica su entrambi i lati. Un'importazione di framework come '@ox_lib/init.lua' va lì.
• ui_page punta al file HTML del NUI. Ogni file che la pagina carica (JS, CSS, immagini, font) deve essere in files, o non viene inviato al giocatore. I caratteri jolly funzionano: 'html/**/*'.
• files è anche dove elenchi i dati di cui un client ha bisogno ma non esegue, come i file meta.
• author, description e version sono facoltativi e solo informativi.

#Lua 5.4

lua54 'yes' fa eseguire la risorsa su Lua 5.4. Molte risorse attuali lo richiedono. Attivarlo per uno script vecchio di solito è sicuro, ma controlla due cose: uno script che si basa sul vecchio comportamento di Lua 5.3 potrebbe aver bisogno di una piccola correzione, e gli script che usano ox_lib hanno bisogno di Lua 5.4 abilitato. Lascialo fuori se il vecchio script si comporta diversamente con esso, e testalo.

#Mappe, file di dati e asset in streaming

Se il vecchio manifest ha righe data_file per il meta dei veicoli o delle armi, mantienile. Hanno la stessa sintassi in fxmanifest.lua:

files {
    'data/vehicles.meta',
    'data/handling.meta',
}

data_file 'HANDLING_FILE' 'data/handling.meta'
data_file 'VEHICLE_METADATA_FILE' 'data/vehicles.meta'

I modelli e le texture in streaming in una cartella stream non hanno bisogno di alcuna voce. Per una risorsa solo mappa, aggiungi anche this_is_a_map 'yes'.

#Rimuovi il vecchio file

Dopo la conversione, elimina __resource.lua dalla cartella. Lasciare entrambi i file in posizione è confuso per chiunque mantiene il server in seguito, e solo uno di loro dovrebbe descrivere la risorsa.

Quindi riavvia la risorsa:

refresh
ensure my_script

refresh è necessario perché il manifest è cambiato. Se il manifest ha un errore, la risorsa non si avvierà: vedi Couldn't start resource per leggere l'errore sopra quella riga.

#Errori comuni dopo la conversione

• Un fx_version o game mancante. Il manifest è rifiutato.
• Una virgola mancante dentro { }. Ogni voce in un elenco è separata da una virgola.
• File mancanti da files. Il NUI si carica ma le immagini o gli script sono vuoti, perché la pagina ha chiesto qualcosa che non è stato inviato. Controlla la console F8 e gli strumenti di sviluppo NUI per le richieste non riuscite.
• Una dipendenza che non è dichiarata. Aggiungi dependency 'ox_lib' se lo script lo usa, in modo che l'ordine di avvio sia controllato. Vedi Could not find dependency.

Attenzione: non impostare fx_version a un nome molto vecchio copiato da un tutorial del 2019 solo per abbinare l'età dello script. Usa cerulean e correggi tutto ciò che si rompe.

#Elenco di controllo