Guia de Configuração do Servidor Starbound
Este guia aborda a configuração do seu servidor dedicado Starbound na Legion Hosting, incluindo pré-requisitos de autenticação Steam, primeira inicialização, configuração do servidor, configurações de universo, conexão de jogadores e gerenciamento de saves. Para instalação de mods, consulte Instalação de Mods do Starbound. Para comandos de admin e privilégios, consulte Comandos de Admin do Starbound.
Pré-requisitos
Antes de iniciar seu servidor Starbound, você deve ter o seguinte:
- Uma conta Steam que possua Starbound. O binário do servidor não está disponível para download anônimo -- a conta que você fornecer deve ter Starbound em sua biblioteca.
- Considerações sobre Steam Guard. Se sua conta Steam tem o Steam Guard (autenticação de dois fatores) habilitado, você precisará fornecer o código de autenticação via variável de inicialização
STEAM_AUTHdurante a primeira instalação. Após a autenticação inicial, o SteamCMD armazena a sessão em cache e as inicializações subsequentes não devem exigir o código novamente, a menos que o cache expire. - Conta Steam dedicada recomendada. Por segurança, considere usar uma conta Steam separada que possua Starbound exclusivamente para hospedagem de servidor. Isso evita compartilhar as credenciais da sua conta principal e previne conflitos se você quiser jogar na mesma conta simultaneamente.
Primeira Inicialização
Após adquirir seu servidor Starbound da Legion Hosting, siga estes passos para colocá-lo em funcionamento pela primeira vez:
- Faça login no GPanel e selecione seu servidor Starbound.
- Vá para a aba Startup.
- Preencha as credenciais Steam necessárias:
- STEAM_USER -- Nome de usuário da sua conta Steam (obrigatório).
- STEAM_PASS -- Senha da sua conta Steam (obrigatório).
- STEAM_AUTH -- Seu código 2FA do Steam Guard, se solicitado (opcional, necessário apenas na primeira instalação ou quando a sessão em cache expirar).
- Vá para a aba Console e clique em Start.
- O servidor fará o download dos arquivos do servidor dedicado Starbound via SteamCMD. Isso pode levar vários minutos na primeira inicialização.
- Quando o download for concluído, o servidor gerará um universo padrão e começará a ouvir conexões.
STEAM_AUTH e reinicie o servidor. Verifique seu e-mail ou aplicativo autenticador para obter o código. Normalmente, você só precisa fazer isso uma vez -- o SteamCMD armazenará a sessão em cache para futuras inicializações.
Variáveis de Inicialização do GPanel
| Variável | Obrigatório | Descrição |
|---|---|---|
STEAM_USER |
Sim | Nome de usuário da conta Steam. Deve possuir Starbound. Não pode ser anonymous. |
STEAM_PASS |
Sim | Senha da conta Steam para o nome de usuário acima. |
STEAM_AUTH |
Não | Código de autenticação de dois fatores do Steam Guard. Necessário apenas durante a configuração inicial ou quando a sessão em cache expirar. |
WORKSHOP |
Não | Defina como 1 para habilitar suporte a mods da Steam Workshop, ou 0 para desabilitar. O padrão é 0. Consulte Instalação de Mods do Starbound para detalhes. |
starbound_server.config
O arquivo principal de configuração do servidor está localizado em:
storage/starbound_server.config
Este arquivo usa formato JSON. Edite-o via o Gerenciador de Arquivos no GPanel ou através de SFTP. O servidor deve estar parado antes de editar, pois as alterações são carregadas na inicialização.
Configurações Principais do Servidor
| Configuração | Padrão | Descrição |
|---|---|---|
serverName |
"A Starbound Server" |
O nome exibido no navegador de servidores e quando jogadores se conectam. |
maxPlayers |
8 |
Número máximo de jogadores que podem estar conectados simultaneamente. |
gameServerPort |
21025 |
A porta em que o servidor do jogo escuta. Na Legion Hosting, isso é definido automaticamente -- não altere a menos que instruído pelo suporte. |
gameServerBind |
"::" |
A interface de rede para vincular. O padrão "::" vincula a todas as interfaces (IPv4 e IPv6). Deixe como está. |
serverPassword |
"" |
Senha necessária para entrar no servidor. Deixe vazio para sem senha (acesso público). |
allowAnonymousConnections |
true |
Quando true, jogadores podem conectar sem uma conta Starbound. Defina como false para exigir autenticação de conta para todos os jogadores. |
allowAssetsMismatch |
true |
Quando true, jogadores com conjuntos de mods diferentes ainda podem conectar. Defina como false para forçar a correspondência de assets entre servidor e cliente (recomendado para servidores com mods). |
maxTeamSize |
4 |
Número máximo de jogadores por grupo/equipe. |
clientIPJoinable |
false |
Se o servidor pode ser acessado via IP direto. Deve ser true para servidores dedicados. |
clientP2PJoinable |
false |
Se conexões peer-to-peer são permitidas. Geralmente false para servidores dedicados. |
Exemplo de starbound_server.config
{
"serverName" : "My Legion Starbound Server",
"maxPlayers" : 8,
"gameServerBind" : "::",
"serverPassword" : "",
"allowAnonymousConnections" : true,
"allowAssetsMismatch" : true,
"maxTeamSize" : 4,
"clientIPJoinable" : true,
"clientP2PJoinable" : false,
"allowAdminCommands" : true,
"allowAdminCommandsFromAnyone" : false,
"serverUsers" : {
"YourUsername" : {
"admin" : true,
"password" : "your-admin-password"
}
}
}
Configurações de Mundo e Universo
Starbound usa um universo gerado proceduralmente. Cada vez que um jogador visita um novo sistema estelar ou planeta, o jogo o gera com base em uma seed de universo e sistema de coordenadas. Os dados do universo do servidor são armazenados em:
storage/universe/
Este diretório contém todos os dados de mundo gerados, incluindo planetas, estações espaciais e estruturas construídas por jogadores colocadas no mundo.
Configuração do Universo
Os parâmetros de geração do universo podem ser ajustados no arquivo starbound_server.config ou através de arquivos de assets relacionados ao universo. Conceitos-chave:
| Conceito | Descrição |
|---|---|
| Seed do Universo | O universo é gerado proceduralmente com base em coordenadas. Todos os servidores com a mesma versão do jogo gerarão planetas idênticos nas mesmas coordenadas, mas objetos colocados por jogadores e modificações são únicos para cada servidor. |
| Planeta Inicial | Novos jogadores surgem em um planeta inicial selecionado proceduralmente. O mundo inicial é um planeta tipo jardim adequado para a progressão inicial do jogo. |
| Arquivos de Mundo | Cada planeta visitado gera um arquivo .world em storage/universe/. Esses arquivos contêm modificações de terreno, objetos colocados e alterações de tiles feitas por jogadores. |
| Dados Celestiais | Os arquivos universe.chunks e universe.dat no diretório do universo armazenam o estado geral do mapa do universo. |
storage/universe/. Esteja ciente de que isso remove todos os mundos gerados, incluindo quaisquer estruturas construídas por jogadores. Sempre faça backup antes de fazer isso.
Como Conectar
Jogadores se conectam ao seu servidor Starbound usando o menu multijogador no jogo.
Conexão Direta via IP
- Inicie o Starbound.
- No menu principal, clique em Multiplayer.
- Selecione seu personagem.
- No campo Server Address, insira o endereço IP e a porta do seu servidor no formato:
IP:Port - Se o servidor tem uma senha definida, insira o Account Name e Password correspondentes a uma entrada
serverUsersna configuração do servidor. SeallowAnonymousConnectionsestiver comotruee nenhuma senha de servidor estiver definida, esses campos podem ser deixados vazios. - Clique em Join Server.
Amigos Steam (Não Aplicável)
O recurso "Entrar no Jogo" do Steam é para jogos hospedados peer-to-peer, não para servidores dedicados. Os jogadores devem usar o método de conexão direta por IP descrito acima para entrar no seu servidor Legion Hosting.
- O servidor está em execução e completamente iniciado (verifique o console do GPanel para "Info: Server listened on").
- O IP e a porta corretos estão sendo usados.
- Se estiver usando uma senha de servidor, o jogador está inserindo as credenciais corretas de
serverUsers. - Se
allowAssetsMismatchestiver comofalse, os mods instalados do jogador devem corresponder exatamente aos mods do servidor. - Tanto o servidor quanto o cliente estão executando a mesma versão do Starbound.
Gerenciamento de Saves
Starbound armazena todos os dados do servidor dentro do diretório storage/. Entender a estrutura de arquivos ajuda com backups, transferências e solução de problemas.
Principais Diretórios e Arquivos de Armazenamento
| Caminho | Descrição |
|---|---|
storage/universe/ |
Contém todos os dados de mundo gerados -- planetas, estações espaciais e modificações de jogadores nos mundos. Cada planeta visitado tem um arquivo .world. |
storage/player/ |
Contém arquivos de save dos jogadores. Cada jogador tem um arquivo .player armazenando seu inventário, progresso, estado de missões e dados da nave. |
storage/starbound_server.config |
O arquivo principal de configuração do servidor. |
storage/starbound_server.log |
Arquivo de log do servidor. Útil para diagnosticar travamentos, erros e problemas de conexão. |
Criando Backups
Backups regulares protegem o universo, dados dos jogadores e configuração do seu servidor contra perda acidental ou corrupção.
- Pare seu servidor no GPanel para garantir que todos os dados foram gravados no disco.
- Conecte-se ao seu servidor via SFTP ou use o Gerenciador de Arquivos.
- Baixe o diretório inteiro
storage/para seu computador local. - Armazene o backup em um local seguro com uma etiqueta de data (ex.:
storage-backup-2026-02-26).
storage/universe/ e storage/player/. Eles contêm todos os dados de mundo e progresso dos jogadores. Você também deve fazer backup do starbound_server.config para preservar as configurações do servidor.
Restaurando a partir de Backup
- Pare seu servidor.
- Faça upload dos seus arquivos de backup para os locais correspondentes no diretório
storage/, sobrescrevendo os arquivos existentes. - Inicie o servidor.
Transferindo um Mundo de Outro Servidor
Para mover seu universo Starbound de outro servidor ou de um jogo local:
- Pare tanto o servidor de origem quanto o de destino.
- Copie o diretório
storage/universe/da origem para o servidor de destino. - Opcionalmente, copie
storage/player/se você quiser transferir os dados dos jogadores também. - Copie seu
starbound_server.configpara preservar as configurações do servidor. - Inicie o servidor de destino e verifique se o mundo carrega corretamente.
Artigos Relacionados
- Instalação de Mods do Starbound
- Comandos de Admin do Starbound
- Como Encontrar o IP e a Porta do Seu Servidor
- Como Fazer Upload de Arquivos via SFTP
- Guia de Inicialização do Servidor
Precisa de Ajuda?
Se você está enfrentando problemas não cobertos 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.