Este guia abrange a configuração de admin, recursos do lado do servidor, mapas personalizados, gestão de veículos e resolução de problemas para o seu servidor BeamMP na Legion Hosting. Para a configuração inicial do servidor, chaves de autenticação e configuração básica, consulte o Guia de Configuração do Servidor BeamMP.

---

Configuração de Admin

O BeamMP não possui um sistema tradicional de início de sessão ou palavra-passe de admin. Em vez disso, os comandos de admin são executados através da consola do servidor ou via plugins Lua do lado do servidor que verificam os identificadores dos jogadores.

Comandos da Consola

A consola do servidor no GPanel fornece acesso direto aos comandos integrados do servidor. Escreva os comandos diretamente no campo de entrada da consola:

---

Estrutura da Pasta de Recursos

O BeamMP utiliza uma pasta Resources para organizar o conteúdo do lado do servidor. Esta pasta contém dois subdiretórios com finalidades distintas:

Resources/
  Client/       <-- Client-side mods (maps, vehicles) synced to players
  Server/       <-- Server-side Lua plugins (not sent to players)

Recursos do Cliente

Os ficheiros colocados em Resources/Client/ são automaticamente descarregados pelos jogadores quando se conectam. Isto é usado para:

• Mapas personalizados — Ficheiros .zip de mods de mapas que os jogadores precisam para carregar o mapa do servidor.
• Veículos personalizados — Ficheiros .zip de mods de veículos que adicionam novos carros ou modificam os existentes.
• Outros mods do cliente — Qualquer mod de BeamNG.drive que precise de estar presente no cliente.

Recursos do Servidor (Plugins Lua)

O diretório Resources/Server/ contém plugins Lua do lado do servidor. Estes são executados apenas no servidor e não são enviados aos jogadores. Cada plugin reside na sua própria subpasta com um ficheiro main.lua:

Resources/
  Server/
    MyPlugin/
      main.lua        <-- Plugin entry point
    AnotherPlugin/
      main.lua

Os plugins do lado do servidor podem:

• Responder a eventos de jogadores (entrada, saída, mensagens de chat, spawns de veículos).
• Implementar comandos personalizados ativados via chat (ex.: /tp, /give).
• Gerir permissões e limites de veículos.
• Adicionar sistemas de economia, teletransporte ou outras funcionalidades de jogabilidade personalizadas.
• Registar atividade dos jogadores e aplicar regras.

---

Adicionar Mapas Personalizados

Para executar um mapa personalizado (não predefinido) no seu servidor BeamMP:

1. Descarregue o mod do mapa como um ficheiro .zip a partir de uma fonte de mods de BeamNG.drive (ex.: o repositório de mods do BeamNG.drive).
2. Pare o seu servidor no GPanel.
3. Carregue o ficheiro .zip para Resources/Client/ através do separador Files ou via SFTP. Não extraia o zip.
4. Atualize a variável de arranque MAP (ou Map em ServerConfig.toml) para o caminho correto do mapa personalizado. Este caminho está tipicamente no formato /levels/map_name/info.json — verifique a documentação do mod para o caminho exato.
5. Inicie o servidor.

---

Gestão de Veículos

A gestão de veículos nos servidores BeamMP é controlada através da definição MaxCars e opcionalmente através de plugins Lua do lado do servidor.

Definição MaxCars

A definição MaxCars em ServerConfig.toml (ou a variável de arranque MAX_CARS) controla quantos veículos cada jogador pode ter em simultâneo:

• 1 — Cada jogador pode ter um veículo de cada vez (recomendado para servidores maiores).
• 2–3 — Permite que os jogadores tenham alguns veículos, útil para servidores mais pequenos ou encontros de carros.
• Valores mais altos aumentam a carga do servidor proporcionalmente.

Mods de Veículos Personalizados

Para adicionar veículos personalizados ao seu servidor:

1. Descarregue o mod do veículo como um ficheiro .zip.
2. Coloque-o em Resources/Client/.
3. Reinicie o servidor. Os jogadores descarregarão automaticamente o mod do veículo ao conectar-se.

Restringir Veículos via Plugins

Para um controlo mais detalhado (ex.: banir veículos específicos, limitar tipos de veículos), necessitará de um plugin Lua do lado do servidor. Estes plugins podem intercetar eventos de spawn de veículos e permitir ou negar com base em regras personalizadas. Consulte os fóruns do BeamMP para plugins de gestão de veículos.

