Serwer FiveM nie uruchomi się bez klucza licencyjnego. Pokażemy, jak utworzyć go bezpłatnie w Cfx.re Portal i gdzie dokładnie wpisać go na serwerze.
Czego potrzebujesz
- Konto Cfx.re (to samo, którego używasz na forum forum.cfx.re (otwiera się w nowym oknie)); jeśli go nie masz, utworzysz je przy pierwszym logowaniu do Portalu
- Serwer FiveM w StormHost (lub własny serwer na VPS)
- Około 5 minut
Czym jest klucz licencyjny#
Klucz licencyjny (oficjalnie Server Registration Key, dawniej tworzony na stronie Keymaster) to klucz, którym Twój serwer identyfikuje się wobec Cfx.re, firmy prowadzącej FiveM. Serwer weryfikuje go przy starcie i dopiero wtedy uruchamia się i pojawia na liście serwerów.
- Klucz zaczyna się od
cfxk_i jest tak samo tajny jak hasło. Każdy, kto go ma, może użyć go na własnym serwerze. - Jedno konto Cfx.re może mieć maksymalnie 3 aktywne klucze, czyli 3 serwery jednocześnie.
- Klucz należy do Twojego konta. Płatne skrypty chronione przez Asset Escrow działają tylko na serwerze, którego klucz należy do tego samego konta, z którego kupiono skrypt.
- Tworząc klucz dzisiaj, podajesz tylko nazwę serwera, nie adres IP. Starsze poradniki wspominające o „adresie IP klucza” są już nieaktualne.
Tworzenie klucza w Cfx.re Portal#
Otwórz portal.cfx.re (otwiera się w nowym oknie) i zaloguj się kontem Cfx.re.
Przejdź na stronę Server Registration Keys (otwiera się w nowym oknie) (Servers w menu Portalu).
Kliknij Generate Key +.
W oknie dialogowym wpisz nazwę serwera, na przykład
Muj RP server. Nazwę widzisz tylko Ty na swojej liście kluczy; gracze nigdy jej nie zobaczą.Kliknij Generate.
Nowy klucz pojawi się na liście kluczy.
Skopiuj klucz i zapisz go w menedżerze haseł.
Nigdy nie publikuj klucza
Nie umieszczaj go w publicznym repozytorium GitHub, na Discordzie ani na zrzucie ekranu konsoli. Jeśli klucz wycieknie, wygeneruj nowy (zobacz „Rozwiązywanie problemów”).
Dodawanie klucza do serwera#
Gdzie trafia klucz, zależy od tego, czy zarządzasz serwerem przez txAdmin. Poznasz to po zakładce Konsola: działający txAdmin wypisuje po starcie ramkę z All ready! Please access:.
Z txAdmin
Nowy serwer: klucz wpisujesz w kreatorze konfiguracji txAdmin, w Step 2: Input Parameters, w polu Server Registration Key. txAdmin zapisze go za Ciebie do server.cfg. Cały kreator opisuje artykuł txAdmin: pierwsza konfiguracja.
Serwer już działa i chcesz zmienić klucz:
W txAdmin otwórz CFG Editor w lewym menu.
Znajdź linię
sv_licenseKeyi zastąp stary klucz nowym:server.cfgcfg sv_licenseKey "<LICENSE_KEY>"sv_licenseKey– ustawienie, z którego serwer odczytuje klucz licencyjny."<LICENSE_KEY>"– zamiast<LICENSE_KEY>wstaw pełny klucz z Portalu (zaczyna się odcfxk_), w cudzysłowie i bez nawiasów ostrych.
Kliknij Save File (CTRL+S).
Zrestartuj serwer (przyciskiem restartu po lewej stronie w txAdmin albo przyciskiem Restart w zakładce Konsola strefy klienta).
Bez txAdmin
- W strefie klienta otwórz Moje usługi, kliknij swój serwer i przejdź do zakładki Ustawienia.
- W sekcji Zmienne znajdź zmienną klucza licencyjnego. Poznasz ją po opisie, który odsyła do Cfx.re Portal.
- Wklej klucz i kliknij Zapisz. Ze względów bezpieczeństwa pole klucza jest zamaskowane; kliknij ikonę oka w polu, aby pokazać jego zawartość.
- W zakładce Konsola kliknij Restart.
Jeśli serwer nie ma zmiennej dla klucza, dodaj klucz bezpośrednio do server.cfg (zakładka Pliki) linią sv_licenseKey "<LICENSE_KEY>".
Własny VPS
Na własnym serwerze klucz trafia do server.cfg w folderze danych serwera:
sv_licenseKey "<LICENSE_KEY>"Zamiast <LICENSE_KEY> wstaw klucz z Portalu. Następnie uruchom serwer z parametrem +exec server.cfg, inaczej nie wczyta pliku. Jeśli używasz txAdmin, postępuj według zakładki „Z txAdmin”.
Klucz w zmiennej i w server.cfg
Jeśli klucz jest zarówno w zmiennej, jak i w server.cfg, wygrywa ten ustawiony później. Zwykle jest to server.cfg, bo jest wczytywany po parametrach startowych. Najprościej trzymać klucz tylko w jednym miejscu. Jeśli zostawisz go w obu, musi być taki sam.
Weryfikacja#
- Po restarcie zakładka Konsola nie pokazuje błędu klucza licencyjnego, a serwer wczytuje zasoby.
- W ciągu kilku minut (najpóźniej około 8 minut po starcie) serwer pojawia się na liście serwerów FiveM.
- Serwer możesz też sprawdzić naszym narzędziem CFX Resolver: wpisz adres z zakładki Sieć (IP:port).
Rozwiązywanie problemów#
no license key was specified#
Serwer w ogóle nie dostał klucza. Sprawdź, czy linia sv_licenseKey jest w tym server.cfg, który serwer faktycznie wczytuje (przy txAdmin w folderze wybranym podczas wdrożenia), albo czy zmienna w zakładce Ustawienia jest wypełniona. Na własnym VPS sprawdź, czy uruchamiasz serwer z +exec server.cfg.
Could not authenticate server license key#
Klucz jest nieprawidłowy, dezaktywowany albo skopiowany niekompletnie (brakuje znaku na początku lub końcu, albo jest dodatkowa spacja). Skopiuj go ponownie z Portalu. Na stronie Server Registration Keys (otwiera się w nowym oknie) sprawdź, czy ma status Active. Dezaktywowany klucz możesz ponownie aktywować przyciskiem Re-Activate w szczegółach klucza.
Klucz wyciekł#
Na stronie kluczy kliknij Server ID klucza, potem Regenerate i potwierdź przyciskiem Yes. Stary klucz przestaje działać, więc od razu dodaj nowy do serwera zgodnie z opisem wyżej. Cfx.re może też wysłać Ci e-mail, że znalazło Twój klucz w publicznym repozytorium GitHub. Procedura jest taka sama.
Nie można utworzyć kolejnego klucza#
Masz 3 aktywne klucze. Otwórz klucz serwera, którego już nie prowadzisz, i kliknij Deactivate.
You lack the required entitlement to use …#
Płatny skrypt (Asset Escrow) kupiono na innym koncie Cfx.re niż to, do którego należy klucz licencyjny serwera. Użyj klucza z konta, z którego kupiono skrypt, albo przenieś skrypt na właściwe konto w Portalu. Więcej w artykule Zasoby FiveM.
Podsumowanie
- Klucz licencyjny (Server Registration Key) utworzysz bezpłatnie na portal.cfx.re › Servers › Registration Keys › Generate Key +.
- Jedno konto może mieć maksymalnie 3 aktywne klucze, a klucz nie jest powiązany z adresem IP.
- Z txAdmin wpisz klucz w kreatorze konfiguracji (Server Registration Key) lub w CFG Editor; bez txAdmin w zakładce Ustawienia › Zmienne albo w
server.cfg. - Po zmianie klucza zrestartuj serwer. Klucz, który wyciekł, od razu wygeneruj ponownie przyciskiem Regenerate.