Jak zainstalować serwer QBCore: przepis txAdmin i ręczne kroki
Zainstaluj QBCore na FiveM za pomocą przepisu txAdmin lub ręcznie: qb-core, zasoby qb, oxmysql, import SQL, server.cfg, pierwsze sprawdzenia i najczęstsze pierwsze błędy.
Chcesz serwera QBCore i wybierasz między przepisem a instalacją ręczną. Ten przewodnik obejmuje oba, server.cfg, którego potrzebujesz, co sprawdzić przy pierwszym starcie i błędy, które pojawiają się na prawie każdym pierwszym serwerze QBCore.
Opcja 1: przepis txAdmin
Przepis jest rekomendowaną drogą. W konfiguracji txAdmin wybierz szablon QBCore z popularnych przepisów, jak opisano w konfiguracji txAdmin i przepisach. Wprowadzasz swój klucz licencji i szczegóły bazy danych, txAdmin pobiera wszystko, tworzy bazę danych i pisze server.cfg. Przejrzyj ten plik, uruchom serwer i przejdź do pierwszych sprawdzeń poniżej.
Opcja 2: instalacja ręczna
Użyj tego, jeśli masz już serwer i chcesz dodać QBCore. Potrzebujesz FXServer, bazy danych MySQL lub MariaDB i klucza licencji.
1. Uzyskaj zasoby
QBCore to nie pojedynczy zasób. Potrzebujesz:
- qb-core, samego frameworku.
- Zasoby qb wokół niego: ekwipunek, wieloznakowy, selektor spawnu, prace, telefon i tak dalej. Są normalnie zgrupowane w folderze, takim jak
[qb]. - oxmysql dla bazy danych i ox_lib, na którym wiele obecnych zasobów zależy.
- Zasoby autonomiczne, takie jak zasób głosu (przeczytaj pma-voice not working) i wszelkie pakiety map lub pojazdów.
Skopiuj je do folderu resources, na przykład resources/[qb] i resources/[standalone].
2. Utwórz bazę danych i zaimportuj SQL
CREATE DATABASE qbcore CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;Zaimportuj plik SQL, który pojawia się z instalacją QBCore (repozytorium przepisu wysyła jeden z tabelami bazowymi), a następnie SQL każdego zasobu, który ma swój własny plik. Jeśli skrypt później mówi, że tabela brakuje, przeczytaj SQL table doesn't exist.
3. Edytuj server.cfg
set mysql_connection_string "mysql://user:password@localhost/qbcore?charset=utf8mb4"
ensure oxmysql
ensure ox_lib
ensure qb-core
ensure [qb]
ensure [standalone]
add_ace group.admin command allow
add_ace qbcore.god command allow
add_principal group.admin qbcore.god
add_principal identifier.license:YOUR_LICENSE_HERE qbcore.godZastąp YOUR_LICENSE_HERE swoim własnym identyfikatorem licencji FiveM. Znajdujesz go na liście graczy txAdmin lub w konsoli serwera, gdy się łączysz. Linie ACE są omówione w uprawnieniach ACE.
Porada:
ensure [qb]uruchamia każdy zasób wewnątrz tego folderu. Trzymaj sam qb-core poza nim, jak w przykładzie, inaczej jest ensured dwa razy. Przeczytaj kolejność ensure server.cfg.
Pierwsze sprawdzenia
Uruchom serwer i przeczytaj konsolę, zanim dołączysz:
- oxmysql się łączy z bazą danych bez błędu.
- qb-core się uruchamia. Jeśli nie, każdy inny zasób qb zawodzi po nim.
- Brak czerwonych błędów z zasobów w
[qb]. Kilka ostrzeżeń jest normalne; powtarzające się błędy nie. - Możesz dołączyć, uzyskać selektor postaci, utworzyć postać i spawn.
- Wiersz jest tworzony w tabeli
playersdla twojej postaci.
Jeśli nie możesz dołączyć lub zostać na ekranie ładowania, przeczytaj gracze zablokują się na ekranie ładowania.
Częste pierwsze błędy
QBCore jest nil. Skrypt, który używa starej metody na uzyskanie obiektu core, zawala się z:
attempt to index a nil value (global 'QBCore')Użyj local QBCore = exports['qb-core']:GetCoreObject() na górze każdego pliku. Pełne wyjaśnienie jest w QBCore nil: naprawa GetCoreObject.
qb-core się nie uruchomił. Inne zasoby następnie raportują:
No such export GetCoreObject in resource qb-coreSpójrz na górę konsoli dla pierwszego błędu samego qb-core, który zwykle jest bazą danych. Przeczytaj błąd połączenia oxmysql.
Zasób nie uruchamia się. Brakująca zależność lub problemy z nazwą folderu: could not find dependency, couldn't start resource.
Nie jesteś administratorem. Twój identyfikator w server.cfg nie pasuje do twojego, lub nie uruchomiłeś ponownie po edycji.
Następne kroki
Gdy baza jest stabilna, zwyczajnymi pierwszymi zadaniami są dodawanie prac i przedmiotów. Przeczytaj QBCore add job i qb-inventory add items. Jeśli planujesz uruchomić nowszy stos później, najpierw przeczytaj install QBox, ponieważ stos się różni.
Lista kontrolna
| Objaw | Naprawa |
|---|---|
attempt to index a nil value (global 'QBCore') |
local QBCore = exports['qb-core']:GetCoreObject() na górze pliku |
No such export GetCoreObject in resource qb-core |
Napraw błąd uruchomienia qb-core, zwykle połączenie z bazą danych |
| Tabela nie istnieje | Zaimportuj brakujący plik SQL dla tego zasobu |
| Zablokuj się na ładowaniu | Sprawdź konsolę dla zasobu, który błęduje przy dołączaniu |
| Nie jest administratorem | Umieść swoją licencję w add_principal i uruchom ponownie |
| Zasoby uruchamiają się dwa razy | Nie ensure zasobu po nazwie i przez jego folder nawiasów |
Szybkie odpowiedzi
Czy powinienem użyć przepisu txAdmin dla QBCore?
Tak. Przepis pobiera qb-core z jego zasobami i zależnościami, tworzy bazę danych i pisze server.cfg, co unika większości błędów pierwszej instalacji.
Jaka baza danych jest potrzebna QBCore?
MySQL lub MariaDB, dostęp przez oxmysql. Ustaw mysql_connection_string w server.cfg i zaimportuj pliki SQL, które wysyłają framework i jego zasoby.
Jak się stać administratorem na QBCore?
Dodaj swój identyfikator do jednostki głównej, takiej jak qbcore.god, za pomocą add_principal w server.cfg, uruchom ponownie i ponownie dołącz. Użyj swojego identyfikatora licencji, a nie przykładu z przepisu.
Skrypty bez tego problemu
Item Creator V2Twórz używalne przedmioty z animacjami, propami, efektami i nie tylko — bez pisania kodu.Zobacz skrypt →
Shop CreatorZbuduj sklep w niecałą minutę — właściciele, pracownicy, sejfy i napady w zestawie.Zobacz skrypt →
Mic PhoneSkładany telefon, który rozkłada się w tablet i działa też na prawdziwym telefonie gracza.Zobacz skrypt →