Jak zostać adminem na swoim serwerze FiveM z uprawnieniami ACE?

Twój serwer FiveM działa i możesz połączyć się przez F8, ale w grze wciąż jesteś zwykłym graczem: bez kicka, bez bana, bez menu admina. W tym poradniku nadasz sobie (i członkom swojej ekipy) admina dwiema uzupełniającymi się drogami: admini txAdmin do zarządzania przez przeglądarkę oraz uprawnienia ACE w server.cfg do praw wewnątrz samego serwera. Potraktuj to jako FiveM-owy odpowiednik naszego poradnika LuckPerms dla Minecrafta.

txAdmin czy ACE: kiedy używać którego?

txAdmin to panel webowy, z którego zarządzasz serwerem: lista graczy, konsola na żywo, bany, zaplanowane restarty. Admin txAdmin loguje się przez przeglądarkę i nie musi nawet być w grze. Uprawnienia ACE decydują o tym, co gracz może robić w serwerze: jakie komendy może wykonywać i które chronione funkcje zasobów (np. menu admina) u niego działają. Pełnoprawny administrator zwykle potrzebuje obu.

Droga 1: dodanie admina w txAdmin

1. Otwórz interfejs txAdmin w przeglądarce i zaloguj się na konto master (utworzone przy pierwszej konfiguracji). Jeśli txAdmin jeszcze nie działa, najpierw przejdź przez nasz poradnik włączania txAdmin.
2. Wejdź w menu w Admins i kliknij New Admin.
3. Wybierz nazwę użytkownika i opcjonalnie wpisz nazwę użytkownika Cfx.re oraz Discord ID nowego admina. Dzięki temu powiązaniu będzie mógł logować się przyciskiem Cfx.re lub Discord zamiast hasłem.
4. Zaznacz tylko te uprawnienia, których dana rola naprawdę potrzebuje. Moderatorowi wystarczy zarządzanie graczami (kick, warn, ban); ustawienia, konsolę na żywo i zarządzanie innymi adminami zostaw sobie.
5. Zapisz i przekaż tymczasowe hasło, które pokaże txAdmin. Przy pierwszym logowaniu nowy admin ustawi własne hasło.

Znajdowanie własnego identifiera (license, steam lub discord)

Uprawnienia ACE przypisujesz do identifiera: unikalnego kodu, po którym FiveM rozpoznaje Twoje konto. Znajdziesz go tak:

1. Połącz się przynajmniej raz z własnym serwerem, aby poznał Twoje identifiery.
2. W txAdmin otwórz stronę Players, kliknij swoją nazwę i sprawdź swoje ID. Zobaczysz tam m.in. license:, discord: oraz (jeśli Steam był uruchomiony podczas łączenia) steam:.
3. Nie korzystasz z txAdmin? Wpisz status w konsoli serwera (zakładka Console w panelu gry); przy każdym połączonym graczu widnieje identifier.

Najlepiej używaj identifiera license: jest zawsze obecny i nigdy się nie zmienia. Wariantu steam zabraknie, jeśli Steam nie był otwarty, a discord pojawia się tylko wtedy, gdy Discord działał podczas łączenia.

Droga 2: konfiguracja uprawnień ACE w server.cfg

1. W panelu gry otwórz zakładkę Files i przejdź do pliku server.cfg, który Twój serwer faktycznie wczytuje. Przy wdrożeniu txAdmin zwykle leży on w podkatalogu txData. Ten plik to dla Ciebie nowość? Przeczytaj najpierw nasze podstawy server.cfg.
2. Wklej poniższy blok na końcu pliku i zamień przykładowe identifiery na własne wartości.
3. Zapisz plik i zrestartuj serwer z zakładki Console (albo przez txAdmin). Linie ACE są wczytywane tylko przy starcie.
4. Sprawdź w grze, czy Twoje uprawnienia admina działają, na przykład w menu admina Twojego frameworka.

# --- Admini (uprawnienia ACE) ---
add_ace group.admin command allow            # admini mogą używać wszystkich komend konsoli
add_ace group.admin command.quit deny        # ale wyłączanie serwera zostaje tylko w panelu

# Moderatorzy dostają tylko to, na co tu wyraźnie pozwolisz
add_ace group.mod command.clientkick allow   # moderatorzy mogą kickować graczy

# Hierarchia: każdy admin automatycznie dziedziczy wszystkie prawa moda
add_principal group.admin group.mod

# Przypisywanie graczy do grup (zwróć uwagę na przedrostek identifier.)
add_principal identifier.license:1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b group.admin  # TwojaNazwa
add_principal identifier.discord:123456789012345678 group.mod                          # NazwaModeratora

Hierarchia działa tak: add_ace nadaje principalowi (np. grupie group.admin) uprawnienie, a add_principal X Y znaczy „X dziedziczy wszystkie prawa Y”. Dzięki add_principal group.admin group.mod admini dziedziczą więc wszystko, co mogą modzi — w drugą stronę nie. Gracza robisz adminem, przypisując jego identifier do group.admin poleceniem add_principal. Oszczędnie dodawaj kolejne linie add_ace … allow: dawaj zasobowi tylko tę ace, którą wymienia jego dokumentacja, i nigdy nie dawaj builtin.everyone (wszystkim graczom) więcej praw, niż to absolutnie konieczne.

Częste problemy

• Uprawnienia znikają po restarcie — add_ace lub add_principal zostały wpisane w konsoli na żywo (obowiązują tylko do restartu) albo w pliku, którego serwer nie wczytuje. Umieść linie w tym server.cfg, którego txAdmin naprawdę używa; jego ścieżkę zobaczysz w ustawieniach txAdmin.
• Źle sformatowany identifier — W add_principal przed wartością musi stać przedrostek identifier., bez spacji: czyli identifier.license:…. License ma 40 znaków szesnastkowych, identifier Discord to numeryczne ID (nie nazwa użytkownika), a identifier steam to wartość szesnastkowa pokazywana przez serwer, nie Twój SteamID64.
• „You do not have permission” mimo group.admin — Frameworki takie jak ESX i QBCore mają dodatkowo własną grupę admina w bazie danych lub w configu. ACE obsługuje komendy serwera; przy funkcjach frameworka sprawdź też uprawnienia samego frameworka.
• Nagle każdy może używać komend admina — Gdzieś siedzi zbyt szeroka reguła, np. command allow na builtin.everyone albo ogólne allow dodane przez instalację zasobu. Przeszukaj pliki cfg pod kątem add_ace i usuń wszystko, na co nie pozwoliłeś świadomie.
• Logowanie do txAdmin przez Cfx.re lub Discord nie działa — Sprawdź, czy nazwa użytkownika Cfx.re zgadza się co do znaku i czy Discord ID to liczba o 17–19 cyfrach. Zawsze możesz zalogować się nazwą użytkownika i hasłem.

Potrzebujesz pomocy?

Z kontem txAdmin i porządną grupą ACE w server.cfg Twoja struktura adminów jest gotowa na lata. Nadal coś nie gra? Otwórz ticket przez naszą stronę pomocy i podaj nazwę serwera oraz dodane linie — nigdy nie udostępniaj swojego license key.