Este guia aborda tudo o que você precisa para colocar seu servidor BeamMP em funcionamento na Legion Hosting, desde a primeira inicialização e configuração da chave de autenticação até a configuração do ServerConfig.toml e como os jogadores se conectam. Para comandos de admin, mapas personalizados e gerenciamento de recursos, consulte Configuração de Admin e Recursos do BeamMP.
O que é BeamMP?
BeamMP é um mod multiplayer para BeamNG.drive que permite aos jogadores dirigir, correr e colidir juntos nos mesmos mapas. A aplicação BeamMP-Server funciona como um servidor dedicado standalone. Os jogadores se conectam através do launcher do BeamMP, que substitui o launcher padrão do BeamNG.drive para sessões multiplayer.
Primeira Inicialização
Quando você receber seu servidor BeamMP pela primeira vez, siga estes passos para colocá-lo online:
- Faça login no GPanel e selecione seu servidor BeamMP.
- Antes de iniciar, você deve obter uma chave de autenticação (veja abaixo). Sem ela, o servidor não conseguirá autenticar com os serviços do BeamMP.
- Navegue até a aba Startup e cole sua chave de autenticação na variável
AUTHKEY. - Opcionalmente, ajuste outras variáveis de inicialização como nome do servidor e máximo de jogadores.
- Vá para a aba Console e clique em Start.
- O servidor baixará os arquivos do BeamMP-Server automaticamente na primeira inicialização. Isso pode levar alguns minutos.
- Quando o console exibir
[INFO] Server started!ou similar, seu servidor está online e aparecerá no navegador de servidores do BeamMP.
Chave de Autenticação (BeamMP Keymaster)
Todo servidor BeamMP requer uma chave de autenticação que o vincula aos serviços do backend do BeamMP. Esta chave é gratuita e vinculada à sua conta BeamMP/Discord.
Como Obter Sua Chave
- Acesse beammp.com/k/keys (o BeamMP Keymaster).
- Faça login com sua conta Discord. Se você não tiver uma conta BeamMP, será solicitado a criar uma.
- Clique em Create a key (ou + / New Key dependendo da interface atual).
- Insira um nome para seu servidor (isso é apenas um rótulo para sua referência) e o endereço IP do seu servidor.
- Copie a chave gerada.
Adicionando a Chave ao Seu Servidor
- No GPanel, vá para a aba Startup.
- Cole sua chave na variável
AUTHKEY. - Reinicie o servidor para que a alteração entre em vigor.
Variáveis de Inicialização do GPanel
O BeamMP expõe diversas opções de configuração como variáveis de inicialização no GPanel. Navegue até a aba Startup para visualizar e modificá-las. As alterações requerem uma reinicialização do servidor para entrar em vigor.
| Variável | Padrão | Descrição |
|---|---|---|
AUTHKEY |
vazio | Sua chave de autenticação BeamMP do Keymaster. Obrigatória para o servidor funcionar. |
NAME |
BeamMP Server |
O nome exibido no navegador de servidores do BeamMP. |
MAX_PLAYERS |
10 |
Número máximo de jogadores simultâneos. Valores mais altos requerem mais CPU e RAM. |
MAP |
/levels/gridmap_v2/info.json |
O mapa a ser carregado. Usa o formato de caminho de mapa do BeamNG.drive. Consulte a seção Seleção de Mapas para os mapas disponíveis. |
PORT |
30814 |
A porta do servidor. Pré-configurada pelo GPanel — não altere a menos que instruído pelo suporte. |
MAX_CARS |
1 |
Máximo de veículos por jogador. Mais veículos por jogador aumentam significativamente o uso de largura de banda e CPU. |
PRIVATE |
false |
Se true, o servidor não aparecerá no navegador público de servidores. Os jogadores devem conectar via conexão direta. |
ServerConfig.toml
Além das variáveis de inicialização, a configuração completa do servidor está no arquivo ServerConfig.toml no diretório raiz do servidor. Você pode editar este arquivo pela aba Files no GPanel ou via SFTP. As variáveis de inicialização do GPanel sobrescrevem os valores neste arquivo a cada início.
Principais Opções de Configuração
[General]
AuthKey = "your-key-here"
Name = "My BeamMP Server"
Description = "A fun racing and freeroam server"
MaxPlayers = 10
Port = 30814
Map = "/levels/gridmap_v2/info.json"
Private = false
MaxCars = 1
ResourceFolder = "Resources"
LogChat = true
| Configuração | Descrição |
|---|---|
AuthKey |
Sua chave de autenticação do BeamMP Keymaster. |
Name |
Nome do servidor mostrado no navegador de servidores. Suporta alguns códigos de formatação. |
Description |
Uma breve descrição exibida abaixo do nome do servidor no navegador. |
MaxPlayers |
Limite de jogadores. Valores típicos: 8–20 para gameplay suave. |
Map |
O caminho do mapa a ser carregado. Deve ser um caminho válido de nível do BeamNG.drive. |
Private |
Defina como true para ocultar do navegador de servidores. |
MaxCars |
Veículos permitidos por jogador. 1 é recomendado para servidores maiores. |
ResourceFolder |
Caminho para o diretório Resources contendo mods e plugins do lado do servidor. |
LogChat |
Se true, as mensagens de chat dos jogadores são registradas no console. |
Seleção de Mapas
O BeamMP usa os mesmos mapas do BeamNG.drive. O mapa é especificado como um caminho de nível na configuração Map. Abaixo estão os mapas padrão mais utilizados:
| Nome do Mapa | Caminho do Mapa | Descrição |
|---|---|---|
| Grid Map v2 | /levels/gridmap_v2/info.json |
Uma área de testes plana e aberta. Ótima para construções livres e testes de veículos. |
| West Coast USA | /levels/west_coast_usa/info.json |
Um mapa grande e detalhado com rodovias, uma cidade e terreno variado. Muito popular para freeroam. |
| East Coast USA | /levels/east_coast_usa/info.json |
Colinas ondulantes, florestas e uma pequena cidade. Bom para off-road e passeios. |
| Italy | /levels/italy/info.json |
Um cenário de campo italiano com estradas estreitas e uma cidade costeira. |
| Utah | /levels/utah/info.json |
Terreno desértico com longas rodovias e trilhas off-road. |
| Jungle Rock Island | /levels/jungle_rock_island/info.json |
Uma ilha tropical com estradas sinuosas e vegetação densa. |
| Industrial | /levels/industrial/info.json |
Uma área industrial compacta com rampas, saltos e pistas de obstáculos. |
| Small Island USA | /levels/small_island/info.json |
Uma pequena ilha com estradas apertadas. Boa para menor quantidade de jogadores. |
| Driver Training | /levels/driver_training/info.json |
Uma pista estilo autocross projetada para prática de manuseio de veículos. |
Resources/Client e usando o caminho de mapa apropriado. Consulte Configuração de Admin e Recursos do BeamMP para detalhes sobre como adicionar conteúdo personalizado.
Máximo de Jogadores e Desempenho
BeamNG.drive é um jogo com física intensiva. Cada jogador e veículo adiciona carga significativa tanto ao servidor quanto aos clientes conectados. Tenha estas orientações em mente:
- MaxPlayers: 8–20 jogadores é o típico para uma experiência suave. Servidores maiores (20+) são possíveis, mas requerem mais recursos e configuração cuidadosa.
- MaxCars: Manter em
1por jogador é fortemente recomendado para servidores com mais de 10 jogadores. Cada veículo adicional multiplica os dados de física que precisam ser sincronizados. - A escolha do mapa importa: Mapas maiores e mais detalhados (West Coast USA, Italy) usam mais memória do que mapas mais simples (Grid Map, Industrial).
- Largura de banda da rede: O BeamMP envia dados detalhados de física para cada veículo. Grandes quantidades de jogadores com múltiplos veículos por jogador podem saturar a largura de banda rapidamente.
MaxCars para 1 e diminuir MaxPlayers. Esta é a forma mais eficaz de melhorar o desempenho do servidor.
Como Conectar
Os jogadores se conectam aos servidores BeamMP através do launcher do BeamMP, não pelo launcher padrão do BeamNG.drive.
Via Navegador de Servidores
- Baixe e instale o launcher do BeamMP em beammp.com.
- Inicie o launcher do BeamMP. Ele iniciará o BeamNG.drive com o mod multiplayer BeamMP carregado.
- No menu principal, selecione Multiplayer.
- Navegue pela lista de servidores ou use a barra de pesquisa para encontrar seu servidor pelo nome.
- Clique no seu servidor e selecione Connect.
Via Conexão Direta
- No menu multiplayer do BeamMP, clique em Direct Connect.
- Insira o endereço IP e a porta do seu servidor no formato
IP:PORT(ex.:192.168.1.1:30814). - Clique em Connect.
PRIVATE está definido como false e que sua chave de autenticação é válida. Pode levar um ou dois minutos após a inicialização para o servidor aparecer no navegador. Se ainda não aparecer, verifique o console para erros de autenticação. Observe que sua porta é atribuída aleatoriamente, a menos que você tenha um IP privado -- verifique o GPanel para a porta correta.
Gerenciamento de Saves
BeamNG.drive é um jogo baseado em sessões. Não há estado de mundo persistente ou arquivo de save para o servidor. Quando os jogadores desconectam ou o servidor reinicia, todas as posições e estados de veículos são resetados. Cada sessão começa do zero.
- Não há saves de mundo para fazer backup ou gerenciar.
- A configuração do servidor (
ServerConfig.toml) e os recursos persistem entre reinicializações. - As configurações de veículos dos jogadores são armazenadas no lado do cliente, não no servidor.
Artigos Relacionados
- Configuração de Admin e Recursos do BeamMP — Comandos de admin, mapas personalizados, plugins e gerenciamento de recursos
- 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 e uma descrição do problema.