Todos os jogadores pertencem a um grupo. O grupo determina quais comandos podem executar. O TShock já inclui estes:

• guest — sem sessão iniciada. É qualquer pessoa que acabou de entrar no mundo.
• default — com sessão iniciada com um utilizador TShock. Jogadores normais depois de /login.
• owner / admin — já existem no server. Mantenha-os. Não elimine o grupo que é dono do server.

Liste os grupos e depois inspecione um deles:

/group info mostra o grupo-pai e todas as permissões desse grupo. Use-o antes de copiar permissões para um novo rank.

Crie um grupo vazio e depois adicione os nomes reais das permissões, um por um. Exemplo: um rank vip que pode teleportar-se e expulsar jogadores.

Remova uma permissão da mesma forma:

Nomes de permissões úteis (a string é o que o TShock verifica, não o comando no chat):

• tshock.tp — teleportar-se
• tshock.tp.others — teleportar outros jogadores
• tshock.warp — usar warps
• tshock.admin.kick — expulsar um jogador
• tshock.admin.ban — banir um jogador
• tshock.admin.mute — silenciar um jogador
• tshock.item — gerar itens

Não adicione * a um rank público. Esse wildcard dá todas as permissões, incluindo gestão de utilizadores. Deixe-o apenas em owner ou SuperAdmin. Opcional: /group add vip default cria o vip com default como grupo-pai, por isso o vip começa com o conjunto de permissões de utilizador autenticado em vez de começar vazio.

Um grupo não faz nada até que um utilizador TShock faça parte dele. Crie primeiro o utilizador (consulte como adicionar admins num server Terraria TShock) e depois mova-o:

Substitua PlayerName pelo nome de utilizador TShock, e não pelo nome da personagem de Terraria, caso sejam diferentes. O jogador tem de fazer /login novamente se já estiver no mundo.

Mantenha SuperAdmin / owner para a pessoa que criou o server. Não mova essa conta para vip. Perderia os comandos que gerem grupos e utilizadores.

A API REST é para ferramentas e scripts (bots de estado, web panels, automação). Não é o endereço que escreve no Terraria para entrar no mundo. O jogo usa o IP e a porta de jogo do panel. A REST usa um host e uma porta diferentes, também mostrados no panel.

• Copie o host e a porta REST a partir do panel. Não os invente.
• Deixe RestApiPort na configuração do TShock como o panel a definiu. Alterar esse valor quebra o mapeamento do panel. A porta pública e a porta da configuração deixam de corresponder.
• O token da API é um utilizador TShock com permissões de grupo suficientes. Crie esse utilizador, coloque-o num grupo que possa executar os comandos de que o seu script precisa e depois solicite um token com esse nome de utilizador e palavra-passe. Um guest ou um grupo vip vazio não será suficiente para chamadas de admin.

Se um script não conseguir ligar-se, verifique primeiro a porta REST no panel. Depois confirme que o utilizador TShock consegue iniciar sessão no server. Não abra manualmente uma segunda porta REST.

Se o Console responder que /group ou /user é desconhecido, o processo ainda não está a executar o TShock, ou os plugins não foram carregados.

1. Confirme que este server usa o software TShock de Terraria, e não vanilla nem tModLoader.
2. Reinicie a partir do panel e espere até o server ficar online.
3. Abra o Console novamente e volte a tentar /group list.

O Terraria vanilla não tem grupos. Os mods do tModLoader não serão carregados neste software. Se precisa de mods, esse é um produto diferente.