Průvodce TShock: nastavení, příkazy a oprávnění

Verze TShock a Terraria

TShock je vždy sestavený pro jednu konkrétní verzi Terraria. Aktuální vydání, TShock 6.2.1, běží na Terraria 1.4.5.8. Hráči musí mít stejnou verzi Terraria jako server.

Když vyjde aktualizace Terraria, počkejte s aktualizací serveru na odpovídající vydání TShock. Před upgradem TShock zálohujte tshock.sqlite a celou složku tshock: obsahují vaše účty, skupiny, bany a regiony.

Samotné zprovoznění serveru, včetně portů a světů, popisuje návod jak vytvořit Terraria server.

První nastavení: vytvořte účet vlastníka

Při prvním spuštění TShock vypíše do konzole setup kód a uloží ho do tshock/setup-code.txt. Připojte se na server a napište:

/setup 123456
/user add YourName YourPassword owner
/login YourName YourPassword
/setup

První řádek odemkne nastavení pomocí kódu, druhý vytvoří váš účet ve skupině owner, třetí vás přihlásí a poslední vypne režim nastavení. Jakmile nějaký účet existuje, nastavení už znovu použít nejde.

Hrajte ze skupiny owner. TShock má také vestavěného superadmin, ale jeho vývojáři nedoporučují za něj hrát: obchází úplně všechno, včetně postav uložených na serveru.

Skupiny a oprávnění

Každý hráč patří do skupiny a skupiny drží oprávnění. TShock ve výchozím stavu vytvoří tyto: guest (nepřihlášení), default (registrovaní hráči), vip, newadmin, admin, trustedadmin a owner.

Hráči si zakládají vlastní účty příkazem /register password a přihlašují se pomocí /login. Pokud nechcete, aby neregistrovaní hráči stavěli, nastavte v konfiguraci RequireLogin na true.

Příkazy TShock (příkazy pro Terraria server)

Příkazy začínají znakem /; pokud příkaz začnete znakem !, proběhne potichu, aniž by se to ostatním hráčům oznámilo. Jména s mezerami pište do uvozovek.

Chraňte stavby pomocí regionů

Regiony brání ostatním hráčům měnit určitou oblast, například spawn nebo město.

/region set 1
/region set 2
/region define spawn
/region protect spawn true
/region allow Alex spawn
/region allowg builder spawn

Po zadání /region set 1 udeřte do bloku a označíte první roh; totéž udělejte pro roh 2. Pak region pojmenujte a ochraňte. allow dovolí stavět uvnitř jednomu hráči, allowg celé skupině. /region list a /region info spawn ukážou, co existuje.

Pozor: od TShock 6 je automatická ochrana spawnu ve výchozím stavu vypnutá (SpawnProtection v konfiguraci). Region kolem spawnu vám tak jako tak dává jemnější kontrolu.

Postavy uložené na serveru

Normálně je postava každého hráče i s inventářem uložená na jeho vlastním počítači, takže si hráči mohou přinést předměty z jiných světů nebo upravené postavy. Postavy na straně serveru (SSC) místo toho ukládají postavy na serveru, takže všichni postupují férově.

• Zapněte je v tshock/sscconfig.json pomocí "Enabled": true a restartujte server.
• Nastavte, s čím nové postavy začínají: StartingHealth, StartingMana a StartingInventory.
• Admini s oprávněním tshock.ignore.ssc se do SSC neukládají.

Rozhodněte se brzy: jakmile je SSC zapnuté, hráči začínají se startovním inventářem a existující postavu musí admin importovat příkazem /uploadssc. Pozdější zapnutí stálé hráče nepříjemně překvapí.

Konfigurační soubor a REST API

Nastavení TShock je uložené v tshock/config.json. Ta, která mění většina serverů:

• ServerPassword: heslo pro připojení;
• MaxSlots: limit hráčů (výchozí 8);
• RequireLogin: hráči se musí přihlásit, než mohou hrát;
• EnableWhitelist: připojit se mohou jen povolené adresy;
• BackupInterval: jak často TShock ukládá zálohu světa.

Změny použijte příkazem /reload, nebo u nastavení, která to vyžadují, server restartujte.

REST API umožňuje webům a nástrojům ovládat server přes HTTP, ve výchozím stavu na portu 7878. Standardně je vypnuté (RestApiEnabled) a měli byste ho nechat vypnuté, pokud ho nepotřebujete: REST token dokáže spustit jakýkoli serverový příkaz s oprávněními účtu, ke kterému patří. Pokud ho používáte, dejte účtu tokenu jen ta oprávnění, která nástroj potřebuje, a token nikdy nezveřejňujte.

TShock na HytHost

Na Terraria hostingu HytHost máte TShock na jedno kliknutí: zvolte ho při objednávce, nebo na něj přepněte později v záložce Software v panelu, která zachová váš svět, heslo, MOTD i sloty. Server běží na TShock 6.2.1 pro Terraria 1.4.5.8 a REST API je ve výchozím stavu vypnuté.

Setup kód se při prvním spuštění zobrazí v konzoli panelu a soubory config.json a sscconfig.json upravíte ve správci souborů.