Mods e plugins para servidor Terraria – extensões tShock

Com o tShock, amplias um servidor Terraria com plugins, permissões, regiões, funções de proteção e ferramentas administrativas. O fator decisivo não é a quantidade de extensões, mas sim uma instalação controlada: escolher a versão adequada, colocar a DLL corretamente, definir permissões de forma limpa e verificar após cada reinício se o servidor, o mundo e o acesso dos jogadores funcionam como esperado.

Requisitos para plugins tShock

Para plugins de Terraria, precisas de um servidor que execute tShock. O servidor Vanilla normal não carrega plugins tShock a partir de ServerPlugins/. Se ainda estás a planear o teu servidor, encontras os fundamentos da configuração no guia Alugar um servidor Terraria e configurar o multijogador. Lá o foco é a base, enquanto este guia trata da ampliação através do tShock.

Antes de cada instalação, verifica três pontos: a versão do Terraria, a versão do tShock e a versão do plugin têm de ser compatíveis entre si. Encontras informações oficiais sobre o tShock na documentação em Documentação em github.com. Para downloads de plugins, a visão geral existente tShock Plugins é um bom ponto de partida, desde que também prestes atenção à atualidade, às notas do repositório e às informações de compatibilidade.

Um alojamento Multi-Game pago como game-serverhosting é especialmente útil quando precisas de acesso técnico, processos reproduzíveis, backups e suporte para operação e configuração do servidor. Ainda assim, plugins continuam a ser código de servidor de terceiros: instala apenas extensões cuja origem e finalidade consigas compreender.

Sistema de plugins tShock

tShock é um servidor Terraria alternativo com gestão de permissões, comandos e interface de plugins. Normalmente, os plugins são disponibilizados como .dll e carregados no lado do servidor. Em geral, os jogadores não precisam de instalar estes plugins localmente, desde que o plugin não exija uma modificação de cliente separada.

A pasta central é:

ServerPlugins/

É ali que ficam as DLLs dos plugins. Ao iniciar, o tShock carrega os ficheiros e comunica erros na consola ou no log. Se um plugin não for compatível, faltarem dependências ou uma configuração for inválida, o servidor pode até iniciar, mas o plugin permanece desativado ou gera mensagens de erro.

Instalação

1. Transferir a DLL do plugin a partir de tShock Plugins
2. Colocá-la na pasta ServerPlugins/
3. Reiniciar o servidor
4. Recarregar com /reload (sem reinício)

Usa /reload apenas para alterações que o tShock e o respetivo plugin consigam realmente reler. Para novas DLLs, mudanças de versão ou erros pouco claros, um reinício completo é a verificação mais limpa. Planeia as alterações de preferência fora do período ativo de jogo, para poderes ler os logs e voltar atrás diretamente se houver problemas.

Plugins recomendados

A tabela seguinte apresenta extensões típicas usadas frequentemente para administração, proteção ou gameplay. Ela não garante compatibilidade atual; antes de usar, verifica sempre a página do plugin em questão e a versão do tShock suportada.

Instala primeiro apenas um ou dois plugins e testa-os. Quanto mais extensões estiverem ativas ao mesmo tempo, mais difícil será encontrar erros. Para configurações maiores de mods noutros jogos de sobrevivência, aplicam-se princípios semelhantes: ao instalar mods no V Rising ou ao instalar mods de Palworld no servidor e no cliente, o controlo de versões também é mais importante do que uma quantidade cega de plugins.

Server-Side Characters (SSC)

O SSC guarda os dados das personagens no lado do servidor. Isto pode reduzir cheating, porque os jogadores não podem simplesmente trazer quaisquer progressos locais de personagens. Ao mesmo tempo, o SSC altera claramente o fluxo do jogo: inventário, progresso e equipamento inicial passam a depender do servidor. Por isso, ativa esta função conscientemente e informa a tua comunidade com antecedência.

{
  "ServerSideCharacterConfig": {
    "Enabled": true,
    "ServerSideCharacterSave": 5,
    "StartingInventory": [
      {"netID": 3506, "prefix": 0, "stack": 1}
    ]
  }
}

Antes de alterações no SSC, cria um backup do mundo e dos ficheiros de configuração relevantes. Depois, verifica com um jogador de teste se o login, o inventário, o guardar e a nova ligação funcionam. Se os jogadores de repente sentirem falta de itens, primeiro é preciso esclarecer se o problema está nas personagens locais, nos dados SSC ou nas permissões.

Configurar regiões

As regiões protegem construções, áreas de spawn ou zonas de projeto. O caso típico é um spawn protegido, enquanto jogadores normais podem construir livremente fora dele.

