Jak nastavit permissions.json: Admin (OP), skupiny a práva

Správa oprávnění je základem pro bezpečný chod serveru. V Hytale se všechna práva ukládají do souboru permissions.json. Jako majitel serveru máte dvě možnosti, jak práva nastavit:

  1. Přes webovou konzoli (Doporučeno): Nejrychlejší způsob, jak nastavit práva sobě i ostatním.
  2. Manuální úpravou souboru: Nutné pro pokročilé nastavení skupin (VIP, Moderátor) a specifických práv.

Metoda 1: Nastavení OP přes Konzoli (nejrychlejší)

Toto je ideální metoda pro prvotní nastavení majitele serveru nebo rychlé přidání dalších adminů. Nemusíte nic restartovat ani editovat soubory.

  1. Přihlaste se do Control Panelu a otevřete svůj Hytale server.
  2. V menu otevřete záložku Konzole (Console).
  3. Do příkazového řádku napište následující příkaz (nahraďte JmenoHrace vaším herním nickem): op add JmenoHrace
  4. Server okamžitě přidělí hráči plná práva a zapíše ho do konfiguračního souboru.
  5. Pro odebrání práv použijte příkaz: op remove JmenoHrace.
💡
Poznámka: V konzoli se příkazy píší bez počátečního lomítka /.

Metoda 2: Manuální úprava permissions.json (Pokročilé)

Pokud potřebujete vytvořit specifické skupiny (např. VIP, Moderátor) nebo z nějakého důvodu nemůžete použít konzoli, budete muset upravit soubor permissions.json ručně. Zde pracujeme s UUID hráče, nikoliv s jeho jménem.

Krok 1: Získání UUID hráče

  • Připojte se na server.
  • Otevřete chat a napište příkaz: /uuid
  • Server vypíše dlouhý kód (např. 5640f5a4-1525-4ad0-b332-f5b6f6cfd4b9). Tento kód si zkopírujte.
Ukázkový výstup příkazu /uuid

Krok 2: Zápis do permissions.json a tvorba skupin

V Control Panelu ve Správci souborů otevřete soubor permissions.json. Vložte do něj následující kód, kde nahradíte VASE-UUID-ZDE svým kódem:

Níže uvádíme kompletní příklad, jak soubor nastavit. V tomto příkladu vytváříme skupinu OP (všechna práva) a skupinu VIP (pouze vybrané příkazy).

{
  "users": {
    "UUID-HLAVNIHO-ADMINA": {
      "groups": [
        "OP"
      ]
    },
    "UUID-VIP-HRACE": {
      "groups": [
        "VIP"
      ]
    }
  },
  "groups": {
    "Default": [],
    "OP": [
      "*"
    ],
    "VIP": [
      "hytale.cosmeticsmodule.command.emote",
      "hytale.teleport.command.tp"
    ]
  }
}
  • Sekce users: Zde přiřazujete konkrétní hráče (podle UUID) do skupin.
  • Sekce groups: Zde definujete, co která skupina smí.
    • Symbol *: Značí všechna práva (admin).
    • Konkrétní příkazy: U skupiny VIP vidíte vypsané pouze specifické funkce (emoty a teleport). Hráč s oprávněním této skupiny nebude moci dělat nic jiného, co vyžaduje oprávnění.
💡
Oprávnění hvězdičky "*" přidává veškerá dostupná oprávnění. Hvezdičku je možné použít i v součástech subkategorií, kdy hytale.builderstools.* povolí veškeré funkce pro stavitele.

Jak zjistit názvy oprávnění?

Seznam dostupných oprávnění (tzv. permission nodes) zjistíte přímo ve hře.

  1. Pokud jste OP, napište do chatu příkaz: /help
  2. Hra vám vypíše seznam dostupných příkazů.
  3. Najděte požadovaný příkaz a jeho permission (např. hytale.commandmacro.command.noon) vložte do souboru permissions.json do sekce vaší skupiny.
⚠️
Formát JSON je citlivý na chyby. Položky v seznamech oddělujte čárkou, ale za poslední položkou v seznamu se čárka psát nesmí. Po ruční úpravě souboru nezapomeňte restartovat server.