Co właściwie mówi błąd
[ citizen-server-impl] You lack the required entitlement to use <resourceName> [ citizen-server-impl] Couldn't start resource <resourceName>
TL;DR
FiveM odmówił załadowania zasobu, ponieważ **klucz licencji serwera, na którym działa serwer, jest nieuprawniony do tego zasobu w systemie Asset Escrow Cfx.re. W prawie każdym przypadku oznacza to, że zasób został kupiony (lub przeniesiony) na inne konto Cfx.re/Keymaster niż to, które wygenerowało Twój obecny sv_licenseKey.
1. Tło – Asset Escrow i “uprawnienia”
Od końca 2021 roku skrypty FiveM, mapy i MLOs sprzedawane przez Tebex mogą być szyfrowane za pomocą Escrow Asset system.
- Każdy zasób objęty escrow jest powiązany z kontem Keymaster (wkrótce: Portal), które go kupiło.
- Gdy FXServer uruchamia się, moduł
citizen-server-implsprawdza, czy klucz licencji serwera wserver.cfgnależy do konta, które “posiada” zasób. - Jeśli sprawdzenie się nie powiedzie, wyświetlany jest błąd uprawnienia, a zasób jest pomijany. (support.cfx.re)
2. Najczęstsze przyczyny źródłowe
| Przyczyna | Jak potwierdzić | Rozwiązanie |
|---|---|---|
Nieprawidłowy klucz serwera – klucz w server.cfg (lub panelu Twojego hosta) został wygenerowany przez inne konto Cfx.re. | W konsoli serwera uruchom sv_licenseKey; porównaj wartość z kluczem wyświetlanym w Keymaster/Portal po zalogowaniu się na konto kupującego . | Utwórz nowy klucz na właściwym koncie Lub przenieś resource raz na konto, które jest właścicielem klucza. (documentation.jaksam-scripts.com) |
| Kupione na niewłaściwym koncie | Resource rzeczywiście nie pojawia się pod Zakupiono Assets dla konta posiadającego klucz serwera. | Używać “Przenieś asset” w Keymaster (tylko raz) lub dokup ponownie na pasującym koncie. (support.cfx.re) |
| Brak ponownego uruchomienia serwera | Zaktualizowałeś klucz lub przeniosłeś asset, ale nigdy nie zrestartowałeś FXServer. | Pełny restart FXServer (nie tylko refresh) aby pamięć podręczna uprawnień została odbudowana. |
| Nieaktualne artifacty / uszkodzone przesłanie | Failed to verify protected resource również się pojawia, lub klient FTP pominął ukryte .fxap pliki. | Zaktualizuj do najnowszej rekomendowanej wersji artifact i prześlij ponownie zip przez WinSCP/SSH zamiast FileZilla. (docs.nextgenfivem.com) |
| Wynajęte hosty z “ukrytym” polem klucza (Zap-Hosting, GTX i inne) | Nie widzisz sv_licenseKey w server.cfg. | Wprowadź klucz w polu panelu kontrolnego hosta lub wyłącz autogenerowany klucz dostawcy i wklej swój własny. (documentation.jaksam-scripts.com) |
3. Lista kontrolna rozwiązywania problemów krok po kroku
- Wyświetl aktywny klucz
sv_licenseKeySkopiuj wynik. - Zaloguj się do Keymaster/Portalu przy użyciu konta, które zakupiło skrypt.
- Sprawdzać Zakupiono Assets – czy Twój zasób jest wymieniony?
- Sprawdzać Klucze licencji serwera – czy jeden z kluczy pasuje do wartości z kroku 1?
- Dopasuj własność
- Jeśli klucz i zasób znajdują się na inny kontach, albo
- Przenieś zasób (jednorazowo dozwolone) Lub
- Wygeneruj nowy klucz serwera na koncie zakupującym i zastąp stary w
server.cfg.
- Jeśli klucz i zasób znajdują się na inny kontach, albo
- Uruchom ponownie FXServer całkowicie.
- Obserwuj konsolę podczas uruchamiania – błąd uprawnień powinien zniknąć. Jeśli teraz widzisz
Failed to verify protected resource, prześlij ponownie zasób, włączając ukryte.fxappliki. - Aktualizuj pliki wykonywalne – wiele zastrzeżonych skryptów wymaga wersji serwera 5848+ (lub innej określonej przez dostawcę). Zaktualizuj w razie wątpliwości.
4. Przypadki brzegowe i niepewności
- Darmowe zasoby dystrybuowane przez Keymaster mogą być również zastrzeżone; obowiązują te same zasady. Tymczasowa awaria backendu uprawnień Cfx.re może je również zablokować – zwykle naprawiana przez ponowne uruchomienie po kilku minutach. (forum.cfx.re)
- Wiele kluczy na jednej maszynie: Tylko klucz wyświetlany przez
sv_licenseKeyjest używany. Posiadanie starych kluczy w innych miejscach systemu plików nie ma znaczenia. - Migracja Keymaster → Portal (grudzień 2025): Po przejściu będziesz zarządzać kluczami i zasobami w portal.cfx.re, ale logika uprawnień pozostaje identyczna. (support.cfx.re)
- Omijanie escrow narusza Warunki FiveM i może spowodować umieszczenie serwera na czarnej liście. Ten przewodnik celowo pozostaje w ramach obsługiwanego przepływu pracy.
5. Szybka ściągawka referencyjna
Entitlement error? ➜ Check key ↔ account ↔ asset triangle sv_licenseKey Keymaster/Portal (Purchased Assets) server.cfg │ │ │ └──────── must match ─────┴──────── must match ───────────────┘ Fix mismatch → restart FXServer → error gone
Podsumowanie
The „Brakuje Ci wymaganego uprawnienia” wiadomość jest nie błąd skryptu – to mechanizm licencji FiveM informujący cię, że serwer uruchamiający zasób nie jest do tego autoryzowany. Dopasowanie klucza licencji serwera do konta, które faktycznie posiada zasób (lub przeniesienie zasobu na to konto) rozwiązuje błąd w prawie każdym przypadku.
Editorial review and source policy
Entitlement troubleshooting starts with account ownership: verify the Cfx.re account, Portal subscription/server association and license key without exposing credentials. Re-authenticate before rotating keys or reinstalling the server.
