Servidor de Minecraft com Docker para o modpack Prominence II [RPG]

Introdução

Prominence II [RPG] é um modpack, e esse repositório foi criado com o intuito de criar um servidor Docker local, com backup, para o streamer PRECOCE_LENTO e seus espectadores.

Esse projeto não tem nenhuma relação com o modpack, com a Mojang e/ou afiliados.

💻 Desenvolvimento

O desenvolvimento do projeto foi baseado na documentação do Minecraft Server on Docker (Java Edition), utilizando o Docker Compose e as imagens: itzg/minecraft-server para criar o server e a itzg/mc-backup para os backups.

Siga as instruções abaixo para saber os requisitos e comandos para rodar o projeto.

Pré-requisitos

Para conseguir desenvolver ou realizar manutenção no projeto, verifique se possui as seguintes ferramentas instaladas:

• Git
• Docker

Rodando o projeto

ANTES de seguir as etapas, tenha certeza de que:

• Você possui o git instalado em sua máquina
• Você possui o docker instalado e RODANDO em sua máquina

1. Clone o repositório

git clone https://github.com/marcosvaz/prominence.git && cd prominence

2. Crie um arquivo .env utilizando o .env.example como referência.

Important

Solicite as variáveis corretas com o responsável.

3. Rode o comando do Docker Compose para iniciar o servidor

docker compose up -d

Por fim as imagens serão baixadas do Docker, e os contâiners serão criados à partir do arquivo de configuração docker-compose.yml. Assim que o servidor estiver rodando, você poderá acessá-lo através da porta 25565 no Multiplayer do Minecraft.

Caso haja necessidade de compartilhar o acesso do servidor local com pessoas externas, existem diversas formas, busque a opção que melhor se encaixar em sua necessidade, algumas delas são Radmin e NO-IP.

Extras

• Comandos Minecraft
  Para rodar um comando do próprio Minecraft como administrador, execute

docker exec server rcon-cli <COMANDO> # Para executar um único comando

docker exec -i server rcon-cli # Para abrir o terminal interativo e executar vários comandos

Você pode consultar uma lista de comandos em Minecraft Wiki - Fandom.

• Backups
  O servidor está configurado para realizar backups à cada 5m, utilizando a imagem itgz/mc-backup, no entanto, você pode mudar essas configurações no arquivo .env seguindo a documentação em itzg/docker-mc-backup.
  
  Ou você pode também executar um comando para realizar o backup manualmente, utilizando

docker-compose exec backups backup now

⚠️ Problemas frequentes

Caso você execute o projeto através de uma recuperação de backup, provavelmente irá se deparar com o seguinte erro:

Error: Could not find or load main class cpw.mods.bootstraplauncher.BootstrapLauncher
Caused by: java.lang.ClassNotFoundException: cpw.mods.bootstraplauncher.BootstrapLauncher

Deve ser possível resolvê-lo adicionando a variável de ambiente abaixo ao arquivo .env

########################################################
### Descomente a linha seguinte APENAS caso ocorra   ###
### o erro na recuperação do backup. Após o servidor ###
### iniciar, comente a linha novamente.              ###
########################################################

FORGE_FORCE_REINSTALL = TRUE

Caution

A variável já se encontra no arquivo .env, basta descomentar a linha, rodar o docker compose up -d, e comentar a mesma novamente. Lembre-se de não executar novamente com essa variável, pois ela força a reinstalação do Forge.