Instalacja skryptów FiveM - krok po kroku

Serwery FiveM działają na \"zasobach\" (resources): skryptach dodających funkcjonalności. Radiowóz policyjny, system bankowy, stacja benzynowa, garaż, sklep z ubraniami - wszystko jest zasobem. Instalacja zawsze przebiega według tego samego schematu, ale są pułapki, które mogą zepsuć Twój serwer, jeśli ich nie znasz.

Gdzie znaleźć skrypty

• Forum Cfx.re: darmowe wydania od społeczności.
• Tebex (dawniej Buycraft): płatne skrypty premium. Popularne sklepy: ESX Scripts, QBCore Framework, Renewed Scripts.
• GitHub: wiele skryptów open-source. Szukaj \"fivem qbcore\" lub \"fivem esx\" plus nazwa funkcji.

Zawsze sprawdzaj, czy skrypt jest kompatybilny z Twoim frameworkiem (ESX, QBCore, Qbox lub standalone).

Instalacja w pięciu krokach

1. Pobieranie: pobierz skrypt jako zip lub sklonuj repozytorium Git.
2. Rozpakowanie: rozpakuj zip i zmień nazwę folderu jeśli to konieczne. Nazwa folderu to nazwa zasobu.
3. Przesyłanie: prześlij folder do resources/ na swoim serwerze. Większość serwerów organizuje skrypty w podfolderach: resources/[esx]/, resources/[qb]/, resources/[standalone]/.
4. Konfiguracja: otwórz plik config.lua lub shared/config.lua w folderze skryptu i dostosuj ustawienia. Język, ceny, lokalizacje, poziomy dostępu - wszystko jest w konfiguracji.
5. Dodanie do server.cfg: dodaj ensure nazwaskryptu do swojego server.cfg. Kolejność jest ważna: zależności muszą być przed skryptami, które ich potrzebują.

Zależności

Większość skryptów ma zależności. Najczęstsze:

• oxmysql lub mysql-async: łącznik z bazą danych. Zobacz podłączanie bazy danych.
• ox_lib: biblioteka narzędziowa używana przez wiele nowoczesnych skryptów. Pobierz z GitHuba.
• ox_inventory lub qb-inventory: system ekwipunku Twojego frameworka.
• ox_target lub qb-target: system interakcji (cele 3D na obiektach).

Zależności są wymienione w pliku fxmanifest.lua skryptu. Jeśli brakuje zależności, zobaczysz komunikat o błędzie w konsoli podczas uruchamiania.

Właściwa kolejność w server.cfg

Kolejność ensure określa, w jakiej kolejności zasoby są ładowane. Często stosowana struktura:

ensure oxmysql
ensure ox_lib
ensure es_extended    # lub qb-core/qbx_core
ensure ox_inventory
ensure ox_target
ensure esx_policejob  # lub Twoje skrypty

Zasada: najpierw bazy danych, potem biblioteki, następnie framework, a na końcu skrypty, które na nich bazują.

Importowanie SQL

Skrypty przechowujące dane (garaże, nieruchomości, zawody) wymagają tabel SQL. Plik SQL znajduje się zazwyczaj w głównym folderze skryptu. Zaimportuj go przez phpMyAdmin (przycisk w panelu gier obok bazy danych). Zrób to raz - tabele pozostają na stałe.

Najczęstsze błędy

• Nazwa folderu zaczyna się od kropki lub zawiera spacje: FiveM nie załaduje zasobu. Używaj tylko liter, cyfr i myślników.
• Zduplikowana nazwa zasobu: dwa foldery o tej samej nazwie. Pierwszy jest ładowany, drugi ignorowany bez komunikatu o błędzie.
• Skrypt dla innego frameworka: skrypt ESX na serwerze QBCore daje niezrozumiałe błędy. Sprawdź kompatybilność przed pobraniem.
• Brak config.lua: niektóre skrypty wymagają zmiany nazwy config.lua.example na config.lua.

Czy mogę przeładować skrypty na żywo bez restartu?

Tak. Wpisz ensure nazwaskryptu w konsoli serwera lub w txAdmin. Zasób zostanie przeładowany. Uwaga: nie wszystkie skrypty obsługują hot-reload. Jeśli skrypt zachowuje się dziwnie po przeładowaniu, zrestartuj cały serwer.

Ile skryptów obsłuży mój serwer?

To zależy od jakości skryptów i ilości pamięci. Serwer z 4 GB RAM bez problemu obsłuży od 50 do 80 lekkich skryptów. Ciężkie skrypty (duże mapy, wiele zasobów do streamowania) potrzebują więcej. Monitoruj FPS serwera w txAdmin: poniżej 30 to sygnał, że musisz optymalizować lub ulepszyć pakiet.

Czy płatne skrypty są lepsze od darmowych?

Niekoniecznie. Istnieją doskonałe darmowe skrypty (ox_inventory, qb-target, okokGarage) i słabe płatne skrypty. Przeczytaj opinie na forum przed zakupem. Najbardziej znani twórcy premium (Renewed, ox-team) zazwyczaj dostarczają wysoką jakość.

Skrypty działają na wszystkich pakietach FiveM HostValues. W razie pytań dotyczących instalacji możesz otworzyć zgłoszenie.