Este guia aborda a configuração de admin, recursos do servidor, mapas personalizados, gerenciamento de veículos e solução de problemas para 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 login ou senha de admin. Em vez disso, os comandos de admin são executados pelo console do servidor ou por plugins Lua do lado do servidor que verificam os identificadores dos jogadores.

Comandos do Console

O console do servidor no GPanel fornece acesso direto aos comandos integrados do servidor. Digite os comandos diretamente no campo de entrada do console:

---

Estrutura da Pasta de Recursos

O BeamMP usa 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

Arquivos colocados em Resources/Client/ são automaticamente baixados pelos jogadores quando eles se conectam. Isso é usado para:

• Mapas personalizados — Arquivos .zip de mods de mapas que os jogadores precisam para carregar o mapa do servidor.
• Veículos personalizados — Arquivos .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 estar presente no cliente.

Recursos do Servidor (Plugins Lua)

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

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

Plugins do lado do servidor podem:

• Responder a eventos de jogadores (entrada, saída, mensagens de chat, spawns de veículos).
• Implementar comandos personalizados via chat (ex.: /tp, /give).
• Gerenciar permissões e limites de veículos.
• Adicionar sistemas de economia, teletransporte ou outros recursos de gameplay personalizados.
• Registrar atividade dos jogadores e aplicar regras.

---

Adicionando Mapas Personalizados

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

1. Baixe o mod do mapa como um arquivo .zip de uma fonte de mods de BeamNG.drive (ex.: o repositório de mods do BeamNG.drive).
2. Pare seu servidor no GPanel.
3. Envie o arquivo .zip para Resources/Client/ pela aba Files ou via SFTP. Não extraia o zip.
4. Atualize a variável de inicialização MAP (ou Map no ServerConfig.toml) para o caminho correto do mapa personalizado. Este caminho geralmente está no formato /levels/map_name/info.json — verifique a documentação do mod para o caminho exato.
5. Inicie o servidor.

---

Gerenciamento de Veículos

O gerenciamento de veículos nos servidores BeamMP é controlado pela configuração MaxCars e opcionalmente por plugins Lua do lado do servidor.

Configuração MaxCars

A configuração MaxCars no ServerConfig.toml (ou a variável de inicialização MAX_CARS) controla quantos veículos cada jogador pode spawnar simultaneamente:

• 1 — Cada jogador pode ter um veículo por vez (recomendado para servidores maiores).
• 2–3 — Permite que os jogadores tenham alguns veículos, útil para servidores menores 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. Baixe o mod do veículo como um arquivo .zip.
2. Coloque-o em Resources/Client/.
3. Reinicie o servidor. Os jogadores baixarão automaticamente o mod do veículo ao conectar.

Restringindo Veículos via Plugins

Para um controle mais detalhado (ex.: banir veículos específicos, limitar tipos de veículos), você precisará de um plugin Lua do lado do servidor. Esses plugins podem interceptar eventos de spawn de veículos e permitir ou negar com base em regras personalizadas. Verifique os fóruns do BeamMP para plugins de gerenciamento de veículos.

---

Instalando e Gerenciando Plugins

Plugins Lua do lado do servidor estendem a funcionalidade do seu servidor. Veja como instalar e gerenciá-los:

Instalando um Plugin

1. Baixe os arquivos do plugin (geralmente uma pasta contendo main.lua e possivelmente outros arquivos).
2. Pare seu servidor.
3. Envie a pasta do plugin para Resources/Server/ pela aba Files ou via SFTP.
4. Certifique-se de que a estrutura de pastas está correta: Resources/Server/PluginName/main.lua.
5. Inicie o servidor. O console mostrará mensagens conforme os plugins são carregados.

Removendo um Plugin

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

---

Solução de Problemas

Erros de Chave de Autenticação

• Verifique se a chave está corretamente colada na variável de inicialização AUTH_KEY — sem espaços extras ou quebras de linha.
• Certifique-se de que a chave não foi revogada ou expirou no BeamMP Keymaster.
• Cada chave só pode ser usada em um servidor por vez. Se você estiver usando a mesma chave em outro lugar, ela falhará.
• O console exibirá erros de autenticação na inicialização se a chave for inválida.

Jogadores Não Conseguem Conectar

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

Problemas de Sincronização de Mods

• Se os jogadores ficarem travados no download ou receberem erros sobre mods ausentes, verifique se os arquivos .zip de mods em Resources/Client/ não estão corrompidos.
• Baixe novamente e reenvie o arquivo do mod se o .zip estiver danificado.
• Arquivos de mod muito grandes podem causar timeout para jogadores com conexões lentas. Considere remover mods grandes desnecessários.
• Certifique-se de que os arquivos .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 com lag constante.
• Troque para um mapa mais simples (Grid Map ou Industrial) para melhor desempenho com grande quantidade de jogadores.
• Remova mods do cliente desnecessários de Resources/Client/ para reduzir tempos de download e uso de memória.
• Verifique os gráficos de uso de recursos do GPanel — se CPU ou RAM estiverem constantemente no limite, considere fazer upgrade do plano do seu servidor. Abra um ticket de suporte para discutir opções.

Servidor Não Aparece no Navegador

• 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á em uso por outro servidor.
• Aguarde 1–2 minutos após a inicialização para o servidor se registrar no backend do BeamMP.
• Verifique o console para quaisquer erros relacionados à conexão com o servidor mestre.

---

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 a Porta do Seu Servidor
• Como Enviar Arquivos via SFTP
• Guia de Inicialização do Servidor — Guia geral para iniciar qualquer servidor de jogos na Legion Hosting

---

Precisa de Mais Ajuda?

Se você está enfrentando problemas não abordados neste guia, nossa equipe 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 do console do GPanel.