Este guia aborda a configuração de admin, gestão de jogadores, comandos de consola do servidor, gestão de rotação de mapas, troca de modos de jogo, suporte a mods e resolução de problemas para o seu servidor dedicado de Mount & Blade II: Bannerlord. Para a configuração inicial do servidor, configuração de modos de jogo, seleção de mapas, definições de facções e instruções de conexão, consulte Guia de Configuração do Servidor Mount and Blade II Bannerlord.

1. Configuração de Admin

Definir a Palavra-passe de Admin

A palavra-passe de admin é definida através da variável de arranque ADMIN_PASSWORD no GPanel, ou no ficheiro de configuração usando o comando AdminPassword:

AdminPassword YourAdminPassword

Esta palavra-passe é necessária tanto para a interface de administração web como para o acesso de admin no jogo.

Aceder ao Painel de Administração Web

O Bannerlord inclui um painel de administração web integrado alimentado pelo módulo DedicatedCustomServerHelper.

1. Encontre o endereço IP e a porta do seu servidor no separador Network do GPanel.
2. Abra um navegador web e navegue até:

   http://<your-server-ip>:<port>

   O painel web funciona na mesma porta que o servidor de jogo (UDP 7210 por defeito). Verifique o separador Network do GPanel para a porta exata.

3. Introduza a sua palavra-passe de admin quando solicitado.

Acesso de Admin no Jogo

1. Entre no seu servidor como jogador normal.
2. Abra a consola do jogo com Alt + ~ (tecla til).
3. Escreva Help para ver os comandos disponíveis.
4. Poderá precisar de se autenticar com a palavra-passe de admin através do menu de admin no jogo, se solicitado.

2. Comandos de Consola do Servidor

Os seguintes comandos podem ser usados na consola do servidor (consola do GPanel) ou no painel de administração web. Escreva Help ou list na consola para ver todos os comandos disponíveis.

Comandos de Gestão do Servidor

3. Gestão de Jogadores

Expulsar Jogadores

Para remover um jogador do servidor:

• Admin Web: Navegue até à secção Jogadores no painel de administração web, encontre o jogador e clique em Kick.
• Comando de chat: Abra o chat no jogo e escreva:

  !kick <playername>

Jogadores expulsos podem voltar a entrar imediatamente, a menos que também os bana ou defina uma palavra-passe no servidor.

Banir Jogadores

Para impedir permanentemente um jogador de entrar:

• Admin Web: Use a opção de banir na secção Jogadores do painel de administração web.
• Comando de chat: Abra o chat no jogo e escreva:

  !ban <playername>

Os banimentos persistem após reinícios do servidor.

Desbanir Jogadores

Para remover um banimento e permitir que um jogador volte a entrar:

!unban <playername>

Silenciar Jogadores

Para impedir um jogador de usar o chat no jogo:

• Use a opção de silenciar no painel de administração web.
• Jogadores silenciados podem continuar a jogar mas não podem enviar mensagens no chat.

4. Gestão de Rotação de Mapas

Alterar o Mapa Atual

Para alterar o mapa durante o jogo, use o painel de administração web ou modifique o ficheiro de configuração e reinicie o servidor. Os mapas devem corresponder ao modo de jogo atual.

Editar a Rotação de Mapas

A rotação de mapas é definida no ficheiro de configuração do modo de jogo. Para alterá-la:

1. Pare o servidor no GPanel.
2. Abra o ficheiro de configuração (ex.: Modules/Native/siege_config.txt).
3. Modifique as linhas add_map_to_automated_battle_pool para adicionar ou remover mapas.
4. Certifique-se de que enable_automated_battle_switching está presente se quiser rotação automática.
5. Guarde e reinicie o servidor.

Modo de Mapa Único

Para executar um único mapa sem rotação, inclua apenas uma linha add_map_to_automated_battle_pool e omita enable_automated_battle_switching. O mesmo mapa será repetido a cada ronda.

5. Troca de Modo de Jogo

Alterar o modo de jogo requer a atualização tanto da definição GameType como do conjunto de mapas, uma vez que os mapas são específicos de cada modo.

1. Pare o servidor no GPanel.
2. Abra o ficheiro de configuração e altere a linha GameType:

   GameType Siege

3. Substitua as linhas add_map_to_automated_battle_pool por mapas compatíveis com o novo modo. Consulte o Guia de Configuração para listas de mapas.
4. Guarde o ficheiro e inicie o servidor.

6. Suporte a Mods

O Bannerlord suporta módulos personalizados (mods) em servidores dedicados. Os mods podem adicionar novos mapas, modos de jogo, armas, tipos de tropas e mecânicas de jogo.

Instalar Mods

1. Pare o servidor no GPanel.
2. Conecte-se ao seu servidor via SFTP. Consulte Como Enviar Ficheiros via SFTP para instruções.
3. Navegue até ao diretório Modules/.
4. Envie a pasta do mod para Modules/. Cada mod deve estar no seu próprio diretório com um ficheiro SubModule.xml.
5. Atualize o comando de arranque do servidor ou ficheiro batch para incluir o mod na lista de módulos. O parâmetro _MODULES_ na configuração de arranque deve referenciar todos os módulos ativos:

   Native*Multiplayer*DedicatedCustomServerHelper*YourModName

   Os módulos são separados por asteriscos (*). A ordem de carregamento é importante -- coloque os mods dependentes após os seus pré-requisitos.

6. Inicie o servidor.

Mods do Steam Workshop

O Bannerlord suporta o Steam Workshop para distribuição de mods. Para instalar mods do Workshop num servidor dedicado:

