SERVER / DEPLOYMENT

Guia de Configuração do Servidor

Guia completo sobre TOKEN, variáveis de ambiente, visibilidade no lobby e exemplos de configuração.

Este guia reúne as variáveis de ambiente, o fluxo de solicitação de TOKEN e as regras de visibilidade no lobby mais usadas ao abrir um servidor. Todo o conteúdo vem do documento original de configuração do servidor e foi adaptado para leitura no site.

1. Visão geral

Este manual explica como configurar e iniciar o seu próprio servidor do jogo usando variáveis de ambiente em um arquivo .env. Depois de iniciado, o servidor se registra automaticamente no lobby oficial, e a sua configuração define o tipo de servidor e sua visibilidade.

Atenção: toda variável que começa com GAME_ e cujo tipo é um indicador de presença é considerada ativada apenas por existir, independentemente do valor atribuído. Para desativar a função, remova a linha ou não defina a variável.

2. Preparação

  • Obrigatório: solicite um TOKEN de autorização do jogo válido (GAME_TOKEN) com a equipe oficial. Sem TOKEN não é possível abrir um servidor público (autorizado ou oficial).
  • Prepare um servidor com IP público, ou uma máquina em rede local caso você queira apenas partidas em LAN.
  • Instale Docker e Docker Compose (recomendado), ou garanta que o ambiente de execução atenda aos requisitos do jogo.
  • Envie a solicitação de TOKEN para team@nextindie.cn.

Modelo de solicitação de TOKEN

Assunto: Solicitação de TOKEN - IP: 127.0.0.1 (substitua pelo seu IP público)
Corpo:
UID do usuário: ID da sua conta no jogo (deve estar correto para agilizar a análise)
IP público: seu endereço de IP público (precisa responder a ping ou a solicitação será recusada)
Finalidade: informe para que o servidor será usado (por exemplo: servidor pessoal, servidor de comunidade)
Região do servidor: informe onde o servidor está hospedado (por exemplo: Ásia, América do Norte)

Confirme se todas as informações estão corretas. Depois da aprovação, o TOKEN será enviado para o seu e-mail. O prazo normal de análise é de 3 a 7 dias úteis.
Ao solicitar um TOKEN de servidor, você concorda em seguir nossas regras de servidor e aceita eventuais punições aplicadas a servidores irregulares, como exclusão do TOKEN ou remoção do lobby. Não compartilhe seu TOKEN com terceiros, pois isso pode fazer com que seu servidor seja abusado ou atacado.

3. Todos os parâmetros configuráveis

3.1 Base e autorização

VariávelTipoPadrãoDescrição
GAME_NAMEStringThe MesozicNome do servidor exibido aos jogadores na lista do lobby
GAME_TOKENStringVazioTOKEN de autorização do jogo. Deve ser solicitado à equipe oficial. Sem um TOKEN válido, o servidor não pode ser registrado como público (autorizado ou oficial). Veja a Seção 4.
GAME_AUTO_RESTARTIndicador de presençaNenhumQuando ativado, o servidor reinicia automaticamente uma vez por dia para manter a estabilidade em longos períodos
GAME_ADMINSStringNenhumIDs de usuário administradores do servidor, separados por vírgulas, por exemplo 100001,10002,100003.

3.2 Rede e tipo de conexão

VariávelTipoPadrãoDescrição
GAME_IPString127.0.0.1O IP público do servidor. Informe o IP correto ou outros jogadores não conseguirão se conectar
GAME_HOSTIndicador de presençaNenhumApenas para modo LAN. Quando definido, o servidor detecta automaticamente o IP local da máquina e ignora GAME_IP. O servidor passa a ser LAN e não aparece na lista pública
GAME_PORTInteiro26666Porta de escuta do servidor (UDP). Certifique-se de liberá-la no firewall
GAME_MAX_PLAYERSInteiro64Número máximo de jogadores simultâneos
GAME_GLOBALBooleanotrueDefine se o nó global de matchmaking será usado. Em geral, mantenha em true
GAME_PUBLICIndicador de presençafalseControla se o servidor será público. Se não estiver definido, o servidor permanece privado (com senha ou visível apenas para amigos). Se estiver definido, ele aparece no lobby, desde que os requisitos de TOKEN e link sejam atendidos
GAME_LINKIndicador de presençafalseForça o servidor a ser um servidor privado (PRIVACY). Defina esta variável se quiser uma sala privada com senha. Servidores privados normalmente não são públicos ou ficam visíveis apenas para um grupo específico
GAME_NODEStringASNó de região exibido para referência de latência. Valores válidos: AS (Ásia), CN (China), NA (América do Norte), SA (América do Sul), EU (Europa), ME (Oriente Médio)

