txAdmin konfiguracja i przepisy: rozmieść FiveM serwer krok po kroku
Jak skonfigurować txAdmin po raz pierwszy, powiązać konto Cfx.re, wybrać przepis (ESX Legacy, QBCore, QBox lub niestandardowy), wpisać szczegóły bazy danych i co robi deploy.
Pobrałeś artefakty FiveM serwera, uruchomiłeś je i teraz txAdmin prosi o PIN, konto i szablon. Ten przewodnik przeprowadza Cię przez pierwszy start, powiązanie konta Cfx.re, wybór przepisu i co się dzieje podczas rozmieszczenia.
Pierwszy start i PIN
Na Windows uruchom FXServer.exe. Na Linux, uruchom run.sh z artefaktów. Pierwszy start drukuje URL txAdmin i jednorazowy PIN w konsoli. Otwórz URL w przeglądarce i wpisz PIN. Tylko osoba, która może przeczytać konsolę serwera, może to zrobić, co jest istotą.
PIN działa tylko raz. Jeśli go stracisz, zatrzymaj serwer i uruchom go ponownie, aby uzyskać nowy, dopóki nie skończyłeś konfiguracji konta. Jeśli już to zrobiłeś i zapomnisz login, zobacz txAdmin zapomniałem hasła.
Powiąż konto Cfx.re
txAdmin prosi cię o stworzenie konta głównego. Powiązujesz je z kontem Cfx.re, które jest tym samym kontem, które używasz na forum FiveM i w Portalu Cfx.re. Zaloguj się Cfx.re, gdy zostaniesz poproszony, a następnie wybierz hasło zapasowe dla konta, aby wciąż się zalogować, jeśli login Cfx.re jest wyłączony.
Zachowaj to hasło gdzieś bezpiecznie. Później dodasz innych administratorów ze strony administratora txAdmin, każdy z własnymi uprawnieniami.
Nazwa serwera i typ rozmieszczenia
Kreator konfiguracji prosi o nazwę serwera, a następnie o typ rozmieszczenia. Formulacja zmienia się między wersjami txAdmin, ale zobaczysz wybory wzdłuż następujących linii:
- Popularne przepisy: gotowe szablony, w tym ESX Legacy, QBCore i QBox.
- Szablon zdalnego adresu URL: przepis, który wklejasz z linku, na przykład jeden z repozytorium własnego framework'u.
- Lokalny szablon lub niestandardowy przepis: Twój własny plik przepisu.
- Istniejące dane serwera: masz już folder danych serwera z
server.cfgi chcesz, aby txAdmin go uruchomił.
Jeśli to nowy serwer, wybierz popularny przepis. Framework'i aktualizują swoje przepisy, więc otrzymujesz aktualną konfigurację bez łowienia linków do pobierania.
Wybór szablonu
| Chcesz | Wybierz |
|---|---|
| Framework, dla którego większość skryptów jest napisanych | ESX Legacy lub QBCore |
| Nowszy stos zbudowany wokół ox_lib, ox_inventory i ox_target | QBox |
| Tylko grę bazową, aby wszystko zbudować sam | Pusty lub niestandardowy przepis |
Nie jesteś pewny? Przeczytaj zainstaluj ESX Legacy, zainstaluj QBCore serwer i zainstaluj QBox serwer zanim wybierzesz, ponieważ przenoszenie framework'ów później oznacza konwertowanie danych.
Folder i parametry przepisu
Po wyborze przepisu txAdmin pokazuje folder danych serwera. To tam deploy umieszcza server.cfg i folder resources. Trzymaj go poza folderem artefaktów, abyś mógł zaktualizować artefakty bez dotykania danych (zobacz update FiveM server artifacts).
Następnie pojawia się formularz z parametrami przepisu. Typowe pola:
- Klucz licencji Cfx.re: klucz, którego serwer potrzebuje do uruchomienia. Wygeneruj go w Portalu Cfx.re. Jeśli otrzymasz błąd na jego temat, przeczytaj błąd klucza licencji serwera.
- Ustawienia bazy danych: host, użytkownik, hasło i nazwa bazy danych.
- Maksymalna liczba graczy, nazwa serwera i inne opcje, które przepis oferuje.
Ostrzeżenie: klucz licencji jest prywatny. Nie publikuj
server.cfgna zrzutach ekranu lub wiadomościach Discord bez ukrycia.
Poświadczenia bazy danych podczas rozmieszczenia
Framework'i przechowują graczy, pieniądze, pojazdy i więcej w bazie danych MySQL lub MariaDB. Przepis musi zalogować się, aby utworzyć swoje tabele. Masz dwa zwykłe konfiguracje:
- Serwer bazy danych, który już uruchamiasz (lokalny MariaDB, XAMPP, lub jeden od twojego hosta). Wpisz jego host, użytkownika i hasło. Użytkownik musi mieć uprawnienie do tworzenia bazy danych.
- Domyślne wartości formularza txAdmin, które pasują do lokalnej konfiguracji, gdzie baza danych działa na tej samej maszynie.
Deploy buduje ciąg połączenia dla Ciebie, więc nie musisz go pisać ręcznie. W server.cfg znajdziesz go jako:
set mysql_connection_string "mysql://user:password@localhost/dbname?charset=utf8mb4"Jeśli serwer później powie, że nie może się połączyć, naprawka znajduje się w oxmysql connection error.
Co przepis naprawdę robi
Przepis to lista zadań, które txAdmin uruchamia w kolejności. W zwykłym sformułowaniu:
- Pobiera zasoby: framework, jego zasoby, oxmysql i inne zależności, zwykle jako pliki ZIP z GitHub'a.
- Rozpakuj i przenieś je do folderu
resources. - Utwórz bazę danych i zaimportuj plik SQL framework'u, używając wpisanych poświadczeń.
- Wpisz
server.cfg: nazwę serwera, klucz licencji, ciąg połączenia, linieensurei uprawnienia.
Gdy rozmieszczenie się skończy, txAdmin pokazuje wygenerowany server.cfg do przeglądu. To jest właściwy moment, aby przeczytać go linia po linii: zobacz server.cfg wyjaśniony. Możesz go edytować, a następnie zapisać i uruchomić serwer.
Po rozmieszczeniu
Uruchom serwer z pulpitu txAdmin i obserwuj konsolę. Zdrowy start kończy się zasobami wymienionymi jako uruchomione i bez czerwonych błędów. Następnie połącz się z FiveM i sprawdź, czy osiągnąłeś ekran postaci lub spawn.
Jeśli zasób nie powiedzie się, couldn't start resource i czytanie błędu skryptu obejmują co komunikaty znaczą. Aby uzyskać swoje prawa administratora w grze, zobacz uprawnienia ACE.
Wskazówka: weź kopię folderu danych serwera i eksport bazy danych zaraz po czystym rozmieszczeniu. Jeśli coś złamiesz podczas eksperymentów, możesz powrócić do znanego dobrego stanu. Przewodnik kopii zapasowej pokazuje jak.
Lista kontrolna
| Objaw | Rozwiązanie |
|---|---|
| Zagubiony PIN txAdmin | Zatrzymaj i uruchom serwer przed zakończeniem konfiguracji, aby otrzymać nowy |
| Nie mogę zalogować się za pomocą Cfx.re | Użyj hasła zapasowego, które ustawiłeś, lub postępuj zgodnie z przewodnikiem zapomniałem hasła |
| Deploy zawala się w kroku bazy danych | Sprawdź host, użytkownika, hasło i że użytkownik może tworzyć bazy danych |
| Nie jesteś pewny, który szablon wybrać | Wybierz framework, którego obsługują twoje skrypty; ESX Legacy i QBCore są najczęstsze |
| Serwer się uruchamia, ale nie mogę dołączyć | Sprawdź endpoints i port forwarding |
| Chcę przejrzeć co zostało napisane | Przeczytaj server.cfg w folderze danych serwera przed pierwszym startem |
Szybkie odpowiedzi
Co to jest przepis txAdmin?
Przepis to mały plik YAML, który mówi txAdmin co pobrać, gdzie rozpakować, którą bazę danych utworzyć i co napisać do server.cfg. Rozmieszczenie przepisu daje ci pracujący serwer w ciągu kilku minut.
Czy mogę rozmieścić przepis na serwerze, który już ma dane?
Rozmieść do pustego folderu. Przepis pisze server.cfg i tworzy bazę danych, więc uruchomienie go na istniejącym serwerze może przesłonić Twoje pliki i tabele.
Który przepis wybrać: ESX Legacy, QBCore czy QBox?
Wybierz framework, którego skryptem planujesz uruchamiać. Większość skryptów sklepu obsługuje ESX i QBCore, a QBox uruchamia większość skryptów QBCore przez swoją warstwę kompatybilności.
