Zainstaluj każdą mapę lub pojazd jako niezależny zasób, zachowaj jego oryginalną strukturę, zadeklaruj tylko potrzebne pliki danych i przetestuj go na stagingu przed produkcją. Mapy i pojazdy dzielą ten sam cykl życia zasobu, ale ich zasoby i kroki walidacji różnią się.
Przeglądano 9 sierpnia 2026 r. w odniesieniu do oficjalnego Cfx.re manifest zasobu, plik-danych I tworzenie zasobów referencje. Inspekcja mapy może wykorzystać utrzymywany projekt CodeWalker.
Wybierz poprawną ścieżkę
| Zasób | Typowa zawartość | Głębszy przewodnik |
|---|---|---|
| Mapa/MLO | .ymap, .ytyp, modele, tekstury i kolizje |
Dodaj FiveM MLO do serwera |
| Pojazd | .yft, .ytd i udokumentowane pliki meta pojazdów |
Postępuj zgodnie z aktualnymi instrukcjami instalacji pakietu. |
Wspólne przygotowanie do lotu
- Zweryfikuj twórcę, źródło, licencję, wersję i obsługiwany build gry/framework.
- Przeskanuj archiwum i zachowaj oryginalny pakiet jako dowód wycofania.
- Zrób kopię zapasową konfiguracji i wszelkich zasobów, które pakiet zastępuje.
- Rozpakuj do dedykowanego folderu zasobu z
fxmanifest.luau jego korzenia. - Przeczytaj zależności i instrukcje instalacji przed zmianą manifestu.
Zainstaluj zasób mapy
Zachowaj dostarczone .ymap, .ytyp, pliki modelu, tekstury i kolizji razem. Zachowaj manifest twórcy. Użyj this_is_a_map lub DLC_ITYP_REQUEST deklaracji tylko wtedy, gdy pakiet i bieżąca dokumentacja Cfx.re tego wymagają; ślepe dodawanie dyrektyw może ukryć rzeczywisty błąd pakowania.
Uruchom zasób na stagingu, przejedź pełną granicę, sprawdź wnętrza i kolizje oraz poszukaj zduplikowanych umiejscowień map lub innych zasobów edytujących ten sam obszar. Testuj z daleka i po ponownym połączeniu, nie tylko w punkcie odrodzenia.
Zainstaluj zasób pojazdu
Zachowaj zasoby modelu i tekstury z dokładnymi udokumentowanymi plikami metadanych. Typowe pakiety używają wpisów takich jak pojazdy, obsługa, wariacje samochodów i kolory samochodów, ale poprawne data_file typy pochodzą z pakietu i oficjalnego odniesienia do plików danych. Nie wklejaj każdej znanej deklaracji do każdego manifestu pojazdu.
Nazwa modelu nie gwarantuje polecenia odrodzenia. Odrodzenie należy do zainstalowanego frameworka, menu administratora lub zasobu pojazdu. Zweryfikuj skonfigurowaną nazwę modelu i użyj udokumentowanego polecenia lub przepływu pracy garażu.
Włącz w kolejności zależności
Dodaj jeden ensure resource-name linii po wymaganych bibliotekach i przed zasobami, które od niej zależą. Zrestartuj staging i sprawdź konsolę serwera oraz konsolę F8 klienta. Rozwiąż problemy z brakującymi plikami, błędnymi manifestami i zduplikowanymi nazwami, zamiast wielokrotnie restartować.
Przetestuj kompletny zasób
- Mapa: umiejscowienie, portale, kolizje, okluzję, oświetlenie, drzwi i konflikty edycji IPL/mapy.
- Pojazd: spawn, tekstury, siedzenia, drzwi, światła, dźwięk, obsługę, uszkodzenia i trwałość garażu.
- Oba: czyste pobieranie, ponowne połączenie, restart serwera, restart zasobu i wyjście logów.
Izoluj konflikty
Wyłącz inne zasoby, które modyfikują ten sam obszar mapy, nazwę modelu lub wpis metadanych, a następnie włączaj je pojedynczo. Zmieniaj tylko jedną zmienną na test. Zmiana nazwy folderu zasobu nie rozwiązuje konfliktów identyfikatorów zasobów wewnątrz niego.
Cofnij
Usuń nowy ensure wpis, przywróć poprzednie pliki/konfigurację i cofnij udokumentowane zmiany w bazie danych. Zrestartuj i powtórz podstawowy przepływ trasy lub pojazdu. Pozostaw zasób wyłączony, dopóki wada nie zostanie odtworzona i naprawiona na staging.