Prioridade e combinação dos tipos de conexão

Se GAME_LINK estiver definido, o servidor será um servidor privado (PRIVACY). Mesmo com GAME_PUBLIC ativado, ele continuará existindo apenas como sala privada com senha.

Se nenhuma dessas variáveis especiais estiver definida, e GAME_PUBLIC estiver ativado com um GAME_TOKEN válido, o servidor será registrado como servidor autorizado (AUTHORIZE). Essa é a principal forma de jogadores comuns hospedarem servidores públicos.

Se GAME_PUBLIC não estiver definido, o servidor permanece privado independentemente do TOKEN e não aparece na lista pública.

3.3 Regras de jogo

VariávelTipoPadrãoDescrição
GAME_DEAD_TIMEInteiro (segundos)1800Tempo até um cadáver apodrecer e desaparecer
GAME_START_GROWTHDecimal0.1Valor inicial de crescimento de um novo personagem (0.0 ~ 1.0)
GAME_MAX_GROWTHDecimal1.0Valor máximo de crescimento do personagem
GAME_SPEED_GROWTHDecimal1.0Multiplicador da velocidade de crescimento
GAME_TEAMInteiro6Tamanho máximo do grupo
GAME_CHILDInteiro0Quantidade de filhotes ou seguidores que um jogador pode ter ao mesmo tempo. 0 desativa descendentes
GAME_SAFEInteiro (segundos)0Tempo de proteção ao nascer para novos personagens
GAME_TEAM_DAMAGEIndicador de presençaAtivadoAtiva dano entre membros da equipe. Remova esta variável se não quiser fogo amigo
GAME_HATCHIndicador de presençaAtivadoPermite incubação por convite e reprodução cooperativa com outros jogadores
GAME_EVOLIndicador de presençaAtivadoPermite evolução por ovo, avançando entre estágios através dos ovos
GAME_PKIndicador de presençaDesativadoAtiva duelos voluntários entre jogadores
GAME_ALT_TURNIndicador de presençaAtivadoPermite girar parado
GAME_MALE_REBIRTHIndicador de presençaAtivadoPermite renascimento usando personagens machos
GAME_SINGLE_BREEDIndicador de presençaDesativadoPermite incubação solo sem parceiro
GAME_ERA_REBIRTHIndicador de presençaDesativadoPermite renascimento entre eras (renascimento geracional)
GAME_DOWNGRADE_REBIRTHIndicador de presençaDesativadoPermite renascimento com regressão para um estágio evolutivo inferior
GAME_LEARNIndicador de presençaAtivadoPermite aprendizado de genes
GAME_CHILD_ATTRIBUTE_INHERITIndicador de presençaDesativadoDefine se os filhotes herdam atributos dos pais (isso pode causar crescimento infinito de atributos)

3.4 IA e ecossistema

VariávelTipoPadrãoDescrição
GAME_MAX_AIIndicador de presençaAtivadoDefine se dinossauros do ecossistema controlados por IA são gerados. Se desativado, apenas jogadores existirão no mapa
GAME_AI_MATEIndicador de presençaDesativadoDefine se um companheiro controlado por IA pode seguir e ajudar o jogador

3.5 Genes e proficiência

VariávelTipoPadrãoDescrição
GAME_CRAZYIndicador de presençaAtivadoPermite o aparecimento de genes berserk
GAME_GENE_SKILLFULIndicador de presençaAtivadoAtiva o sistema de proficiência genética
GAME_KILL_SKILLFULIndicador de presençaDesativadoDefine se matar outros jogadores concede proficiência

3.6 Modos de jogo (escolha um)

