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

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

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.god

Zastą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:

  1. oxmysql się łączy z bazą danych bez błędu.
  2. qb-core się uruchamia. Jeśli nie, każdy inny zasób qb zawodzi po nim.
  3. Brak czerwonych błędów z zasobów w [qb]. Kilka ostrzeżeń jest normalne; powtarzające się błędy nie.
  4. Możesz dołączyć, uzyskać selektor postaci, utworzyć postać i spawn.
  5. Wiersz jest tworzony w tabeli players dla 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:

text
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ą:

text
No such export GetCoreObject in resource qb-core

Spó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 →

Czytaj dalej