Guia do TShock: instalação, comandos e permissões

Versões do TShock e do Terraria

O TShock é feito para uma única versão exata do Terraria de cada vez. A versão atual, TShock 6.2.1, corre o Terraria 1.4.5.8. Os jogadores têm de usar a mesma versão do Terraria que o servidor.

Quando o Terraria for atualizado, espere pela versão correspondente do TShock antes de atualizar o servidor. Antes de atualizar o TShock, faça cópia de segurança de tshock.sqlite e de toda a pasta tshock: guardam as suas contas, grupos, banimentos e regiões.

A configuração do servidor em si, com portas e mundos, é explicada em como criar um servidor de Terraria.

Primeira configuração: crie a conta de owner

No primeiro arranque, o TShock mostra um código de configuração na consola e guarda-o em tshock/setup-code.txt. Entre no servidor e escreva:

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

A primeira linha desbloqueia a configuração com o código, a segunda cria a sua conta no grupo owner, a terceira inicia a sessão e a última desativa o modo de configuração. Depois de existir uma conta, a configuração não pode voltar a ser usada.

Jogue a partir do grupo owner. O TShock também tem um superadmin integrado, mas os seus programadores desaconselham jogar com ele: ignora tudo, incluindo os personagens no servidor.

Grupos e permissões

Cada jogador pertence a um grupo, e os grupos contêm permissões. O TShock cria estes por predefinição: guest (sem sessão iniciada), default (jogadores registados), vip, newadmin, admin, trustedadmin e owner.

Os jogadores criam a própria conta com /register password e iniciam sessão com /login. Para impedir que jogadores não registados construam, defina RequireLogin como true na configuração.

Comandos do TShock (comandos do servidor de Terraria)

Os comandos começam com /; se começar um com !, é executado em silêncio, sem ser anunciado aos outros jogadores. Nomes com espaços vão entre aspas.

Proteja construções com regiões

As regiões impedem que outros jogadores alterem uma zona, como o spawn ou uma vila.

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

Depois de /region set 1, bata num bloco para marcar o primeiro canto; faça o mesmo para o canto 2. Depois dê um nome à região e proteja-a. allow deixa um jogador construir lá dentro, allowg um grupo inteiro. /region list e /region info spawn mostram o que existe.

Tenha em conta que, desde o TShock 6, a proteção automática do spawn vem desativada por predefinição (SpawnProtection na configuração). De qualquer forma, uma região à volta do spawn dá-lhe um controlo mais preciso.

Personagens no servidor

Normalmente, o personagem de cada jogador, com o seu inventário, fica guardado no computador do próprio jogador, por isso os jogadores podem trazer itens de outros mundos ou personagens editados. Os personagens no servidor (SSC) guardam os personagens no servidor, para que todos progridam de forma justa.

• Ative-o em tshock/sscconfig.json com "Enabled": true e reinicie.
• Defina com o que começam os personagens novos: StartingHealth, StartingMana e StartingInventory.
• Os admins com a permissão tshock.ignore.ssc não são guardados no SSC.

Decida cedo: com o SSC ativo, os jogadores começam com o inventário inicial e um admin tem de importar um personagem existente com /uploadssc. Ativá-lo mais tarde apanha os jogadores habituais de surpresa.

O ficheiro de configuração e a REST API

As definições do TShock estão em tshock/config.json. As que a maioria dos servidores altera:

• ServerPassword: uma palavra-passe para entrar;
• MaxSlots: o limite de jogadores (8 por predefinição);
• RequireLogin: os jogadores têm de iniciar sessão antes de poderem jogar;
• EnableWhitelist: só podem entrar os endereços autorizados;
• BackupInterval: com que frequência o TShock guarda uma cópia de segurança do mundo.

Aplique as alterações com /reload, ou reinicie no caso das definições que o exigem.

A REST API permite que sites e ferramentas controlem o servidor por HTTP, na porta 7878 por predefinição. Vem desativada (RestApiEnabled), e deve mantê-la assim a menos que precise dela: um token REST pode executar qualquer comando do servidor com as permissões da conta a que pertence. Se a usar, dê à conta do token apenas as permissões de que a ferramenta precisa e nunca publique o token.

TShock na HytHost

No alojamento de Terraria da HytHost, o TShock está à distância de um clique: escolha-o na encomenda ou mude para ele mais tarde no separador Software do painel, que mantém o seu mundo, palavra-passe, MOTD e slots. O servidor corre o TShock 6.2.1 para o Terraria 1.4.5.8, com a REST API desativada por predefinição.

O código de configuração aparece na consola do painel no primeiro arranque, e edita config.json e sscconfig.json no gestor de ficheiros.