Uprawnienia na serwerze Rust: oxide.grant, grupy i prawa

Większość pluginów nic nie robi, dopóki nie nadasz uprawnienia graczowi lub grupie. Ten poradnik wyjaśnia, jak działa system uprawnień w Oxide i Carbonie, jak nadać prawa pojedynczemu graczowi i całej grupie, jak skonfigurować grupy VIP i moderatorów oraz jak naprawić najczęstsze błędy.

Jak działają uprawnienia#

• Uprawnienie to ciąg w formie plugin.akcja, na przykład kits.admin lub nteleportation.home. Plugin rejestruje je przy załadowaniu. Lista uprawnień jest zwykle na stronie pluginu.
• Uprawnienia nadajesz użytkownikowi (konkretnemu graczowi) albo grupie. Gracz ma sumę własnych uprawnień i uprawnień wszystkich swoich grup.
• Grupa może mieć rodzica. Dziedziczy wtedy wszystkie uprawnienia grupy nadrzędnej. Dzięki temu nie musisz nadawać tych samych praw kilka razy.
• Grupy domyślne:
  • default – framework automatycznie dodaje do niej każdego gracza, który się połączy.
  • admin – framework automatycznie dodaje graczy z poziomem właściciela (ownerid).
  • moderator – tylko Carbon, automatycznie dla graczy z poziomem moderatora (moderatorid).
• Uprawnienia tylko się sumują. Nie ma „odmowy”: jeśli grupa ma uprawnienie, ma je każdy członek, nawet jeśli odebrano mu je bezpośrednio.
• Nazwy uprawnień i grup nie rozróżniają wielkości liter.

Uprawnienia pluginów to nie to samo co prawa admina gry. Poziom właściciela lub moderatora (ownerid, moderatorid) daje dostęp do własnych poleceń Rusta (teleport, noclip, ban…). Uprawnienia pluginów sterują tylko funkcjami pluginów. Możesz więc na przykład dać moderatorowi niewidzialność z pluginu Vanish, nie dając mu wszystkich poleceń admina gry.

Oxide przechowuje użytkowników i grupy w plikach oxide/data/oxide.users.data i oxide/data/oxide.groups.data. Archiwizuj je i nigdy ich nie usuwaj (straciłbyś wszystkie nadane prawa).

Gdzie wpisywać polecenia#

• Konsola serwera (na hostingu gier zakładka Konsola) – zalecane miejsce; polecenia zawsze tu działają.
• RCON (RustAdmin, konsola WWW) – to samo co konsola serwera, tylko zdalnie.
• Konsola F1 w grze – jeśli jesteś właścicielem na serwerze (ownerid).

Polecenia wpisuj bez ukośnika. Nazwy ze spacjami umieszczaj w cudzysłowie: "Jan Nowak".

Steam ID zamiast nazwy#

Graczy identyfikuj po Steam ID64 (17-⁠cyfrowy numer zaczynający się od 7656119). Nazwa może się zmienić, a dwóch graczy może mieć podobne nazwy; ID jest unikalne i nigdy się nie zmienia. Oxide i Carbon przyjmują też ID gracza, który jeszcze nie połączył się z serwerem. Jak znaleźć ID, opisuje artykuł Admin i RCON.

Przykłady używają 76561198000000000 – zamień je na prawdziwe ID gracza.

Uprawnienia dla jednego gracza#

Nadawanie praw gracz po graczu nadaje się do wyjątków. Dla kilku osób z tymi samymi prawami używaj grup.

Grupy#

Przykład: grupa vip, która dziedziczy wszystko z default i może dodatkowo używać kitu VIP.

Wypisywanie i kontrola#

oxide.show perms (c.show perms) to najszybszy sposób znalezienia dokładnej nazwy uprawnienia, gdy nie znasz jej z dokumentacji pluginu.

Symbole wieloznaczne#

Gwiazdka * nadaje kilka uprawnień naraz:

oxide.grant group admin nteleportation.*

• nteleportation.* – wszystkie uprawnienia zaczynające się od nteleportation..
• Sama * – każde uprawnienie każdego pluginu.

To samo działa w Carbonie: c.grant group admin nteleportation.*.

Zalecana struktura grup#

Nazwy uprawnień w tabeli odpowiadają pluginom z artykułu Zalecane pluginy. W Oxide grupę moderator tworzysz sam (oxide.group add moderator "Moderator" 2); w Carbonie już istnieje.

Ustawienie łańcucha rodziców w Oxide:

oxide.group parent vip default
oxide.group parent moderator vip
oxide.group parent admin moderator

Moderator ma wtedy prawa gracza i VIP-a, a admin prawa wszystkich.

Przykład: kompletna konfiguracja nowego serwera#

Zestaw poleceń Oxide budujący strukturę z tabeli wyżej dla pluginów NTeleportation, Backpacks, Kits, Vanish, Admin Radar, BetterChat i Remover Tool. Wpisuj je w konsoli serwera po kolei, gdy załadują się wszystkie pluginy (inaczej uprawnienia nie istnieją). W Carbonie zamień oxide. na c., a zamiast tworzenia grupy moderator ustaw tylko jej rodzica.

oxide.grant group default nteleportation.home
oxide.grant group default nteleportation.tpr
oxide.grant group default backpacks.use
oxide.grant group default backpacks.gui
oxide.grant group default removertool.normal

oxide.group add vip "VIP" 1
oxide.group parent vip default
oxide.grant group vip kits.vip
oxide.grant group vip nteleportation.vip
oxide.grant group vip backpacks.size.24

