Configurar permissões e grupos do TeamSpeak 3

Se queres configurar permissões do TeamSpeak de forma limpa, não comeces por marcar opções soltas, mas sim por um modelo de funções. Os grupos de servidor controlam permissões globais, os grupos de canal aplicam-se apenas a canais específicos, e permissões diretas de clientes devem continuar a ser exceção. Os valores de Power e Needed-Power também são decisivos, porque definem quem pode executar ações contra quem.

Pré-requisitos

Precisas de direitos de Server Admin no teu servidor TeamSpeak 3 e acesso ao cliente TeamSpeak com a gestão de permissões visível. Depois de uma instalação nova do TS3, segundo a ajuda oficial do TeamSpeak, recebes um token de Server Admin, que podes resgatar no cliente em Permissions → Use Token: Documentação em support.teamspeak.com

Para o trabalho real com permissões, também deves preparar uma lista curta de funções: quem administra o servidor? Quem modera conversas? Quem pode criar canais? Quem só deve ouvir ou falar apenas depois de ser liberado? Se geres várias comunidades de gameservers, vale a pena usar um padrão uniforme. Encontras exemplos adequados no nosso guia sobre alugar e configurar um servidor Minecraft e no guia para alugar e configurar um servidor Rust, porque ali as estruturas de comunidade e a moderação também devem ser esclarecidas cedo.

Entender o sistema de permissões

O TeamSpeak tem um sistema de permissões poderoso com três níveis:

1. Grupos de servidor (globais)
2. Grupos de canal (por canal)
3. Client-Permissions (por utilizador)

Os grupos de servidor são o caso normal. Eles definem o que um utilizador pode fazer em princípio no servidor: falar, escrever, ver canais, mover utilizadores, expulsar, banir ou gerir grupos. Os grupos de canal complementam o modelo quando um utilizador precisa de permissões adicionais apenas num canal específico. Deves usar Client-Permissions diretas com moderação, porque depois são mais difíceis de acompanhar.

A documentação oficial do TeamSpeak também descreve a separação entre Server Groups e Channel Groups, assim como os tipos de permissões Boolean, Integer e Power: Documentação em support.teamspeak.com

Grupos de servidor padrão

Um ponto de partida prático são quatro grupos. Os valores seguintes são um exemplo claro, não uma configuração obrigatória universal:

Para game-serverhosting como alojamento multi-game pago, esta separação é especialmente importante: queres manter o controlo técnico, tornar casos de suporte rastreáveis e manter alterações na operação do servidor transparentes. Por isso, nem todo utilizador regular deve receber direitos administrativos. Melhor é um modelo claro com poucos admins, vários moderadores e um grupo normal de membros.

Criar um novo grupo

1. Clique direito no servidor → Grupos de servidor
2. "Adicionar grupo" → introduzir nome
3. Definir permissões

Na prática, muitas vezes é mais limpo copiar um grupo padrão existente e depois reduzir ou ampliar de forma direcionada. Assim evitas que permissões básicas importantes fiquem em falta. Dá nomes claros aos grupos, por exemplo Server Admin, Moderator, Member, Guest e, opcionalmente, Event Host ou Clan Lead. Evita nomes fantasiosos para funções técnicas se várias pessoas administram o servidor.

Permissões importantes

Deves verificar especialmente as seguintes permissões do modelo inicial:

i_group_needed_modify_power     # Quem pode alterar este grupo
i_group_needed_member_add_power # Quem pode adicionar membros
b_client_kick_from_server       # Expulsar jogadores do servidor
b_client_ban_create             # Criar bans
b_channel_create_temporary      # Criar canais temporários
b_channel_create_permanent      # Criar canais permanentes
i_channel_subscribe_power       # Entrar no canal

O mais importante é a lógica de pares nos valores de Power: uma função precisa de Power própria suficiente para executar uma ação contra um alvo com determinado valor Needed. Se um moderador pode expulsar utilizadores, mas o utilizador-alvo ou o grupo-alvo tem um valor Needed demasiado alto, a ação falha mesmo assim. Isso não é um erro, mas parte do modelo de proteção.

Usar grupos de canal de forma sensata

Grupos de canal aplicam-se apenas a canais específicos:

