Início Rápido
Este guia irá ajudá-lo a começar rapidamente com o MINECRAFT - FGA - 2025/1.
Primeira Execução
Inicie os containers (se ainda não estiverem rodando):
docker-compose up -d
Acesse o container:
docker exec -it python_mine bash
Execute o jogo:
python main.py
Criando seu Primeiro Personagem
Na tela inicial, você verá o menu principal
Selecione a opção 6. ➕ Criar novo personagem
Digite um nome para seu personagem
Confirme a criação
Escolha se deseja selecionar o personagem agora

Sistema de Movimento
Quando você inicia o jogo, pode mover seu personagem:
Selecione 🎮 Iniciar jogo
Você verá as opções de movimento com direções: * ⬆️ Cima - Move para chunk acima * ⬇️ Baixo - Move para chunk abaixo * ⬅️ Esquerda - Move para chunk à esquerda * ➡️ Direita - Move para chunk à direita
Escolha uma direção (1-4)
O sistema informará se houve mudança de bioma
Exemplo de movimento: .. code-block:: text
⬆️ Cima - 🌊 Oceano (Chunk 2)
⬇️ Baixo - 🌴 Selva (Chunk 4)
⬅️ Esquerda - 🏜️ Deserto (Chunk 1)
➡️ Direita - 🌲 Floresta (Chunk 3)
Gerenciando Personagens
Listando Personagens
Selecione 5. 📋 Lista de personagens
Você verá uma visualização em grid de todos os personagens
Cada personagem mostra: * Nome * Vida atual/máxima * XP * Força * Localização atual
Selecionando um Personagem
Na lista de personagens, escolha 1. 🎮 Selecionar personagem
Digite o número do personagem desejado
O personagem será carregado e se tornará o ativo
Deletando um Personagem
Na lista de personagens, escolha 2. 🗑️ Deletar personagem
Digite o número do personagem a ser deletado
Confirme a operação
Nota: Não é possível deletar o personagem ativo
Verificando o Status
Para ver informações detalhadas do seu personagem:
Selecione 2. 📊 Ver status detalhado
Você verá: * Nome e ID do personagem * Vida atual e máxima * XP e força * Localização (bioma, mapa e turno) * Status de vida
Salvando Progresso
O jogo salva automaticamente quando você: * Sai do jogo * Troca de personagem
Para salvar manualmente: #. Selecione 3. 💾 Salvar progresso #. Confirme que os dados foram salvos
Saindo do Jogo
Para sair do jogo:
Selecione 7. 🚪 Sair
O jogo salvará automaticamente seu progresso
Você verá uma mensagem de confirmação
Para sair do container Docker:
Digite
exit
ou pressioneCtrl+D
Para parar os containers:
No terminal host:
docker-compose down
Próximos Passos
Agora que você conhece o básico:
Guia do Usuário - Aprenda sobre funcionalidades avançadas
Referência da API - Explore a documentação da API
Banco de Dados - Entenda a estrutura do banco de dados