server.cfg wyjaśniony: każda linia FiveM server.cfg, jedna po drugiej

Otworzyłeś server.cfg i widzisz mur linii skopiowanych z przepisu. Ten przewodnik przechodzi przez linie, które znajdziesz na większości serwerów, w kolejności, w jakiej zwykle się pojawiają, z krótkim wyjaśnieniem i linkiem do dłuższego przewodnika.

#Endpoints

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

To adres i port, na którym serwer nasłuchuje. 0.0.0.0 oznacza każdy interfejs sieciowy, a 30120 to port domyślny. Gracze łączą się za pośrednictwem UDP i używają TCP do HTTP i serwera proxy txAdmin, więc otwierasz oba na zaporze. W txAdmin interfejs i port są zwykle zarządzane dla Ciebie, a ustawienia txAdmin mogą się skarżyć, jeśli się nie zgadzają. Jeśli gracze nie mogą dołączyć z zewnątrz, zobacz przekierowanie portów.

#Nazwa i oferta

sv_hostname "My Server"
sets sv_projectName "My Server"
sets sv_projectDesc "A friendly roleplay server"
sets tags "roleplay, esx, english"
sets locale "en-US"
load_server_icon myLogo.png

• sv_hostname to starsza nazwa serwera.
• sv_projectName i sv_projectDesc to nazwa i opis na liście serwerów. Forma sets je publikuje.
• tags to słowa kluczowe, które ludzie filtrują, a locale to język.
• load_server_icon ładuje mały PNG z folderu serwera.

Kolory, bannery i rozmiar ikony są opisane w server icon, banner i tags.

#Gracze

sv_maxclients 48

Liczba slotów dla graczy. Przekroczenie 48 wymaga OneSync i tier'u obsługi na stronie Cfx.re. Szczegóły znajdują się w OneSync i limit graczy.

#Klucze

sv_licenseKey "cfxk_xxxxxxxxxxxxxxxxxxxx_xxxxx"
set steam_webApiKey "none"

sv_licenseKey to klucz z Portalu Cfx.re i serwer bez ważnego nie uruchomi się. Zobacz błąd server license key. steam_webApiKey jest potrzebny tylko jeśli chcesz identyfikatorów Steam, a none jest akceptowany, gdy go nie potrzebujesz. Obie linie to tajemnice: nie udostępniaj swojego server.cfg na zrzutach ekranu.

#Baza danych

set mysql_connection_string "mysql://user:password@localhost/dbname?charset=utf8mb4"

Ciąg połączenia, który czyta oxmysql. Nieprawidłowe wartości dają błędy z oxmysql connection error. Użyj set, a nie setr lub sets, aby hasło pozostało na serwerze.

#OneSync i game build

set onesync on
sv_enforceGameBuild 3258

onesync on włącza OneSync, który jest standardem dla nowoczesnych serwerów i wymagany do wielu slotów. sv_enforceGameBuild zmusza klientów do używania build'u gry, a samochody DLC, ubrania i mapy potrzebują niedawnego. Numery build'ów i co odblokowują są w sv_enforceGameBuild i DLC. Użyj numeru build'u obsługiwanego przez Twoje artefakty, a nie tylko tego z przykładu.

#Zasoby: ensure

ensure oxmysql
ensure ox_lib
ensure es_extended
ensure [standalone]

Każdy ensure uruchamia zasób lub cały folder w nawiasach. Kolejność ma znaczenie: bazy danych, biblioteki i framework najpierw. Zobacz server.cfg ensure order. Jeśli jeden nie powiedzie się, couldn't start resource wyjaśnia komunikat.

#Uprawnienia: add_ace i add_principal

add_ace group.admin command allow
add_principal identifier.fivem:1234567 group.admin

add_ace daje uprawnienie do grupy, tutaj każdy polecenia. add_principal umieszcza gracza (poprzez identyfikator) w tej grupie. Zamień identyfikator na swój. Pełne wyjaśnienie, wraz z różnicą między ACE a własnymi grupami Twojego framework'u, jest w ACE permissions.

#Dołączanie innych plików: exec

exec permissions.cfg
exec resources.cfg

exec uruchamia inny plik cfg tak, jakby jego linie były tutaj. Podzielenie uprawnień lub zasobów na ich własne pliki utrzymuje server.cfg czytelnym i możesz zachować tajemnice w jednym pliku, który nigdy nie udostępniasz.

#Przykład minimalny

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

sv_licenseKey "cfxk_..."
sv_hostname "My Server"
sets sv_projectName "My Server"
sets sv_projectDesc "A friendly roleplay server"
sets tags "roleplay"
sets locale "en-US"
load_server_icon myLogo.png
sv_maxclients 48
set onesync on
set mysql_connection_string "mysql://user:password@localhost/dbname?charset=utf8mb4"

ensure oxmysql
ensure ox_lib
ensure es_extended

Ostrzeżenie: błąd w linii nie zawsze zatrzymuje serwer. Błędnie napisana zmienna (convar) jest tworzona w ciszy i nic nie robi. Gdy ustawienie wydaje się ignorowane, najpierw sprawdź pisownię.

#Lista kontrolna