---

Instalar e Gerir Plugins

Os plugins Lua do lado do servidor estendem a funcionalidade do seu servidor. Eis como instalá-los e geri-los:

Instalar um Plugin

1. Descarregue os ficheiros do plugin (tipicamente uma pasta contendo main.lua e possivelmente outros ficheiros).
2. Pare o seu servidor.
3. Carregue a pasta do plugin para Resources/Server/ através do separador Files ou via SFTP.
4. Certifique-se de que a estrutura de pastas está correta: Resources/Server/PluginName/main.lua.
5. Inicie o servidor. A consola mostrará mensagens à medida que os plugins carregam.

Remover um Plugin

1. Pare o seu servidor.
2. Elimine a pasta do plugin de Resources/Server/.
3. Inicie o servidor.

---

Resolução de Problemas

Erros de Chave de Autenticação

• Verifique se a chave está corretamente colada na variável de arranque AUTH_KEY — sem espaços ou quebras de linha adicionais.
• Certifique-se de que a chave não foi revogada ou expirou no BeamMP Keymaster.
• Cada chave só pode ser usada num servidor de cada vez. Se estiver a usar a mesma chave noutro local, irá falhar.
• A consola apresentará erros de autenticação no arranque se a chave for inválida.

Jogadores Não Conseguem Conectar-se

• Confirme que o servidor arrancou completamente e aparece como online no GPanel.
• Verifique se o jogador está a usar o launcher do BeamMP, e não o launcher padrão do BeamNG.drive.
• Se o servidor estiver definido como Private = true, os jogadores devem usar a conexão direta com o IP e port corretos. Consulte Como Encontrar o IP e Port do Seu Servidor.
• Certifique-se de que a versão do launcher do BeamMP do jogador é compatível com a versão do servidor. Launchers desatualizados podem falhar ao conectar.
• Se o servidor estiver cheio (MaxPlayers atingido), jogadores adicionais não podem entrar até que alguém saia.

Problemas de Sincronização de Mods

• Se os jogadores ficarem presos a descarregar ou receberem erros sobre mods em falta, verifique se os ficheiros .zip dos mods em Resources/Client/ não estão corrompidos.
• Volte a descarregar e carregar o ficheiro do mod se o .zip estiver danificado.
• Ficheiros de mods muito grandes podem causar timeouts para jogadores com ligações lentas. Considere remover mods grandes desnecessários.
• Certifique-se de que os ficheiros .zip dos mods não estão aninhados (ou seja, um .zip dentro de uma pasta dentro de outro .zip).

Problemas de Desempenho com Muitos Jogadores/Veículos

• Reduza MaxCars para 1 por jogador.
• Diminua MaxPlayers se o servidor estiver a experienciar lag constante.
• Mude para um mapa mais simples (Grid Map ou Industrial) para melhor desempenho com muitos jogadores.
• Remova mods de cliente desnecessários de Resources/Client/ para reduzir tempos de download e uso de memória.
• Verifique os gráficos de utilização de recursos do GPanel — se o CPU ou RAM estiver consistentemente no limite, considere atualizar o seu plano de servidor. Abra um ticket de suporte para discutir opções.

Servidor Não Aparece no Browser

• Certifique-se de que Private está definido como false na sua configuração.
• Verifique se a chave de autenticação é válida e não está a ser usada por outro servidor.
• Aguarde 1–2 minutos após o arranque para o servidor se registar no backend do BeamMP.
• Verifique a consola para quaisquer erros relacionados com a ligação ao servidor principal.

---

Artigos Relacionados

• Guia de Configuração do Servidor BeamMP — Configuração inicial, chave de autenticação, configuração e instruções de conexão
• Como Encontrar o IP e Port do Seu Servidor
• Como Carregar Ficheiros via SFTP
• Guia de Arranque do Servidor — Guia geral para iniciar qualquer servidor de jogo na Legion Hosting

---

Precisa de Mais Ajuda?

Se estiver a ter problemas não abordados neste guia, a nossa equipa de suporte está disponível para ajudar. Abra um ticket em legionhosting.net/submitticket.php com os detalhes do seu servidor, uma descrição do problema e quaisquer mensagens de erro relevantes da consola do GPanel.