/region define <name>           # Marcar região
/region protect <name> true     # Proteger região
/region allow <spieler> <name>  # Permitir jogador
/region remove <name>           # Remover região
/region list                    # Todas as regiões

Atribui nomes compreensíveis como spawn, arena ou armazem_norte. Documenta regiões importantes, para que outros admins não tenham de adivinhar mais tarde por que uma área está protegida. Depois de criares uma região, deves testar com uma conta de jogador normal se construir, destruir blocos e interagir ficam realmente bloqueados ou permitidos como planeado.

Sistema de grupos

O sistema de grupos controla que comandos jogadores, moderadores e admins podem executar. Trabalha aqui segundo o princípio: conceder apenas as permissões necessárias para a função.

/group add <name> <parent> <permissions> <chatcolor>
/user group <spieler> <gruppe>

Cria primeiro funções simples, por exemplo Jogador, Moderador e Admin. Depois acrescentas permissões individuais. Evita direitos de admin gerais para jogadores normais, mesmo que pareça prático a curto prazo. Especialmente comandos de World Edit, regiões, economia ou dados de personagens podem alterar bastante o estado do servidor.

Verificar o resultado

Depois de cada alteração de plugin, deves realizar pelo menos esta verificação: iniciar o servidor, controlar a consola quanto a erros, ligar com uma conta de teste, executar um comando do plugin, testar permissões com um grupo de jogador normal e, em seguida, fazer um segundo reinício. Só quando o plugin também carregar de forma estável após o reinício é que a instalação está realmente concluída.

Se tiveres várias alterações planeadas, executa-as uma após a outra. Assim, em caso de erro, sabes que ficheiro ou configuração foi alterado por último.

Resolução de problemas

Se um plugin não carregar, verifica primeiro a extensão do ficheiro e o local de armazenamento. A DLL tem de estar na pasta ServerPlugins/ correta, não numa subpasta nem no diretório do mundo. Depois, confirma se a versão do plugin é compatível com a versão do tShock.

Se os comandos não funcionarem, muitas vezes o plugin em si não está avariado; falta a permissão. Verifica o grupo do jogador e os nomes de permissões esperados pelo plugin. Se as regiões não protegerem, testa com um jogador sem direitos de admin; dependendo da configuração, admins contornam regras de proteção com mais frequência do que utilizadores normais.

Se o servidor ficar instável após a instalação de um plugin, remove novamente as DLLs adicionadas por último e reinicia. Trabalha com backups antes de usares SSC, sistemas económicos ou funções de World Edit em produção.

Verificação, limites e caminho seguro de retorno

O guia “Mods e plugins para servidor Terraria – extensões tShock” aplica-se ao tipo de servidor descrito no artigo e ao estado das versões visível no momento da verificação. Nomes de menus, versões disponíveis, compatibilidade de mods ou plugins e recursos necessários podem mudar após atualizações. Por isso, não transfiras valores para outra versão de jogo, loader ou servidor sem os verificar.

Antes de alterações no mundo, no progresso, na configuração ou nas extensões, cria um backup dos ficheiros afetados. Depois, altera apenas um passo relacionado de cada vez e verifica-o com a mesma versão de cliente e servidor com que pretendes jogar mais tarde.

Um teste individual bem-sucedido não é garantia de desempenho nem de disponibilidade. Tamanho do mundo, mods, plugins, número de jogadores, percurso de rede e carga simultânea podem alterar o resultado. Documenta versão, alteração e resultado do teste, para conseguires compreender desvios posteriores.

FAQ

Os jogadores também precisam dos plugins tShock no cliente?

Em regra, não. Os plugins tShock correm no lado do servidor. Os jogadores ligam-se normalmente ao Terraria, desde que o plugin não exija uma mod de cliente separada ou uma configuração especial.

Posso instalar plugins sem reiniciar o servidor?

Algumas alterações podem ser relidas com /reload. Para novas DLLs, atualizações ou procura de erros, um reinício completo é mais fiável, porque assim vês todo o processo de carregamento na consola.

O SSC faz sentido para todos os servidores Terraria?

Nem sempre. O SSC é útil se quiseres controlar progresso e inventários no lado do servidor. Para sessões descontraídas com personagens existentes, pode ser demasiado limitador.

Por que os comandos de plugin funcionam para mim, mas não para os jogadores?

Na maioria das vezes, o motivo são permissões de grupo. Admins costumam ter permissões amplas, jogadores normais não. Por isso, testa sempre novos plugins com uma conta que use o mesmo grupo da tua comunidade.

Quantos plugins devo instalar?

Tão poucos quanto possível e tantos quanto necessário. Começa por proteção, administração e pelas funções de gameplay que realmente usas. Cada extensão adicional aumenta o esforço de manutenção e resolução de erros.