Uprawnienia ACE w FiveM: Wyjaśnienie Identyfikatorów (steam:, license:, xbl:)

System Access Control Entries (ACE) w FiveM służy do zarządzania uprawnieniami administracyjnymi, komendami moderacji i dostępem do zasobów w pliku server.cfg. Użytkownicy są rozpoznawani na podstawie prefiksów kont, takich jak steam:, license:, discord: oraz xbl:.

Zrozumienie działania poszczególnych identyfikatorów zapobiega błędom w konfiguracji i zabezpiecza serwer. Poniżej przedstawiamy zestawienie wszystkich identyfikatorów oraz przykłady ich użycia.

Czym są identyfikatory graczy w systemie ACE FiveM? #

Identyfikator FiveM to ciąg tekstowy łączący konkretne konto lub protokół z aktywnym połączeniem gracza na serwerze FXServer. W momencie logowania klient gracza przesyła wszystkie dostępne identyfikatory.

Serwer sprawdza te informacje z regułami zawartymi w server.cfg. Jeśli identyfikator należy do grupy administratorskiej, serwer udostępnia graczowi odpowiednie komendy.

Jak opisano w naszym przewodniku po Steam Hex dla FiveM, każda platforma posiada własny prefiks oddzielony dwukropkiem.

Przegląd wszystkich identyfikatorów w FiveM #

FXServer obsługuje siedem głównych typów identyfikatorów:

1. `license:` oraz `license2:` (Rockstar Games) #

Identyfikator potwierdza posiadanie legalnej kopii GTA V w Rockstar Games. Ponieważ FiveM nie działa bez oryginalnej gry, każdy gracz posiada ten identyfikator. Zespół Cfx.re zaleca stosowanie license: jako najbezpieczniejszego sposobu nadawania uprawnień administratorskich.

2. `steam:` (Steam Hex) #

Reprezentuje szesnastkową postać 64-bitowego SteamID gracza. Frameworki roleplay (ESX, QBCore) tradycyjnie wykorzystują steam: do zapisu postaci w tabelach MySQL. Do konwersji użyj naszego Konwertera SteamID.

3. `discord:` (ID użytkownika Discord) #

Umożliwia skryptom sprawdzanie obecności gracza na serwerze Discord w celu automatycznego nadawania dostępu lub rang VIP.

Jak konfigurować uprawnienia ACE w `server.cfg` #

Zarządzanie uprawnieniami ACE opiera się na dwóch komendach: add_principal oraz add_ace.

• add_principal przypisuje identyfikator gracza do wybranej grupy (np. group.admin).
• add_ace przydziela lub odbiera uprawnienia do komend dla danej grupy.

Przykładowy fragment do wklejenia w server.cfg:

# ===================================================
# Uprawnienia ACE w FiveM (server.cfg)
# ===================================================

# 1. Przypisanie graczy do grup
# Wariant A: Poprzez licencję Rockstar (Zalecane)
add_principal identifier.license:1234567890abcdef1234567890abcdef12345678 group.admin

# Wariant B: Poprzez Steam Hex ID
add_principal identifier.steam:1100001000056ba group.admin

# Wariant C: Poprzez konto Discord
add_principal identifier.discord:198273645123456789 group.moderator

# 2. Hierarchia grup (Dziedziczenie)
# Grupa admin dziedziczy wszystkie uprawnienia grupy moderator
add_principal group.admin group.moderator

# 3. Przypisanie komend do grup
# Pozwól moderatorom wyrzucać i blokować graczy
add_ace group.moderator command.kick allow
add_ace group.moderator command.ban allow

# Pozwól administratorom na wszystkie komendy
add_ace group.admin command allow

# Zablokuj komendę wyłączania serwera z poziomu czatu
add_ace group.admin command.quit deny

Dlaczego `license:` jest bezpieczniejsze od `steam:` dla rang administracyjnych? #

Twórcy FiveM zalecają przypisywanie rang przez license: z dwóch powodów:

1. Pewność połączenia: Jeśli członek administracji uruchomi FiveM bez włączonego Steama, ranga przypisana do steam: nie zadziała w danej sesji.
2. Trwałość konta: Zmiana profilu Steam jest znacznie prostsza niż zmiana licencji Rockstar Games na komputerze.

W przypadku zapisu danych w bazie MySQL obecność identyfikatora steam: jest nadal wymagana. Więcej dowiesz się z artykułu jak dodać gracza do whitelist FiveM.

Najczęstsze błędy w konfiguracji ACE #

• Brak słowa identifier.: Wpisanie add_principal steam:1100001... group.admin nie zadziała. Należy bezwzględnie dopisać identifier.steam:.
• Zła kolejność dziedziczenia: add_principal group.admin group.moderator sprawia, że administrator zyskuje prawa moderatora. Zapis odwrotny da moderatorom pełne prawa admina.
• Zbędne spacje: Nie wstawiaj spacji wokół dwukropków.
• Wielkie litery: W zapisie hex stosuj wyłącznie małe litery.

Często Zadawane Pytania #

Czym różnią się identyfikatory steam: i license: w FiveM? #

Identyfikator steam: powstaje ze SteamID64 i wymaga włączonego klienta Steam. Identyfikator license: pochodzi z Rockstar Games Social Club i jest wysyłany przy każdym połączeniu.

Jak sprawdzić identyfikatory gracza połączonego z serwerem FiveM? #

Wpisz polecenie status w konsoli serwera lub otwórz listę graczy w txAdmin. FiveM wyświetla wszystkie aktywne identyfikatory: license, steam, discord oraz IP.

Czy gracze mogą podrobić identyfikator steam: w FiveM? #

Nie. FXServer weryfikuje bilet Steam bezpośrednio przez oficjalne Steam Web API firmy Valve podczas autoryzacji gracza.

Który identyfikator najlepiej wybrać do uprawnień administratorskich w FiveM? #

Zespół Cfx.re rekomenduje license: lub license2: do nadawania uprawnień ACE, ponieważ licencja Rockstar jest trwale połączona z instalacją gry.

Potrzebujesz sprawdzić Steam Hex gracza przed wpisaniem do server.cfg? Skorzystaj z naszego Konwertera SteamID i uzyskaj odpowiedni kod w kilka sekund.

Ostatnia aktualizacja: październik 2026