Guia de configuração do servidor GTO 0.6.0

Este artigo explica como usar o pacote oficial de servidor para abrir um servidor multiplayer de GregTech Odyssey. O pacote de servidor inclui um script de instalação que instala automaticamente o Forge e baixa todos os mods do servidor, sem necessidade de montar manualmente os arquivos do servidor.

Guia de leitura

1. Instalar Java
2. Extrair servidor
3. Instalar mods
4. Aceitar EULA
5. Selecionar dificuldade
6. Configurar servidor
7. Iniciar

Preparação antes de abrir o servidor

Instale o Java 25 no servidor (você pode usar distribuições como Eclipse Temurin) e, após a instalação, execute o seguinte comando no terminal para confirmar que a versão exibida é 25:

1. Acesse a página Releases para baixar GregTech-Odyssey-server.zip;

2. Extraia o arquivo compactado por completo em uma pasta vazia, doravante denominada “diretório do servidor”.

Atenção：Certifique-se de extrair completamente. No diretório do servidor, se a gto-installer pasta estiver ausente, o script de instalação não poderá ser executado.

Execute o script de instalação no diretório do servidor e selecione o idioma conforme solicitado:

O script instalará automaticamente o Forge 1.20.1-47.4.20 e baixará todos os mods do servidor. Quando aparecer “Instalação concluída com sucesso”, significa que a instalação terminou.

Dica: O script de instalação pode ser executado repetidamente. Para forçar a verificação de todos os mods novamente, você pode excluir o arquivo packwiz.json do diretório do servidor e executar novamente. Não execute várias janelas de instalação ao mesmo tempo.

1. Execute o script de inicialização: no Windows execute run.bat, Linux / macOS execute bash run.sh;

2. Na primeira inicialização serão gerados eula.txt e outros arquivos, e o programa será encerrado automaticamente;

3. Abra eula.txt, altere eula=false para eula=true e salve.

Descrição：Definir eula como true significa que você concorda com Contrato de Licença de Usuário Final do Minecraft。Neste momento, o mundo ainda não foi gerado; conclua primeiro as etapas cinco e seis antes de iniciar oficialmente.

A dificuldade do servidor é determinada por config/gtocore-rules.txt em preset uma linha, os valores possíveis são os seguintes. Para diferenças entre as dificuldades, consulte Guia de Características de Dificuldade.

Por exemplo, defina a dificuldade como Normal:

Atenção：A dificuldade do mundo é bloqueada na primeira geração e não pode ser alterada depois; defina-a antes de iniciar oficialmente. Se já houver um mundo com dificuldade diferente da definida neste arquivo, o servidor se recusará a iniciar e gerará gtocore-rules.world.txt registrando as regras desse mundo.

Descrição：As configurações de dificuldade do cliente do jogador não precisam ser ajustadas manualmente. Quando estiverem inconsistentes com o servidor, ao entrar no servidor, as regras do servidor serão sincronizadas automaticamente e o jogador será avisado para reiniciar o jogo.

Memória: edite o arquivo no diretório do servidor user_jvm_args.txt, usando o -Xmx parâmetro para definir a memória máxima, por exemplo:

Propriedades do servidor：Editar server.properties，As configurações comuns são as seguintes：

Execute o script de inicialização novamente. Quando aparecer no console Done a mensagem indica que a inicialização foi concluída; os jogadores podem entrar usando «endereço do servidor:porta». Os comandos de console comuns são os seguintes:

Dica: Ao executar o servidor no Linux via SSH, recomenda-se iniciá-lo em uma sessão screen ou tmux, para evitar que o servidor seja encerrado quando a conexão cair. Ao desligar o servidor, use o comando stop, evitando encerrar o processo diretamente e causar corrupção do save.

Este modpack usa Open Parties and Claims para gerenciar territórios. Para manter os chunks do território de um jogador carregados enquanto ele estiver offline, você pode world/serverconfig/openpartiesandclaims-default-player-config.toml definir em:

Atenção：Ativar o carregamento forçado de chunks offline aumentará significativamente a carga do servidor; ative com cautela de acordo com a configuração do servidor.

Descrição: Ao atualizar, extraia a nova versão em uma nova pasta e depois copie os dados do servidor antigo para ela. Não extraia a nova versão diretamente sobre o diretório do servidor antigo. Após a cópia, mantenha o servidor antigo como está; ele pode ser usado diretamente como backup. Não o exclua antes de confirmar que o novo servidor está funcionando corretamente.

1. Instalar nova versão
2. Copiar dados do servidor
3. Iniciar e verificar

Siga as etapas 2 e 3 de «1. Configurar um servidor» e extraia o servidor da nova versãopara uma nova pasta, e execute o script de instalação.Não exclua o servidor antigo, pois ele será mantido como backup.

Primeiro, execute stop no console do servidor antigo para desligar o servidor; em seguida, copie as seguintes pastas e arquivos do diretório do servidor antigo para o mesmo local no diretório do novo servidor. Ao encontrar arquivos com o mesmo nome, escolhaSobrescrever; itens que não existem no servidor antigo podem ser ignorados diretamente.

Deve copiar

Copiar conforme necessário

Atenção: Não copie mods pasta. As novas versões dos mods incluem atualizações, adições e remoções; copiar a antiga mods pasta pode causar duplicação de mods ou incompatibilidade de versões, impedindo o servidor de iniciar. Se houver mods adicionados por você, coloque os arquivos jar correspondentes separadamente na mods pasta.

Dica：Se em server.properties você modificou level-name，copie a pasta do mundo com o nome correspondente.config/gtocore-rules.txt deve corresponder à dificuldade do mundo, caso contrário o servidor se recusará a iniciar; copie todo o config para preservar esse arquivo.

Inicie o novo servidor, confirme que o mundo carrega normalmente e que os jogadores conseguem entrar normalmente e, depois, exclua o servidor antigo conforme necessário.

Atenção: o cliente do jogador deve ser atualizado para a mesma versão do servidor. Para saber como atualizar o cliente, consulteGuia de instalação e atualização do GTO 0.6.0.

Se o problema ainda não foi resolvido, envie um feedback no grupo de chat ou acesse Issues para enviar um relatório de problema, anexando o log do servidor ou o relatório de crash.