__resource.lua do fxmanifest.lua: jak przekonwertować stary skrypt

Uruchamiasz stary skrypt i konsola ostrzega, że wciąż używa __resource.lua, które jest wycofane. Skrypt może wciąż działać, ale jest zablokowany w starym formacie manifestu i nie może użyć nowszych opcji, takich jak Lua 5.4. Ten przewodnik konwertuje to na fxmanifest.lua w kilka minut.

#Co się zmieniło

Każdy zasób potrzebuje manifestu, który mówi FiveM, które pliki załadować. Stary format to __resource.lua. Obecny format to fxmanifest.lua. Dyrektywy, które znasz (client_script, server_script, ui_page, files), są takie same. To, co się zmienia, to nagłówek.

Stary manifest wygląda tak:

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',
}

#Nowy nagłówek

Zastąp linię resource_manifest_version dwiema liniami:

fx_version 'cerulean'
game 'gta5'

fx_version jest wymagane. Wybiera zachowanie manifestu, a cerulean to wersja, którą używają bieżące skrypty. game 'gta5' mówi, że zasób jest dla GTA V. Stary UUID w resource_manifest_version jest zastąpiony przez fx_version: nie musisz go tłumaczyć na konkretną starą nazwę wersji, po prostu go usuń.

#Pełny przekonwertowany plik

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',
}

Notatki o każdej części:

• client_scripts i server_scripts przyjmują listę. Pojedyncze client_script 'file.lua' wciąż działa dla jednego pliku.
• shared_scripts ładuje po obu stronach. Import frameworku, taki jak '@ox_lib/init.lua', tam idzie.
• ui_page wskazuje plik HTML NUI. Każdy plik, który strona ładuje (JS, CSS, obrazy, czcionki), musi być w files, inaczej nie zostanie wysłany do gracza. Wildcardy działają: 'html/**/*'.
• files to również miejsce, gdzie wyświetlasz dane, które klient potrzebuje, ale nie uruchamia, takie jak pliki meta.
• author, description i version są opcjonalne i tylko informacyjne.

#Lua 5.4

lua54 'yes' sprawia, że zasób działa na Lua 5.4. Wiele obecnych zasobów tego wymaga. Włączenie go dla starego skryptu jest zwykle bezpieczne, ale sprawdź dwie rzeczy: skrypt, który polega na starym zachowaniu Lua 5.3, może potrzebować małej poprawki, a skrypty, które używają ox_lib, potrzebują Lua 5.4 włączonego. Pomiń to, jeśli stary skrypt zachowuje się inaczej z nim i przetestuj to.

#Mapy, pliki danych i zasoby przesyłane

Jeśli stary manifest ma linie data_file dla meta pojazdu lub broni, je zachowaj. Mają tę samą składnię w fxmanifest.lua:

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

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

Przesyłane modele i tekstury w folderze stream nie potrzebują żadnego wpisu. Dla zasobu tylko mapy dodaj również this_is_a_map 'yes'.

#Usuń stary plik

Po konwersji usuń __resource.lua z folderu. Pozostawienie obu plików na miejscu jest mylące dla każdego, kto później utrzymuje serwer, i tylko jeden z nich powinien opisywać zasób.

Następnie uruchom ponownie zasób:

refresh
ensure my_script

refresh jest potrzebne, ponieważ manifest się zmienił. Jeśli manifest ma błąd, zasób się nie uruchomi: zobacz Couldn't start resource, aby przeczytać błąd ponad linią.

#Częste błędy po konwersji

• Brakujący fx_version lub game. Manifest jest odrzucony.
• Brakujący przecinek wewnątrz { }. Każdy wpis na liście jest oddzielony przecinkiem.
• Pliki brakują w files. NUI ładuje się, ale obrazy lub skrypty są puste, ponieważ strona prosiła o coś, co nie zostało wysłane. Sprawdź konsolę F8 i narzędzia deweloperskie NUI dla nieudanych żądań.
• Zależność, która nie jest zadeklarowana. Dodaj dependency 'ox_lib', jeśli skrypt to używa, aby sprawdzać kolejność uruchamiania. Przeczytaj Could not find dependency.

Ostrzeżenie: nie ustawiaj fx_version na bardzo starą nazwę skopiowaną z poradnika z 2019 roku, aby dopasować wiek skryptu. Użyj cerulean i napraw wszystko, co się psuje.

#Lista kontrolna