Usa grupos de canal para responsabilidades delimitadas. Um líder de raid, oficial de clã ou anfitrião de evento não precisa receber automaticamente direitos globais de moderação. Ele pode mover ou mutar utilizadores no seu canal sem poder gerir grupos, bans ou canais permanentes em todo o servidor.

Se separas áreas de voz para jogos diferentes, mantém a estrutura simples: lobby, áreas de jogo, salas privadas de grupo e canal de suporte. Para comunidades maiores com vários servidores de jogo, nomes consistentes ajudam. Como complemento, podes consultar a lógica de organização do guia de FiveM Roleplay ou do guia de servidor Palworld.

Verificar o resultado

Testa cada função na prática depois da configuração. Liga-te com um segundo cliente ou um utilizador de teste e verifica pelo menos estes casos: um Guest consegue entrar no servidor? Ele vê apenas os canais previstos? Um Member consegue falar e escrever? Um Moderator consegue expulsar, mas não alterar admins? Um Channel Admin consegue moderar apenas no próprio canal? Ninguém além dos admins consegue alterar grupos de servidor?

Depois documenta brevemente para que serve cada grupo. Isto não precisa ser um manual de operação longo. Uma tabela no teu sistema interno de notas basta para que o suporte e futuros admins entendam por que as permissões foram definidas assim.

Troubleshooting

O utilizador não consegue entrar num canal

Verifica primeiro i_channel_subscribe_power e os valores Needed correspondentes do canal. Depois controla se um grupo de canal ou uma Client-Permission direta está a sobrepor-se ao grupo de servidor.

O moderador não consegue expulsar ou banir

Confere b_client_kick_from_server e b_client_ban_create. Se as permissões estiverem ativas, o problema muitas vezes está nos valores de Power: a Kick-Power ou Ban-Power do moderador deve corresponder à Needed-Power do utilizador-alvo.

Um utilizador tem permissões demais

Não procures apenas nos grupos de servidor. Verifica também grupos de canal e Client-Permissions diretas. Exceções antigas em utilizadores individuais passam facilmente despercebidas.

Os grupos não podem ser alterados

Verifica i_group_needed_modify_power e i_group_needed_member_add_power. Se estes valores estiverem definidos alto demais, até uma função basicamente autorizada pode não conseguir adicionar membros ou editar grupos.

Dicas

• Least Privilege: Dá apenas as permissões que são realmente necessárias
• Sistema de Power: Power mais alta pode sobrepor valores mais baixos
• Ícones: Carrega ícones para grupos (PNG 64x64)
• Grupos automáticos: Usa bots para atribuição automática de grupos

Verificação, limites e regresso seguro

O guia “Configurar permissões e grupos do TeamSpeak 3” aplica-se ao tipo de servidor descrito no artigo e ao estado da versão 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.

Cria um backup dos ficheiros afetados antes de fazer alterações no mundo, estado do jogo, configuração ou extensões. Depois altera apenas um passo relacionado de cada vez e testa-o com a mesma versão de cliente e servidor com que queres jogar mais tarde.

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

FAQ

Que permissões deve receber um moderador do TeamSpeak?

Um moderador normalmente precisa de permissões para mover, mutar, expulsar e, dependendo da comunidade, também criar bans temporários. Gestão de grupos e definições do servidor devem ficar apenas com admins.

Grupos de canal são melhores do que grupos de servidor?

Não, eles cumprem tarefas diferentes. Grupos de servidor controlam permissões globais. Grupos de canal fazem sentido quando alguém precisa de poderes adicionais apenas num canal específico.

Por que uma permissão definida mesmo assim não funciona?

Na maioria das vezes, um valor Needed-Power bloqueia a ação. Verifica a Power própria da função e o valor Needed do alvo. Depois controla grupos de canal e Client-Permissions diretas.

Devo usar Client-Permissions diretas?

Só em casos excecionais. Permissões individuais por utilizador são mais difíceis de manter do que grupos. Para funções permanentes, grupos de servidor ou grupos de canal quase sempre são mais claros.

Como impeço moderadores de editar outros moderadores?

Define a Needed-Power do grupo Moderator acima da Modify-Power ou Member-Add-Power dos próprios moderadores. Admins mantêm valores correspondentemente mais altos.