1. Subscreva o mod no Steam Workshop a partir de uma instalação normal do Bannerlord.
2. Localize a pasta do mod descarregado no diretório Modules/ da sua instalação local do Bannerlord.
3. Envie a pasta do mod para o diretório Modules/ do seu servidor dedicado via SFTP.
4. Adicione o nome do módulo à lista de módulos de arranque.

Módulo DedicatedCustomServerHelper

Este módulo integrado fornece o painel de administração web. Deve ser sempre incluído na lista de módulos. Se encontrar erros de incompatibilidade de versão após uma atualização do jogo:

1. Pare o servidor.
2. Navegue até Modules/DedicatedCustomServerHelper/.
3. Abra SubModule.xml.
4. Atualize o valor de Version para corresponder à versão atual do jogo.
5. Atualize quaisquer valores de versão de DependedModule em conformidade.
6. Guarde e reinicie o servidor.

7. Resolução de Problemas

O Servidor Crasha no Arranque

• Verifique a saída da consola para mensagens de erro. Causas comuns incluem:
  • Token de autenticação em falta ou expirado -- contacte o suporte se vir erros de token.
  • Configuração inválida de AdminPassword -- certifique-se de que a linha AdminPassword existe e tem um valor.
  • Sintaxe mal formada no ficheiro de configuração -- cada comando deve estar na sua própria linha sem caracteres residuais.
  • Incompatibilidade de versão do módulo após uma atualização do jogo -- atualize os números de versão no SubModule.xml.
• Tente remover todos os mods personalizados e executar apenas com os módulos predefinidos (Native*Multiplayer*DedicatedCustomServerHelper).
• Elimine o ficheiro de configuração e deixe o servidor regenerar os valores predefinidos para descartar problemas de configuração.

Os Jogadores Não Conseguem Conectar-se

• Verifique se o servidor está a funcionar no GPanel.
• Confirme que o jogador está a usar o IP e porta corretos do separador Network do GPanel.
• Verifique se a palavra-passe do jogo está correta (sensível a maiúsculas/minúsculas).
• Certifique-se de que o jogador tem a mesma versão do jogo e os mesmos mods instalados.
• Se estiver a usar mods, verifique se o jogador tem exatamente as mesmas versões dos módulos.
• Verifique a consola para mensagens de "player rejected" que podem indicar o motivo específico.

O Servidor Não Aparece no Navegador

• Confirme que o servidor arrancou completamente e que a consola mostra que está a aceitar conexões.
• Verifique se o ficheiro de configuração inclui start_game ou start_game_and_mission -- sem isto, o servidor não se regista na lista principal de servidores.
• O navegador de servidores pode demorar vários minutos a atualizar. Tente a conexão direta enquanto espera.
• Se o token de autenticação estiver expirado, o servidor pode arrancar mas não aparecer no navegador. Contacte o suporte para renovação do token.

Conflitos de Mods

• Se o servidor crashar após adicionar um mod, remova-o e teste novamente para confirmar que é a causa.
• Verifique se o SubModule.xml do mod lista as dependências corretas e se a ordem de carregamento na sua lista de módulos está correta.
• Verifique se o mod é compatível com a versão atual do Bannerlord. Mods de versões mais antigas podem causar crashes.
• Alguns mods são incompatíveis entre si. Consulte a documentação do mod e os fóruns da comunidade para incompatibilidades conhecidas.
• Limpe a cache de shaders e ficheiros temporários do servidor se tiver problemas gráficos ou erros de carregamento após alterações de mods.

Dessincronização de Jogadores

• A dessincronização ocorre quando o estado do jogo de um jogador diverge do servidor. Os sintomas incluem jogadores a parecerem teletransportar-se, golpes que não registam ou rubber-banding.
• A causa mais comum é alta latência. Encoraje os jogadores afetados a verificar a sua ligação à internet.
• Mods que modificam mecânicas de jogo (velocidade de movimento, física, estatísticas de armas) têm mais probabilidade de causar dessincronização.
• Se a dessincronização for generalizada, tente reduzir MaxNumberOfPlayers ou mudar para um modo de jogo mais leve (Duel ou Skirmish em vez de Siege).
• Reiniciar o servidor pode resolver problemas persistentes de dessincronização.

Problemas com o Token de Autenticação

• O Bannerlord requer um token de autenticação válido para executar um servidor dedicado. Os tokens expiram após aproximadamente 3 meses.
• Se vir erros relacionados com o token na consola, o token provavelmente precisa de ser renovado.
• Abra um ticket de suporte para ter o token de autenticação do seu servidor atualizado.

8. Ficheiros de Log

Os logs do servidor Bannerlord são úteis para diagnosticar crashes, problemas de conexão e atividade dos jogadores.

• Os ficheiros de log estão armazenados no diretório de logs do servidor, tipicamente acessível através do separador Files do GPanel ou via SFTP.
• Verifique os ficheiros de log para mensagens de erro detalhadas quando a saída da consola sozinha não é suficiente.
• Inclua excertos relevantes dos logs ao abrir um ticket de suporte para uma resolução mais rápida.

Artigos Relacionados

• Guia de Configuração do Servidor Mount and Blade II Bannerlord
• Como Encontrar o IP e a Porta do Seu Servidor
• Como Enviar Ficheiros via SFTP
• Guia de Início do Servidor

Precisa de Ajuda?

Se encontrar problemas com o seu servidor Bannerlord que não estão cobertos aqui, abra um ticket de suporte e inclua o IP do seu servidor, o modo de jogo que está a executar, quaisquer mods instalados e mensagens de erro relevantes da consola do GPanel ou dos ficheiros de log.