Dungeon - Algoritmos e Estruturas de Dados I

Repositório destinado à atividade da disciplina DISC.0050 - Algoritmos e Estruturas de Dados I, do curso de Graduação.

O projeto apresenta um jogo de exploração desenvolvido em Python, no qual o jogador deve percorrer uma caverna, administrar sua energia e coletar itens para conseguir escapar.

📚 Disciplina

• Disciplina: Algoritmos e Estruturas de Dados I
• Código: DISC.0050
• Curso: Graduação
• Carga horária: 80 h/a
• Período letivo: 2026.2

🎯 Objetivo

Praticar os fundamentos da construção de algoritmos por meio de uma aplicação interativa executada no terminal.

O jogo trabalha principalmente:

• Entrada de dados pelo teclado;
• Variáveis e tipos de dados;
• Estruturas de repetição (while);
• Estruturas condicionais (if, elif e else);
• Operadores relacionais e lógicos;
• Controle de energia e contagem de itens;
• Geração de valores aleatórios com a biblioteca nativa random.

🎮 Descrição do projeto

O jogador começa com 100 pontos de energia e precisa coletar 5 itens para escapar da caverna. A cada rodada, ele informa quantos passos deseja caminhar, respeitando o limite de 1 a 20 passos.

Cada passo consumido reduz a energia do jogador. Ao final do movimento, existe uma chance de 30% de encontrar um item. O jogo termina quando todos os itens são encontrados ou quando a energia chega a zero.

Melhorias implementadas

• A lógica foi organizada nas funções jogar() e ler_passos(), deixando o código mais fácil de testar e manter.
• As regras do jogo agora ficam reunidas em constantes, como energia inicial, quantidade de itens e limites de passos.
• Entradas que não são números inteiros são rejeitadas sem interromper o jogo.
• Valores fora do intervalo de 1 a 20 continuam sendo rejeitados sem consumir energia.
• O jogo encerra de forma limpa quando a entrada termina ou quando o jogador usa Ctrl+C.
• O arquivo só inicia uma partida quando é executado diretamente, graças ao bloco if __name__ == "__main__".
• Foram corrigidos erros de digitação e as mensagens de vitória e derrota foram padronizadas.

📁 Organização do projeto

dungeon/
│
├── dungeon.py
└── README.md

🐍 Tecnologias utilizadas

• Python 3
• Git
• GitHub

Não são necessárias bibliotecas externas. O projeto utiliza apenas a biblioteca random, que já faz parte da instalação padrão do Python.

▶️ Como executar

1. Instale o Python

Certifique-se de possuir o Python 3 instalado no computador.

Para verificar:

python --version

ou:

python3 --version

2. Clone o repositório

git clone https://github.com/DevNunes-tech/dungeon.git

Entre na pasta:

cd dungeon

3. Execute o jogo

python dungeon.py

Em alguns sistemas, utilize:

python3 dungeon.py

Digite a quantidade de passos desejada a cada rodada, sempre usando um número inteiro entre 1 e 20. Entradas inválidas serão solicitadas novamente.

💡 Exemplo

Você está numa caverna e precisa coletar 5 itens para escapar.
Digite a quantidade de passos que deseja andar (1-20): 4
Você gastou 4 e agora tem 96 de energia
Você encontrou um item. Itens coletados: 1 de 5

📌 Observações

O resultado de cada rodada pode variar porque a localização dos itens é definida aleatoriamente. Valores menores que 1, maiores que 20 ou que não sejam números inteiros são rejeitados e não consomem energia. A partida pode ser encerrada a qualquer momento com Ctrl+C.

👨‍💻 Autor

Mateus Oliveira Nunes

Atividade acadêmica desenvolvida para a disciplina Algoritmos e Estruturas de Dados I.

---

2026.2 — Algoritmos e Estruturas de Dados I