Oprávnění na Rust serveru: oxide.grant, skupiny a práva

Většina pluginů nic neudělá, dokud hráči nebo skupině nepřidělíte oprávnění. Vysvětlíme, jak systém oprávnění v Oxide a Carbonu funguje, jak přidělit práva jednomu hráči i celé skupině, jak postavit skupiny VIP a moderátorů a jak vyřešit nejčastější chyby.

Jak oprávnění fungují#

• Oprávnění je text ve tvaru plugin.akce, například kits.admin nebo nteleportation.home. Zaregistruje ho plugin, když se načte. Seznam oprávnění bývá na stránce pluginu.
• Oprávnění přidělujete uživateli (konkrétnímu hráči) nebo skupině. Hráč má součet svých oprávnění a oprávnění všech svých skupin.
• Skupina může mít rodiče (parent). Pak zdědí všechna oprávnění rodičovské skupiny. Díky tomu nemusíte stejná práva přidělovat několikrát.
• Výchozí skupiny:
  • default – do ní framework automaticky zařadí každého hráče, který se připojí.
  • admin – do ní framework automaticky zařadí hráče s úrovní vlastníka (ownerid).
  • moderator – jen v Carbonu, automaticky pro hráče s úrovní moderátora (moderatorid).
• Oprávnění se jen sčítají. Neexistuje „zákaz“: když má oprávnění skupina, má ho každý její člen, i kdybyste ho odebrali přímo jemu.
• Názvy oprávnění a skupin nerozlišují velká a malá písmena.

Oprávnění pluginů jsou něco jiného než admin práva hry. Úroveň vlastníka nebo moderátora (ownerid, moderatorid) dává přístup k příkazům Rustu (teleport, noclip, ban…). Oprávnění pluginů řídí jen funkce pluginů. Moderátorovi tak můžete dát třeba neviditelnost z pluginu Vanish, aniž by dostal všechny admin příkazy hry.

Oxide ukládá uživatele a skupiny do souborů oxide/data/oxide.users.data a oxide/data/oxide.groups.data. Zálohujte je, nikdy je nemažte (přišli byste o všechna přidělená práva).

Kde příkazy zadávat#

• Konzole serveru (na herním hostingu záložka Konzole) – doporučené místo, příkazy tu fungují vždy.
• RCON (RustAdmin, webová konzole) – totéž co konzole serveru, jen na dálku.
• Konzole F1 ve hře – pokud jste na serveru vlastník (ownerid).

Příkazy pište bez lomítka. Názvy se mezerami dejte do uvozovek: "Jan Novák".

Steam ID místo jména#

Hráče určujte jeho Steam ID64 (17místné číslo začínající 7656119). Jméno se dá změnit a dva hráči mohou mít podobné jméno; ID je jedinečné a neměnné. Oxide i Carbon navíc přijmou ID i u hráče, který se na server ještě nepřipojil. Jak ID zjistit, popisuje Admin a RCON.

V příkladech používáme 76561198000000000 – dosaďte skutečné ID hráče.

Oprávnění pro jednoho hráče#

Přidělování po jednotlivých hráčích je vhodné pro výjimky. Pro víc lidí se stejnými právy použijte skupiny.

Skupiny#

Ukázka: skupina vip, která dědí vše od default a navíc smí používat VIP kit.

Výpis a kontrola#

oxide.show perms (c.show perms) je nejrychlejší způsob, jak zjistit přesný název oprávnění, když ho neznáte z dokumentace pluginu.

Zástupné znaky#

Hvězdička * přidělí víc oprávnění najednou:

oxide.grant group admin nteleportation.*

• nteleportation.* – všechna oprávnění, která začínají nteleportation..
• Samotná * – úplně všechna oprávnění všech pluginů.

V Carbonu stejně: c.grant group admin nteleportation.*.

Doporučená struktura skupin#

Názvy oprávnění v tabulce odpovídají pluginům z článku Doporučené pluginy. V Oxide skupinu moderator vytvoříte sami (oxide.group add moderator "Moderátor" 2), v Carbonu už existuje.

Postup pro řetěz rodičů v Oxide:

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

Moderátor tak má práva hráče i VIP, admin má práva všech.

Ukázka: kompletní nastavení nového serveru#

Sada příkazů pro Oxide, která vytvoří strukturu z tabulky výše pro pluginy NTeleportation, Backpacks, Kits, Vanish, Admin Radar, BetterChat a Remover Tool. Zadávejte je do konzole serveru postupně, až budou všechny pluginy načtené (jinak oprávnění neexistují). V Carbonu nahraďte oxide. za c. a místo vytvoření skupiny moderator jen nastavte jejího rodiče.

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 "Moderátor" 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

