🎮 Terminal Dungeon Adventure

Read this in English | Español

---

Español

📖 Descripción

Terminal Dungeon Adventure es un juego de aventuras tipo roguelike desarrollado en C que se ejecuta directamente en la terminal. Controla a tu héroe (@) mientras exploras mazmorras llenas de enemigos, recoges objetos útiles y buscas la salida.

✨ Características

• 🗺️ Exploración de mazmorras: Navega por mapas llenos de desafíos
• ⚔️ Sistema de combate: Ataca a los enemigos adyacentes
• 🎒 Sistema de inventario: Recoge y usa pociones y llaves
• 🩹 Sistema de salud: Gestiona tu vida estratégicamente
• 🤖 IA de enemigos: Los enemigos se mueven y atacan automáticamente
• 📝 Sistema de registro: Mantén un historial de tus acciones

🎯 Objetivo del Juego

Tu misión es encontrar la llave (K) y llegar hasta la puerta (D) para escapar de la mazmorra. Ten cuidado con los enemigos (E) que patrullan el área y pueden atacarte si te acercas demasiado.

🕹️ Controles

Tecla	Acción
w	Moverse hacia arriba
s	Moverse hacia abajo
a	Moverse hacia la izquierda
d	Moverse hacia la derecha
f	Atacar enemigos adyacentes
u	Usar poción de salud
q	Salir del juego

🎮 Elementos del Juego

• @ - Tu personaje
• E - Enemigos (2 puntos de vida cada uno)
• P - Pociones de salud (+5 HP)
• K - Llave (necesaria para abrir la puerta)
• D - Puerta de salida
• # - Paredes
• ⬜ - Espacios vacíos (caminables)

🚀 Compilación y Ejecución

# Compilar el juego
gcc -o dungeon_game main.c

# Ejecutar el juego
./dungeon_game

📋 Requisitos

• Compilador GCC
• Sistema Unix/Linux (para el comando clear)
• Terminal compatible

🔄 Estado del Proyecto

⚠️ Proyecto en desarrollo activo

Este juego está en sus primeras etapas de desarrollo. Estamos trabajando constantemente para mejorarlo y añadir nuevas características emocionantes.

🛠️ Próximas Características

• Modularización del código - Separar el código en múltiples archivos para mejor organización
• Sistema de colores - Añadir colores ANSI para una mejor experiencia visual
• Múltiples mapas - Crear diferentes niveles y mazmorras
• Más tipos de enemigos - Enemigos con diferentes comportamientos y estadísticas
• Sistema de puntuación - Tabla de puntuaciones máximas
• Efectos de sonido - Audio básico para acciones del juego
• Guardado de partida - Capacidad de guardar y cargar el progreso
• Actualización del README - Documentación mejorada y guías

🤝 Contribuir

¡Las contribuciones son muy bienvenidas! Si te gusta este proyecto y quieres ayudar a mejorarlo:

🔧 Formas de Contribuir

1. 🐛 Reportar Bugs: Abre un issue si encuentras algún problema
2. 💡 Sugerir Características: Comparte tus ideas para nuevas funcionalidades
3. 👨‍💻 Código: Envía un pull request con mejoras o correcciones
4. 📖 Documentación: Ayuda a mejorar este README o añade comentarios al código

📝 Guía para Pull Requests

1. Haz fork del repositorio
2. Crea una rama para tu característica (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abre un Pull Request

📄 Licencia

Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.

📞 Contacto

Si tienes preguntas o sugerencias, no dudes en:

• Abrir un issue
• Contactar a los desarrolladores

---

English

📖 Description

Terminal Dungeon Adventure is a roguelike adventure game developed in C that runs directly in the terminal. Control your hero (@) as you explore dungeons filled with enemies, collect useful items, and search for the exit.

✨ Features

• 🗺️ Dungeon exploration: Navigate through challenging maps
• ⚔️ Combat system: Attack adjacent enemies
• 🎒 Inventory system: Collect and use potions and keys
• 🩹 Health system: Manage your life strategically
• 🤖 Enemy AI: Enemies move and attack automatically
• 📝 Log system: Keep track of your actions

🎯 Game Objective

Your mission is to find the key (K) and reach the door (D) to escape from the dungeon. Be careful with the enemies (E) that patrol the area and can attack you if you get too close.

🕹️ Controls

Key	Action
w	Move up
s	Move down
a	Move left
d	Move right
f	Attack adjacent enemies
u	Use health potion
q	Quit game

🎮 Game Elements

• @ - Your character
• E - Enemies (2 health points each)
• P - Health potions (+5 HP)
• K - Key (needed to open the door)
• D - Exit door
• # - Walls
• ⬜ - Empty spaces (walkable)

🚀 Compilation and Execution

# Compile the game
gcc -o dungeon_game main.c

# Run the game
./dungeon_game

📋 Requirements

• GCC compiler
• Unix/Linux system (for the clear command)
• Compatible terminal

🔄 Project Status

⚠️ Project in active development

This game is in its early stages of development. We are constantly working to improve it and add exciting new features.

🛠️ Upcoming Features

• Code modularization - Separate code into multiple files for better organization
• Color system - Add ANSI colors for better visual experience
• Multiple maps - Create different levels and dungeons
• More enemy types - Enemies with different behaviors and stats
• Scoring system - High score leaderboard
• Sound effects - Basic audio for game actions
• Save game - Ability to save and load progress
• README updates - Improved documentation and guides

🤝 Contributing

Contributions are very welcome! If you like this project and want to help improve it:

🔧 Ways to Contribute

1. 🐛 Report Bugs: Open an issue if you find any problems
2. 💡 Suggest Features: Share your ideas for new functionalities
3. 👨‍💻 Code: Submit a pull request with improvements or fixes
4. 📖 Documentation: Help improve this README or add code comments

📝 Pull Request Guidelines

1. Fork the repository
2. Create a branch for your feature (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is under the MIT License. See the LICENSE file for more details.

📞 Contact

If you have questions or suggestions, feel free to:

• Open an issue
• Contact the developers

---

Made with ❤️ by the community