Guia de Configuração do Servidor de Starbound
Este guia aborda a configuração e instalação do seu servidor dedicado de Starbound na Legion Hosting, incluindo pré-requisitos de autenticação Steam, primeiro arranque, configuração do servidor, definições do universo, ligação de jogadores e gestão de saves. Para instalação de mods, consulte Instalação de Mods do Starbound. Para comandos e privilégios de administrador, consulte Comandos de Administrador do Starbound.
Pré-requisitos
Antes de iniciar o seu servidor de Starbound, deve ter o seguinte:
- Uma conta Steam que possua o Starbound. O binário do servidor não está disponível para descarga anónima -- a conta que fornecer deve ter o Starbound na sua biblioteca.
- Considerações sobre o Steam Guard. Se a sua conta Steam tem o Steam Guard (autenticação de dois fatores) ativado, terá de fornecer o código de autenticação através da variável de arranque
STEAM_AUTHdurante a primeira instalação. Após a autenticação inicial, o SteamCMD guarda a sessão em cache e os arranques subsequentes não devem requerer o código novamente, a menos que a cache expire. - Conta Steam dedicada recomendada. Por segurança, considere utilizar uma conta Steam separada que possua o Starbound exclusivamente para alojamento de servidores. Isto evita partilhar as credenciais da sua conta principal e previne conflitos se quiser jogar na mesma conta simultaneamente.
Primeiro Arranque
Após adquirir o seu servidor de Starbound na Legion Hosting, siga estes passos para o colocar a funcionar pela primeira vez:
- Inicie sessão no GPanel e selecione o seu servidor de Starbound.
- Vá ao separador Startup.
- Preencha as credenciais Steam necessárias:
- STEAM_USER -- O nome de utilizador da sua conta Steam (obrigatório).
- STEAM_PASS -- A palavra-passe da sua conta Steam (obrigatório).
- STEAM_AUTH -- O código 2FA do Steam Guard, se solicitado (opcional, apenas necessário na primeira instalação ou quando a sessão em cache expira).
- Vá ao separador Console e clique em Start.
- O servidor irá descarregar os ficheiros do servidor dedicado de Starbound via SteamCMD. Isto pode demorar vários minutos no primeiro arranque.
- Após a conclusão do download, o servidor irá gerar um universo predefinido e começar a aguardar ligações.
STEAM_AUTH e reinicie o servidor. Verifique o seu email ou aplicação de autenticação para obter o código. Normalmente só precisa de fazer isto uma vez -- o SteamCMD guardará a sessão em cache para arranques futuros.
Variáveis de Arranque do GPanel
| Variável | Obrigatório | Descrição |
|---|---|---|
STEAM_USER |
Sim | Nome de utilizador da conta Steam. Deve possuir o Starbound. Não pode ser anonymous. |
STEAM_PASS |
Sim | Palavra-passe da conta Steam para o nome de utilizador acima. |
STEAM_AUTH |
Não | Código de autenticação de dois fatores do Steam Guard. Apenas necessário durante a configuração inicial ou quando a sessão em cache expira. |
WORKSHOP |
Não | Defina como 1 para ativar o suporte a mods do Steam Workshop, ou 0 para desativar. A predefinição é 0. Consulte Instalação de Mods do Starbound para mais detalhes. |
starbound_server.config
O ficheiro de configuração principal do servidor está localizado em:
storage/starbound_server.config
Este ficheiro utiliza o formato JSON. Edite-o através do Gestor de Ficheiros no GPanel ou através de SFTP. O servidor deve estar parado antes de editar, pois as alterações são carregadas no arranque.
Definições Principais do Servidor
| Definição | Predefinição | Descrição |
|---|---|---|
serverName |
"A Starbound Server" |
O nome apresentado no navegador de servidores e quando os jogadores se conectam. |
maxPlayers |
8 |
Número máximo de jogadores que podem estar conectados simultaneamente. |
gameServerPort |
21025 |
A porta na qual o servidor de jogo escuta. Na Legion Hosting, esta é definida automaticamente -- não a altere a menos que seja instruído pelo suporte. |
gameServerBind |
"::" |
A interface de rede à qual se vincular. A predefinição "::" vincula-se a todas as interfaces (IPv4 e IPv6). Deixe como está. |
serverPassword |
"" |
Palavra-passe necessária para entrar no servidor. Deixe vazio para sem palavra-passe (acesso público). |
allowAnonymousConnections |
true |
Quando true, os jogadores podem conectar-se 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 podem ainda conectar-se. Defina como false para impor correspondência de assets entre servidor e cliente (recomendado para servidores com mods). |
maxTeamSize |
4 |
Número máximo de jogadores por grupo/equipa. |
clientIPJoinable |
false |
Se o servidor pode ser acedido via IP direto. Deve ser true para servidores dedicados. |
clientP2PJoinable |
false |
Se ligações peer-to-peer são permitidas. Tipicamente 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"
}
}
}
Definições do Mundo e Universo
O Starbound utiliza um universo gerado proceduralmente. Cada vez que um jogador visita um novo sistema estelar ou planeta, o jogo gera-o com base numa semente do universo e num sistema de coordenadas. Os dados do universo do servidor são armazenados em:
storage/universe/
Este diretório contém todos os dados do 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 ficheiro starbound_server.config ou através de ficheiros de assets relacionados com o universo. Conceitos-chave:
| Conceito | Descrição |
|---|---|
| Semente do Universo | O universo é gerado proceduralmente com base em coordenadas. Todos os servidores com a mesma versão do jogo irão gerar planetas idênticos nas mesmas coordenadas, mas os objetos colocados por jogadores e as modificações são únicos de cada servidor. |
| Planeta Inicial | Os novos jogadores aparecem num planeta inicial selecionado proceduralmente. O mundo inicial é um planeta do tipo jardim adequado para a progressão inicial do jogo. |
| Ficheiros de Mundo | Cada planeta visitado gera um ficheiro .world em storage/universe/. Estes ficheiros contêm modificações de terreno, objetos colocados e alterações de blocos feitas por jogadores. |
| Dados Celestiais | Os ficheiros universe.chunks e universe.dat no diretório do universo armazenam o estado geral do mapa do universo. |
storage/universe/. Tenha em atenção que isto remove todos os mundos gerados, incluindo quaisquer estruturas construídas por jogadores. Faça sempre uma cópia de segurança antes de fazer isto.
Como Conectar
Os jogadores conectam-se ao seu servidor de Starbound utilizando o menu multijogador no jogo.
Ligação Direta via IP
- Inicie o Starbound.
- No menu principal, clique em Multiplayer.
- Selecione o seu personagem.
- No campo Server Address, introduza o endereço IP e a porta do seu servidor no formato:
IP:Port - Se o servidor tem uma palavra-passe definida, introduza o Account Name e a Password correspondentes a uma entrada de
serverUsersna configuração do servidor. SeallowAnonymousConnectionsestá definido comotruee não há palavra-passe de servidor definida, estes campos podem ser deixados vazios. - Clique em Join Server.
Amigos Steam (Não Aplicável)
A funcionalidade "Join Game" do Steam é para jogos alojados peer-to-peer, não para servidores dedicados. Os jogadores devem utilizar o método de ligação direta por IP descrito acima para entrar no seu servidor da Legion Hosting.
- O servidor está a funcionar e totalmente iniciado (verifique a consola do GPanel para "Info: Server listened on").
- O IP e a porta corretos estão a ser utilizados.
- Se utiliza uma palavra-passe de servidor, o jogador está a introduzir as credenciais
serverUserscorretas. - Se
allowAssetsMismatchestá definido comofalse, os mods instalados pelo jogador devem corresponder exatamente aos mods do servidor. - Tanto o servidor como o cliente estão a executar a mesma versão do Starbound.
Gestão de Saves
O Starbound armazena todos os dados do servidor dentro do diretório storage/. Compreender a estrutura de ficheiros ajuda com cópias de segurança, transferências e resolução de problemas.
Diretórios e Ficheiros de Armazenamento Principais
| Caminho | Descrição |
|---|---|
storage/universe/ |
Contém todos os dados do mundo gerados -- planetas, estações espaciais e modificações de jogadores aos mundos. Cada planeta visitado tem um ficheiro .world. |
storage/player/ |
Contém ficheiros de save dos jogadores. Cada jogador tem um ficheiro .player que armazena o seu inventário, progresso, estado de missões e dados da nave. |
storage/starbound_server.config |
O ficheiro de configuração principal do servidor. |
storage/starbound_server.log |
Ficheiro de registo do servidor. Útil para diagnosticar crashes, erros e problemas de ligação. |
Criar Cópias de Segurança
Cópias de segurança regulares protegem o universo, dados dos jogadores e configuração do seu servidor contra perda acidental ou corrupção.
- Pare o seu servidor no GPanel para garantir que todos os dados foram escritos no disco.
- Conecte-se ao seu servidor via SFTP ou utilize o Gestor de Ficheiros.
- Descarregue todo o diretório
storage/para o seu computador local. - Guarde a cópia de segurança num local seguro com uma etiqueta de data (por ex.,
storage-backup-2026-02-26).
storage/universe/ e storage/player/. Estes contêm todos os dados de progresso do mundo e dos jogadores. Deve também fazer cópia de segurança de starbound_server.config para preservar as definições do servidor.
Restaurar a partir de Cópia de Segurança
- Pare o seu servidor.
- Carregue os ficheiros de cópia de segurança para as localizações correspondentes no diretório
storage/, substituindo os ficheiros existentes. - Inicie o servidor.
Transferir um Mundo de Outro Servidor
Para mover o seu universo Starbound de outro servidor ou de um jogo local:
- Pare tanto o servidor de origem como o de destino.
- Copie o diretório
storage/universe/da origem para o servidor de destino. - Opcionalmente, copie
storage/player/se quiser transferir também os dados dos jogadores. - Copie o seu
starbound_server.configpara preservar as definiçõ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 Administrador do Starbound
- Como Encontrar o IP e a Porta do Seu Servidor
- Como Carregar Ficheiros via SFTP
- Guia de Início do Servidor
Precisa de Ajuda?
Se está 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 e uma descrição do problema.