Jak zainstalować QBCore na serwerze FiveM przez txAdmin?

QBCore to najpopularniejszy framework roleplay do FiveM, ale ręczna instalacja — dziesiątki resource'ów, baza danych i działający server.cfg — to robota podatna na błędy. Dobra wiadomość: txAdmin ma gotowe recipe, które stawia cały framework w kilka minut. W tym poradniku najpierw utworzysz bazę danych w panelu, następnie wdrożysz recipe QBCore przez kreator konfiguracji txAdmin, a na koniec zalogujesz się do własnego miasta jako admin.

QBCore czy Qbox? Qbox (qbx_core) to nowoczesna kontynuacja QBCore — aktywnie rozwijana, z lepszą wydajnością i mocniejszymi zabezpieczeniami. Lista recipe w txAdmin zawiera oba frameworki, a poniższe kroki są dla obu identyczne; jeśli wybierzesz Qbox, po prostu zaznacz to recipe w kroku 3. Zaczynasz całkiem od zera i nie masz jeszcze żadnych skryptów pod QBCore? W takim razie warto rozważyć Qbox.

Krok 1: utwórz bazę danych w panelu

1. Zaloguj się do panelu MC-Node i otwórz swój serwer FiveM.
2. Przejdź do zakładki Databases i kliknij New Database. Jeśli nie widzisz przycisku albo twój limit jest już wyczerpany, przeczytaj Jak utworzyć bazę danych i nią zarządzać?
3. Nadaj bazie rozpoznawalną nazwę, na przykład qbcore, i potwierdź.
4. Otwórz szczegóły nowej bazy i zapisz sobie cztery dane: endpoint (host wraz z numerem portu na końcu), nazwę bazy danych, nazwę użytkownika i hasło (widoczne po kliknięciu ikony oka).

Uwaga: host to osobny adres bazy danych, a nie localhost. Jeśli później mimo wszystko wpiszesz localhost albo 127.0.0.1, twój serwer nigdy nie połączy się z bazą. Więcej szczegółów znajdziesz w artykule Jak połączyć się z bazą danych?

Krok 2: otwórz txAdmin

1. Sprawdź, czy txAdmin jest włączony na twoim serwerze. Jeśli jeszcze nie, najpierw wykonaj kroki z artykułu Jak włączyć txAdmin?
2. Uruchom serwer z zakładki Console.
3. W wyjściu konsoli pojawi się adres txAdmin razem z czterocyfrowym kodem PIN. PIN jest ważny tylko kilka minut; jeśli wygasł, zrestartuj serwer, aby otrzymać nowy.
4. Otwórz adres (http://ip-serwera:port-txadmin) w przeglądarce, zaloguj się kontem Cfx.re i wpisz PIN. To powiązanie jest potrzebne tylko za pierwszym razem: twoje konto staje się od tej pory kontem master tego txAdmina.

Krok 3: wdróż recipe QBCore przez kreator konfiguracji

1. Ponieważ żaden serwer nie został jeszcze skonfigurowany, txAdmin automatycznie otworzy kreator konfiguracji. Nadaj serwerowi nazwę.
2. Jako typ instalacji wybierz Popular Recipes i zaznacz QBCore Framework (lub Qbox).
3. Wpisz swój license key Cfx.re. Wygenerujesz go za darmo na portal.cfx.re; jak dokładnie to działa, przeczytasz w artykule Kupiłem serwer FiveM — co dalej?
4. W polach bazy danych wpisz dokładnie dane z kroku 1: host (z numerem portu), nazwę użytkownika, hasło i nazwę bazy danych.
5. Uruchom deployment. txAdmin pobierze teraz wszystkie resource'y QBCore, zaimportuje tabele SQL do twojej bazy i wygeneruje plik server.cfg. Zwykle trwa to kilka minut.
6. Po zakończeniu przejrzyj wygenerowany server.cfg (domyślne wartości są na start w porządku) i kliknij Save & Run Server.

Krok 4: pierwszy start, uprawnienia admina i wejście do miasta

1. Obserwuj pierwszy start w konsoli txAdmin i poczekaj, aż wszystkie resource'y się załadują i przestaną pojawiać się czerwone błędy.
2. Otwórz klienta FiveM, wciśnij F8 i wpisz connect ip:port z adresem twojego serwera (znajdziesz go w panelu).
3. Trafisz do menu postaci: stwórz swoją pierwszą postać i wybierz lokalizację startową albo apartament.
4. Nadanie uprawnień admina: otwórz w txAdmin stronę Live Console i wpisz setgroup 1 god, zastępując 1 swoim ID na serwerze (widocznym na stronie Players w txAdmin). Z grupą god otworzysz w mieście menu admina, domyślnie przez /admin.

Częste problemy

• Connection refused lub Access denied (oxmysql) — dane bazy danych się nie zgadzają. Recipe zapisuje je w linii set mysql_connection_string w pliku server.cfg; otwórz ten plik przez zakładkę Files i sprawdź host razem z numerem portu, nazwę użytkownika (łącznie z ewentualnym prefiksem), hasło i nazwę bazy. Nigdy nie używaj localhost. Potem zrestartuj serwer.
• Recipe uruchomione na istniejącej instalacji — deployer oczekuje czystego środowiska. Jeśli przepuścisz kreator po wcześniejszej instalacji, skończysz z konfliktującymi resource'ami i zduplikowanymi tabelami w bazie. Najpierw zrób backup przez zakładkę Backups, potem usuń stare pliki serwera (albo zleć ponowną instalację serwera) i użyj pustej lub nowej bazy danych.
• Brak license key albo key jest już w użyciu — bez ważnego key FiveM nie wystartuje, a jeden key może działać tylko na jednym aktywnym serwerze naraz. Utwórz nowy key w Keymasterze i podmień go w zakładce Startup; szczegóły znajdziesz w artykule Jak zmienić license key FiveM?
• Strona txAdmin się nie ładuje — sprawdź, czy port txAdmin jest ustawiony i czy serwer faktycznie działa; kroki znajdziesz w artykule o txAdmin z kroku 2.

Potrzebujesz pomocy?

Gratulacje, twoje miasto działa! Od tego momentu możesz dodawać resource'y, konfigurować joby i dalej rozbudowywać serwer. Jeśli mimo wszystko gdzieś utkniesz, na przykład na deploymencie, który zatrzymuje się w połowie, otwórz ticket przez naszą stronę pomocy i podaj nazwę serwera oraz błąd z konsoli txAdmin — chętnie na to spojrzymy.