oxide.group add moderator "Moderator" 2
oxide.group parent moderator vip
oxide.grant group moderator vanish.allow
oxide.grant group moderator adminradar.allowed

oxide.group parent admin moderator
oxide.group set admin "Admin" 3
oxide.grant group admin kits.admin
oxide.grant group admin betterchat.admin
oxide.grant group admin removertool.admin
oxide.grant group admin backpacks.admin

• Pierwszy blok daje wszystkim graczom podstawowe funkcje (domy, prośby o teleport, plecak, usuwanie własnych budowli).
• Blok vip tworzy grupę, łączy ją z default i dodaje kit VIP (najpierw musisz utworzyć kit z uprawnieniem kits.vip), limity teleportów VIP i plecak na 24 sloty.
• Blok moderator dodaje niewidzialność i radar.
• Blok admin łączy istniejącą grupę admin z moderatorami, daje jej najwyższą rangę (3; Oxide utworzył ją z rangą 1) i dodaje zarządzanie kitami, czatem, usuwaniem i plecakami. W Carbonie rangę ustawisz przez c.group set admin rank 3.

Następnie dodaj osoby: oxide.usergroup add <ID> vip lub oxide.usergroup add <ID> moderator. Admini (właściciele) trafiają do grupy admin automatycznie.

Grupa admin a ownerid#

• ownerid (poziom 2) to prawa admina gry. Ustawia się go w samym Ruście, zobacz Admin i RCON.

• Grupa admin to grupa uprawnień frameworka. Framework automatycznie dodaje do niej graczy z poziomem 2 przy połączeniu.

• Oxide sam nie usuwa graczy z grupy admin. Jeśli odbierzesz komuś ownerid (removeowner), zostaje w grupie admin i zachowuje prawa pluginów. Usuń go ręcznie:

  oxide.usergroup remove 76561198000000000 admin

• Carbon synchronizuje grupy admin i moderator z faktycznym poziomem gracza przy jego następnym połączeniu.

Grupa admin nie dostaje automatycznie wszystkich uprawnień pluginów. Nadaj jej sam to, co ma mieć.

Odpowiedniki poleceń w Carbonie#

Zamiast <ID> wstaw Steam ID64, zamiast <PERM> nazwę uprawnienia, a zamiast <GRUPA> nazwę grupy, wszystko bez nawiasów ostrych.

Weryfikacja#

1. Wpisz oxide.show user 76561198000000000 (Carbon: c.show user …) i sprawdź, czy gracz jest w oczekiwanych grupach i ma oczekiwane uprawnienia.
2. Poproś gracza, aby wypróbował polecenie pluginu (na przykład /kit). Niektóre pluginy wczytują uprawnienia przy połączeniu gracza – jeśli funkcja nie działa od razu, niech gracz połączy się ponownie.

Rozwiązywanie problemów#

Permission 'kits.vip' doesn't exist#

W Carbonie: Couldn't grant permission - permission does not exist. Nic nie zarejestrowało uprawnienia w tym momencie. Przyczyny:

• Plugin się nie załadował. Sprawdź oxide.plugins (c.plugins).
• Literówka w nazwie. Dokładną nazwę wypisz przez oxide.show perms (c.show perms).
• Przy kitach: kit z tym uprawnieniem nie został jeszcze zapisany.

Player 'Jan' not found#

W Carbonie: Couldn't grant user permission - user not found, use full name or steam ID. Nie można znaleźć gracza o tej nazwie, bo jeszcze się nie połączył albo ma inną nazwę. Użyj Steam ID64 (17 cyfr).

Multiple players were found, please specify: …#

Do wpisanej nazwy pasuje więcej niż jeden gracz. Użyj Steam ID64.

Group 'vip' doesn't exist#

Najpierw utwórz grupę: oxide.group add vip. Przy parent muszą istnieć obie grupy.

You do not have permission to use the command 'oxide.grant'!#

Wpisano polecenie w grze, a nie jesteś właścicielem na serwerze (ownerid). Moderator (moderatorid) nie może używać poleceń uprawnień w grze (chyba że ma uprawnienie o tej samej nazwie, na przykład oxide.grant, którego moderatorom nie zalecamy). Wpisz polecenie w konsoli serwera albo przez RCON. W Carbonie c.grant, c.group i podobne polecenia wymagają poziomu właściciela.

Gracz ma uprawnienie, ale funkcja nie działa#

• Plugin może sprawdzać uprawnienia tylko przy połączeniu – niech gracz rozłączy się i połączy ponownie.
• Plugin ma osobne uprawnienie dla każdej funkcji. W NTeleportation na przykład nteleportation.home daje tylko domy; powrót do poprzedniej lokalizacji (/tpb) wymaga też nteleportation.tpb. Sprawdź dokumentację pluginu.
• Niektóre pluginy sprawdzają poziom admina gry zamiast uprawnień. Wtedy uprawnienie nie wystarcza i gracz potrzebuje ownerid lub moderatorid.

Odebrano uprawnienie, ale gracz nadal je ma#

Ma je przez grupę. Wpisz oxide.show user <ID> i zobacz, w których grupach jest. Odbierz uprawnienie grupie albo usuń gracza z grupy.

Były admin nadal ma prawa pluginów#

Po removeowner został w Oxide w grupie admin. Usuń go: oxide.usergroup remove <ID> admin.

Dalsza lektura#

• Oxide: uprawnienia (oficjalna dokumentacja) (otwiera się w nowym oknie)
• Oxide: polecenia uprawnień (otwiera się w nowym oknie)
• Carbon: lista poleceń (otwiera się w nowym oknie)