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 por vez. A versão atual, TShock 6.2.1, roda o Terraria 1.4.5.8. Os jogadores precisam usar a mesma versão do Terraria que o servidor.

Quando o Terraria for atualizado, espere a versão correspondente do TShock antes de atualizar o servidor. Antes de atualizar o TShock, faça backup do tshock.sqlite e de toda a pasta tshock: é ali que ficam suas contas, grupos, banimentos e regiões.

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

Primeira configuração: crie a conta de owner

Na primeira inicialização, o TShock exibe um código de setup no console e o salva em tshock/setup-code.txt. Entre no servidor e digite:

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

A primeira linha libera o setup com o código, a segunda cria sua conta no grupo owner, a terceira faz o seu login e a última desativa o modo de setup. Depois que existe uma conta, o setup não pode ser usado de novo.

Jogue pelo grupo owner. O TShock também tem um superadmin embutido, mas os desenvolvedores não recomendam jogar com ele: ele ignora tudo, inclusive os personagens no servidor.

Grupos e permissões

Todo jogador pertence a um grupo, e os grupos guardam as permissões. O TShock cria estes por padrão: guest (sem login), default (jogadores registrados), vip, newadmin, admin, trustedadmin e owner.

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

Comandos do TShock (comandos do servidor de Terraria)

Os comandos começam com /; se você começar um com !, ele roda em silêncio, sem ser anunciado para os 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 área, 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, acerte um bloco para marcar o primeiro canto; faça o mesmo para o canto 2. Em seguida, dê um nome à região e proteja-a. allow deixa um jogador construir dentro dela, allowg um grupo inteiro. /region list e /region info spawn mostram o que já existe.

Observe que, desde o TShock 6, a proteção automática do spawn vem desativada por padrão (SpawnProtection na configuração). De qualquer forma, uma região em volta do spawn dá um controle mais preciso.

Personagens no servidor

Normalmente o personagem de cada jogador, com o inventário, fica salvo no computador do próprio jogador, então dá para trazer itens de outros mundos ou personagens editados. Os personagens no servidor (SSC) salvam os personagens no servidor, para que todos progridam de forma justa.

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

Decida cedo: com o SSC ligado, os jogadores começam com o inventário inicial, e um admin precisa importar um personagem existente com /uploadssc. Ativar depois pega os jogadores frequentes de surpresa.

O arquivo de configuração e a REST API

As configurações do TShock ficam em tshock/config.json. As que a maioria dos servidores altera:

• ServerPassword: uma senha para entrar;
• MaxSlots: o limite de jogadores (8 por padrão);
• RequireLogin: os jogadores precisam fazer login antes de jogar;
• EnableWhitelist: só endereços permitidos podem entrar;
• BackupInterval: com que frequência o TShock salva um backup do mundo.

Aplique as mudanças com /reload, ou reinicie no caso das configurações que exigem isso.

A REST API permite que sites e ferramentas controlem o servidor via HTTP, na porta 7878 por padrão. Ela vem desativada (RestApiEnabled), e é melhor deixar assim, a menos que você precise: um token REST pode executar qualquer comando do servidor com as permissões da conta a que pertence. Se usar, dê à conta do token só as permissões de que a ferramenta precisa e nunca publique o token.

TShock na HytHost

Na hospedagem de Terraria da HytHost, o TShock está a um clique: escolha na contratação ou troque para ele depois na aba Software do painel, que mantém seu mundo, senha, MOTD e slots. O servidor roda o TShock 6.2.1 para o Terraria 1.4.5.8, com a REST API desativada por padrão.

O código de setup aparece no console do painel na primeira inicialização, e você edita config.json e sscconfig.json no gerenciador de arquivos.