• První blok dává základní funkce všem hráčům (domovy, teleport na žádost, batoh, odstraňování vlastních staveb).
• Blok vip vytvoří skupinu, napojí ji na default a přidá VIP kit (kit s oprávněním kits.vip musíte nejdřív vytvořit), VIP limity teleportů a batoh s 24 políčky.
• Blok moderator přidá neviditelnost a radar.
• Blok admin napojí existující skupinu admin na moderátory, dá jí nejvyšší pořadí (3, Oxide ji vytvořil s pořadím 1) a přidá správu kitů, chatu, odstraňování a batohů. V Carbonu se pořadí nastaví příkazem c.group set admin rank 3.

Potom zařazujte lidi: oxide.usergroup add <ID> vip nebo oxide.usergroup add <ID> moderator. Admini (vlastníci) se do skupiny admin dostanou sami.

Skupina admin a ownerid#

• ownerid (úroveň 2) je admin práva hry. Nastavuje se v Rustu, viz Admin a RCON.

• Skupina admin je skupina oprávnění frameworku. Hráče s úrovní 2 do ní framework zařadí automaticky při připojení.

• Oxide hráče ze skupiny admin sám neodebere. Když někomu odeberete ownerid (removeowner), zůstane ve skupině admin a dál má práva pluginů. Odeberte ho ručně:

  oxide.usergroup remove 76561198000000000 admin

• Carbon skupiny admin a moderator při dalším připojení hráče srovná s jeho skutečnou úrovní.

Skupina admin nedostane automaticky všechna oprávnění pluginů. Co v ní má být, přidělte sami.

Ekvivalenty příkazů v Carbonu#

Za <ID> dosaďte Steam ID64, za <PERM> název oprávnění a za <SKUPINA> název skupiny, vše bez špičatých závorek.

Ověření#

1. Zadejte oxide.show user 76561198000000000 (Carbon c.show user …) a zkontrolujte, že hráč je v očekávaných skupinách a má očekávaná oprávnění.
2. Požádejte hráče, ať příkaz pluginu vyzkouší (například /kit). Některé pluginy načítají oprávnění při připojení – pokud funkce nefunguje hned, ať se hráč znovu připojí.

Když něco nefunguje#

Permission 'kits.vip' doesn't exist#

V Carbonu: Couldn't grant permission - permission does not exist. Oprávnění v tu chvíli nikdo nezaregistroval. Příčiny:

• Plugin se nenačetl. Ověřte oxide.plugins (c.plugins).
• Překlep v názvu. Přesný název najdete výpisem oxide.show perms (c.show perms).
• U kitů: kit s tímto oprávněním ještě není uložený.

Player 'Jan' not found#

V Carbonu: Couldn't grant user permission - user not found, use full name or steam ID. Hráče se jménem nelze najít, protože se ještě nepřipojil nebo má jiné jméno. Použijte Steam ID64 (17 číslic).

Multiple players were found, please specify: …#

Zadanému jménu odpovídá víc hráčů. Použijte Steam ID64.

Group 'vip' doesn't exist#

Skupinu nejdřív vytvořte: oxide.group add vip. U parent musí existovat obě skupiny.

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

Příkaz jste zadali ve hře a nejste na serveru vlastník (ownerid). Moderátor (moderatorid) příkazy oprávnění ve hře používat nemůže (pokud nemá stejnojmenné oprávnění, například oxide.grant, které ale moderátorům nedoporučujeme dávat). Zadejte příkaz do konzole serveru nebo přes RCON. V Carbonu vyžadují příkazy c.grant, c.group a další úroveň vlastníka.

Hráč má oprávnění, ale funkce nefunguje#

• Plugin může oprávnění kontrolovat jen při připojení – ať se hráč odpojí a připojí.
• Plugin má pro každou funkci zvláštní oprávnění. Například v NTeleportation dává nteleportation.home jen domovy, návrat na předchozí místo (/tpb) potřebuje navíc nteleportation.tpb. Zkontrolujte dokumentaci pluginu.
• Některé pluginy místo oprávnění kontrolují admin úroveň hry. Pak oprávnění nestačí a hráč musí mít ownerid nebo moderatorid.

Odebral jsem oprávnění, ale hráč ho má dál#

Má ho přes skupinu. Zadejte oxide.show user <ID> a podívejte se, ve kterých skupinách je. Oprávnění odeberte skupině, nebo hráče ze skupiny vyřaďte.

Bývalý admin má pořád práva pluginů#

Po removeowner zůstal v Oxide ve skupině admin. Vyřaďte ho: oxide.usergroup remove <ID> admin.

Další zdroje#

• Oxide: oprávnění (oficiální dokumentace) (otevře se v novém okně)
• Oxide: příkazy pro oprávnění (otevře se v novém okně)
• Carbon: seznam příkazů (otevře se v novém okně)