Jak zainstalować ESX lub QBCore na serwerze FiveM

ESX i QBCore to dwa frameworki, na których opiera się niemal każdy serwer roleplay w FiveM. Dają ci prace, pieniądze, inventory oraz wspólną warstwę danych, do której podpinają się scripty. Ten poradnik pokazuje, jak zainstalować jeden z nich na serwerze FiveM w DoomHosting, w tym bazę danych MySQL, której oba wymagają, oraz właściwą kolejność ensure w twoim pliku server.cfg.

ESX czy QBCore: który framework wybrać?

Oba są darmowe, open source i oparte na MySQL, więc wybór zależy od ekosystemu, na którym chcesz budować:

• ESX to starszy i szerzej używany framework. Powstało dla niego więcej prac, scriptów i poradników od zewnętrznych twórców, więc to bezpieczniejszy wybór, jeśli planujesz kupować lub pobierać dużo gotowych resource.
• QBCore jest nowszy, bardziej modułowy, a wielu deweloperów uważa jego kod za czystszy do rozbudowy. Jeśli masz w zespole scriptera albo chcesz pisać dużo własnej logiki, QBCore jest do tego popularny.

Nie możesz uruchomić obu naraz. Wybierz jeden, zbuduj wokół niego serwer i trzymaj się go. Cokolwiek wybierzesz, kroki instalacji poniżej mają ten sam kształt: utwórz bazę danych, wgraj framework, podłącz go w server.cfg.

Zanim zaczniesz: license key i baza danych

Dwie rzeczy muszą być na miejscu, zanim framework się załaduje.

Po pierwsze, twój serwer potrzebuje ważnego CFX license key, inaczej FXServer w ogóle nie wystartuje. Panel prosi o niego przy pierwszym naciśnięciu Start. Jeśli jeszcze go nie ustawiłeś, najpierw wykonaj jak uzyskać klucz licencyjny FiveM.

Po drugie, ESX i QBCore przechowują wszystko w bazie danych MySQL. Twój serwer FiveM w DoomHosting zawiera jedną. Otwórz w panelu zakładkę Databases i kliknij New database. Panel tworzy bazę i pokazuje ci host, nazwę bazy, nazwę użytkownika i hasło. Zostaw tę zakładkę otwartą, za chwilę będziesz potrzebować tych czterech wartości.

Na serwerze nie ma phpMyAdmin, więc aby zaimportować SQL frameworka, łączysz się z tym samym hostem z darmowego klienta MySQL na twoim komputerze (HeidiSQL, DBeaver lub MySQL Workbench). Użyj hosta, nazwy użytkownika i hasła z zakładki Databases, a następnie uruchom plik .sql frameworka na swojej bazie danych.

Jak zainstalować ESX na serwerze FiveM?

1. Pobierz najnowsze wydanie ESX (resource es_extended) oraz oxmysql z ich oficjalnych wydań na GitHub.

2. Otwórz zakładkę Files, wejdź do folderu resources i wgraj tam es_extended oraz oxmysql. To tutaj mieszka każdy resource.

   

3. Zaimportuj plik SQL ESX do swojej bazy danych za pomocą klienta MySQL (krok powyżej). Tworzy to tabele users, jobs i inne, których oczekuje ESX.

4. Otwórz server.cfg w edytorze plików i dodaj połączenie z bazą danych oraz linie ensure. Kolejność ma znaczenie: oxmysql i es_extended muszą załadować się przed wszystkim, co od nich zależy.

   set mysql_connection_string "mysql://USER:PASSWORD@HOST/DATABASE?charset=utf8mb4"
   
   ensure oxmysql
   ensure es_extended
   

   

5. Zrestartuj serwer z panelu. Obserwuj zakładkę Console: powinieneś zobaczyć, jak oxmysql się łączy, a es_extended startuje bez czerwonych błędów.

Jak zainstalować QBCore na serwerze FiveM?

Kroki odzwierciedlają ESX:

1. Pobierz framework QBCore (qb-core) oraz oxmysql z oficjalnego GitHub QBCore.

2. Wgraj oba do folderu resources przez zakładkę Files.

3. Zaimportuj zrzut SQL QBCore do swojej bazy danych za pomocą klienta MySQL.

4. W server.cfg ustaw connection string i zadbaj o to, aby oxmysql ładował się przed qb-core:

   set mysql_connection_string "mysql://USER:PASSWORD@HOST/DATABASE?charset=utf8mb4"
   
   ensure oxmysql
   ensure qb-core
   

5. Zrestartuj i sprawdź konsolę pod kątem czystego startu.

W jakiej kolejności resource powinny być w server.cfg?

Najpierw zależności, potem to, co od nich zależy. Resource, który odwołuje się do bazy danych, wymaga już działającego oxmysql; script pracy wymaga już działającego frameworka. Bezpieczny wzorzec:

ensure oxmysql
ensure es_extended     # or qb-core
ensure your-inventory
ensure your-jobs
ensure your-other-scripts

Jeśli wykonasz ensure na resource pracy przed frameworkiem, wystąpi błąd przy starcie, ponieważ eksporty frameworka jeszcze nie istnieją.

Jak zrobić z siebie admina?

W ESX grupy admina przypisuje się w bazie danych lub przez resource uprawnień, a własna dokumentacja frameworka opisuje dokładną tabelę. W QBCore dodajesz swój identyfikator license do qb-core/shared/config.lua lub korzystasz z uprawnień w grze. Najszybszy sposób, aby znaleźć swój identyfikator: dołącz raz do serwera, a następnie sprawdź zakładkę Console, gdzie FXServer wypisuje twój identyfikator license: w trakcie łączenia. Skopiuj tę wartość do konfiguracji admina frameworka i zrestartuj.

Częste błędy

• [oxmysql] failed to connect: mysql_connection_string jest błędny. Skopiuj ponownie host, nazwę bazy, nazwę użytkownika i hasło z zakładki Databases. Nazwa bazy to pełne sNNN_name pokazane tam, a nie tylko krótka nazwa, którą wpisałeś.
• Unable to load resource es_extended / qb-core: nazwa folderu w resources nie pasuje do linii ensure, albo rozpakowałeś go o jeden poziom za głęboko (folder w folderze). Folder resource musi zawierać fxmanifest.lua bezpośrednio.
• Framework startuje, ale nie ma tabel: pominąłeś import SQL albo zaimportowałeś go do innej bazy danych. Uruchom ponownie plik .sql frameworka na dokładnej bazie z zakładki Databases.
• Wszystko się ładuje, ale gracze spawnują bez pieniędzy/pracy: zwykle brakująca zależność (resource inventory lub esx_*) albo błędna kolejność ładowania. Czytaj konsolę od góry do dołu, pierwsza czerwona linia jest prawdziwą przyczyną.

Kolejne kroki

Gdy framework działa, będziesz dodawać na nim samochody, prace i scripty. Zobacz jak dodać samochody i skrypty na serwerze FiveM, aby poznać strukturę resource i streamowane pojazdy. Jeśli wolisz panel webowy z wdrażaniem recipe jednym kliknięciem, skonfiguruj txAdmin na serwerze FiveM, który potrafi wdrożyć za ciebie pełną bazę ESX lub QBCore.

Potrzebujesz najpierw serwera? Zobacz FiveM server hosting lub odkryj pełny game control panel.