6. Início Rápido

Este guia irá ajudá-lo a começar rapidamente com o MINECRAFT - FGA - 2025/1.

6.1. Primeira Execução

  1. Inicie os containers (se ainda não estiverem rodando):

    docker-compose up -d

  2. Acesse o container:

    docker exec -it python_mine bash

  3. Execute o jogo:

    python main.py

6.2. Criando seu Primeiro Personagem

  1. Na tela inicial, você verá o menu principal

  2. Selecione a opção 6. ➕ Criar novo personagem

  3. Digite um nome para seu personagem

  4. Confirme a criação

  5. Escolha se deseja selecionar o personagem agora

Note

Novos personagens começam no Chunk 1 do Mapa 1 durante o Dia, em um ambiente que pode ser qualquer bioma (Deserto, Selva, Floresta, ou Oceano).

6.4. Sistema de Movimento

Quando você inicia o jogo, pode mover seu personagem:

  1. Selecione 🎮 Iniciar jogo

  2. 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

  3. Escolha uma direção (1-4)

  4. O sistema informará se houve mudança de bioma

Exemplo de movimento:

🚶 OPÇÕES DE MOVIMENTO:
----------------------------------------
1. ⬆️ Cima - 🌊 Oceano (Chunk 2)
2. ⬇️ Baixo - 🌴 Selva (Chunk 4)
3. ⬅️ Esquerda - 🏜️ Deserto (Chunk 1)
4. ➡️ Direita - 🌲 Floresta (Chunk 3)

Note

Novidade: Agora o sistema exibe o nome do bioma em vez do ID numérico! Você verá “🌊 Oceano” em vez de “BIOMA: 4”.

6.5. Biomas Disponíveis

O mundo do jogo possui 4 biomas diferentes:

  • 🏜️ Deserto (ID: 1) - Um bioma árido com pouca vegetação

  • 🌴 Selva (ID: 2) - Um bioma tropical denso e úmido

  • 🌲 Floresta (ID: 3) - Um bioma com muitas árvores e vida selvagem

  • 🌊 Oceano (ID: 4) - Um vasto bioma de água salgada

Cada bioma oferece uma experiência visual e narrativa diferente durante a exploração.

6.6. Gerenciando Personagens

6.6.1. Listando Personagens

  1. Selecione 5. 📋 Lista de personagens

  2. Você verá uma visualização em grid de todos os personagens

  3. Cada personagem mostra: * Nome * Vida atual/máxima com barra visual colorida * XP * Força * Localização atual (formato: “Mapa X - Chunk Y”)

6.6.2. Selecionando um Personagem

  1. Na lista de personagens, escolha 1. 🎮 Selecionar personagem

  2. Digite o número do personagem desejado

  3. O personagem será carregado e se tornará o ativo

6.6.3. Deletando um Personagem

  1. Na lista de personagens, escolha 2. 🗑️ Deletar personagem

  2. Digite o número do personagem a ser deletado

  3. Confirme a operação

  4. Nota: Não é possível deletar o personagem ativo

6.7. Verificando o Status

Para ver informações detalhadas do seu personagem:

  1. Selecione 2. 📊 Ver status detalhado

  2. Você verá: * Nome e ID do personagem * Vida atual e máxima com barra visual * XP e força * Localização detalhada (bioma, mapa e turno) * Status de vida

Exemplo de status:

📊 STATUS DO PERSONAGEM:
========================================
👤 Nome: Steve
🆔 ID: 1
❤️  Vida: 85/100 [████████████████████░░░]
⚡ Força: 12
🎯 XP: 150
📍 Localização: 🌊 Oceano (Mapa 1 - Dia)
✅ Status: Vivo

6.8. Salvando Progresso

O jogo salva automaticamente quando você: * Sai do jogo * Troca de personagem * Move seu personagem

Para salvar manualmente: #. Selecione 3. 💾 Salvar progresso #. Confirme que os dados foram salvos

Tip

Novidade: O sistema agora salva tanto a localização formatada (“Mapa X - Chunk Y”) quanto o ID do chunk atual para melhor performance.

6.9. Resolução de Problemas

Erro ao Mover Personagem

Se você receber um erro relacionado à localização do personagem:

  1. Verifique se o personagem tem uma localização válida no status

  2. Tente salvar o progresso manualmente

  3. Se o problema persistir, crie um novo personagem

Bioma Não Aparece

Se o bioma aparecer como número em vez do nome:

  1. Isso pode indicar um problema temporário de conexão

  2. Tente mover para outro chunk e voltar

  3. Reinicie o jogo se necessário

Problemas de Performance

Para melhor performance:

  1. Salve o progresso regularmente

  2. Evite criar muitos personagens desnecessários

  3. Use a funcionalidade de deletar personagens antigos

6.10. Estrutura do Mundo

O mundo do jogo é organizado da seguinte forma:

  • Mapas: Cada mapa tem um nome e um turno (Dia/Noite)

  • Chunks: Cada chunk pertence a um mapa e tem um bioma

  • Coordenadas: Chunks são organizados em grid com coordenadas X,Y

  • Biomas: Cada chunk tem um bioma que define sua aparência e características

Navegação:

  • Chunks são numerados sequencialmente (1, 2, 3, …)

  • Movimento entre chunks adjacentes é possível

  • Localização é exibida como “Mapa X - Chunk Y”

6.11. Saindo do Jogo

Para sair do jogo:

  1. Selecione 7. 🚪 Sair

  2. O jogo salvará automaticamente seu progresso

  3. Você verá uma mensagem de confirmação

Para sair do container Docker:

  1. Digite exit ou pressione Ctrl+D

Para parar os containers:

  1. No terminal host:

    docker-compose down

6.12. Próximos Passos

Agora que você conhece o básico:

6.13. Funcionalidades Avançadas

Para usuários que desejam explorar mais funcionalidades:

Desenvolvimento:

  • Examine o código em app/src/models/ para entender a estrutura dos dados

  • Verifique os repositories em app/src/repositories/ para consultas customizadas

  • Analise os services em app/src/services/ para lógica de negócio

Banco de Dados:

  • Conecte-se diretamente ao PostgreSQL para consultas avançadas

  • Explore os arquivos SQL em db/ para entender a estrutura

  • Use as consultas de álgebra relacional para análise de dados

Testes:

  • Execute python -m pytest para rodar os testes unitários

  • Verifique os testes em tests/ para exemplos de uso

  • Adicione novos testes ao modificar funcionalidades