VariávelTipoDescrição
GAME_MODE_SANDBOXIndicador de presençaModo sandbox: jogadores podem escolher espécies livremente e genes berserk são desativados
GAME_MODE_EVOLIndicador de presençaModo evolução: as espécies iniciais são limitadas, a evolução por ovo é forçada e criaturas mais poderosas são liberadas gradualmente
GAME_MODE_PRIMEVALIndicador de presençaModo primeval: genes berserk, renascimento com regressão e incubação solo são forçados, enquanto a proficiência genética é desativada

Ative apenas um modo. Se mais de um estiver definido, o último sobrescreverá os anteriores.

3.7 Configurações de dificuldade

VariávelTipoPadrãoDescrição
GAME_SIMPLEIndicador de presençaDesativadoAtiva dificuldade simples (renascimento geracional, regressivo e incubação solo ligados; incubação por convite desligada)
GAME_NORMALIndicador de presençaDesativadoAtiva dificuldade normal (somente renascimento geracional fica ativo)
GAME_HARDInteiro0Define diretamente o nível de dificuldade e sobrescreve as duas flags anteriores. Valores válidos: 0=normal, 1=simples, 2=muito fácil, 3=difícil, 4=hardcore

3.8 PVP / PVE (escolha um)

VariávelTipoDescrição
GAME_PVPIndicador de presençaAtiva o modo PVP (jogadores podem se atacar)
GAME_PVEIndicador de presençaAtiva o modo PVE (dano entre jogadores é desativado, mas duelos continuam permitidos)

Escolha apenas um desses modos. Não é recomendado definir os dois ao mesmo tempo.

3.9 Mapa

VariávelTipoPadrãoDescrição
GAME_MAPStringTag do primeiro mapa interno do jogoIdentificador do mapa, por exemplo Oasis. Consulte a lista oficial de mapas para ver os valores disponíveis

3.10 Carregamento de MOD

VariávelTipoPadrãoDescrição
GAME_MODSStringNenhumNomes dos MODs a carregar, separados por vírgula, por exemplo ModA,ModB. Confirme que esses MODs estão instalados corretamente no diretório Data/Mods do servidor

4. Tipos de servidor e visibilidade no lobby

Tipo de servidorVariáveis de ambiente necessáriasCaracterísticas
Servidor LAN (LAN)Defina GAME_HOSTSomente jogadores na mesma rede local conseguem se conectar. O servidor não aparece no lobby público
Servidor privado (PRIVACY)Defina GAME_LINK. Não requer TOKENA entrada exige senha. O servidor permanece privado por padrão, embora amigos ainda possam entrar diretamente por outros meios. Ele não aparece na lista pública do lobby
Servidor autorizado (AUTHORIZE)Defina GAME_PUBLIC e informe um GAME_TOKEN válido. Não defina GAME_HOST, GAME_LINK nem GAME_OFFICIALEsta é a forma mais comum de hospedar servidores públicos. O servidor aparece no lobby com a marca de autorizado, logo abaixo dos servidores oficiais

Lembretes importantes

  • Se você quer que o servidor apareça no lobby e possa ser encontrado por todos os jogadores, as três condições precisam ser atendidas: 1) ativar GAME_PUBLIC, 2) fornecer um GAME_TOKEN válido e 3) não ativar GAME_HOST nem GAME_LINK.
  • Um servidor público sem TOKEN válido será bloqueado durante o registro e informará que o TOKEN do servidor é inválido ou expirou.
  • Após iniciar, o servidor envia um heartbeat ao lobby a cada 90 segundos para continuar listado. Se os heartbeats pararem, o servidor sai da lista, mas os jogadores conectados permanecem online.

5. Exemplo de configuração

5.1 Servidor público autorizado (recomendado para hospedagem pessoal)

# Base
GAME_TOKEN=TOKEN_SOLICITADO_A_EQUIPE_OFICIAL
GAME_NAME=The Mesozoic Dawn
GAME_AUTO_RESTART=1
GAME_ADMINS=100001,100002

# Rede: IP público e porta
GAME_IP=203.0.113.10
GAME_PORT=26666
GAME_MAX_PLAYERS=100
GAME_PUBLIC=1
GAME_NODE=AS

# Regras (ajuste como preferir)
GAME_CHILD=2
GAME_SAFE=30
GAME_TEAM=4
GAME_DEAD_TIME=1200
GAME_EVOL=1
GAME_AI_MATE=1

# Modo: sandbox
GAME_MODE_SANDBOX=1

# Mapa
GAME_MAP=Oasis