🧑‍🏫 Documentación Didáctica con Estilo

Bienvenido al proyecto de ejemplo Arcade 2D, desarrollado con Unity como una propuesta educativa y extremadamente práctica para iniciarse en el desarrollo de videojuegos. 🚀

¿Quieres aprender cómo se hace un juego desde cero? Aquí aprenderás a:

Mover al jugador 🎮
Crear enemigos que piensan (¡un poco! 😅)
Disparar (mucho 🔫)
Recolectar Power-Ups 💎
Limpiar la pantalla como si fuera un Ulti de Overwatch ⚡
¡Y todo documentado como un pro! 📚

🧱 Estructura del Proyecto

1. 🎮 Control del Jugador

PlayerController.cs: Movimiento fluido y alabeo (rotación) opcional.
PlayerShooting.cs: Sistema modular de disparo con armas intercambiables.

2. 🔫 Sistema de Disparo

ShootingBehaviour.cs: Clase abstracta para proyectiles.
AlternatingShot.cs: Disparo alternante (izquierda/derecha).
TripleShot.cs: Disparo en abanico (como un escopetazo espacial).

3. 🧠 IA y Movimiento Enemigo

HomingMovement.cs: Persigue al jugador como un misil.
ErraticMovement.cs: Movimiento caótico con rotación suave.
LinearMovement.cs: Movimiento recto (ideal para meteoritos).
EnemyShooting.cs: Los enemigos también disparan 😈

4. 🌀 Oleadas de Enemigos

Wave.cs: Define enemigos, cantidad y ritmo de aparición.
SpawnManager.cs: Gestiona niveles, oleadas y dificultad escalable.

5. 💥 Daño, Vida y Explosiones

Health.cs: Vida, curación y destrucción con explosión incluida 💣
DamageOnCollision.cs: Aplica daño según el tipo de objeto (enemigo, jugador, bala…).

6. 🧩 Power-Ups

PowerUpWeapon.cs: Cambia tu arma, temporal o permanente.
PowerUpExtraLife.cs: Gana salud adicional ❤️
PowerUpAddScreenClearUses.cs: Añade usos a tu habilidad especial.
PowerUpMotion.cs: Movimiento flotante y rotatorio para los Power-Ups.

7. 🔥 Habilidad Especial

ScreenClearAbility.cs: Pulsa Q para destruir TODO en pantalla 💀 (estilo “ulti”)

8. 📊 Puntuación y HUD

ScoreManager.cs: Sistema de puntuación con TextMeshPro. Cada enemigo vale... ¡y tus disparos también!

📚 Objetivos Didácticos

🎯 Aprender jugando. Pero jugando con el código.

Entender la estructura de un juego en Unity 2D.
Aplicar programación orientada a componentes.
Modularizar comportamientos reutilizables (como disparo o daño).
Implementar una interfaz gráfica funcional y clara.
Crear IA básica para enemigos.
Documentar como un desarrollador profesional con Doxygen.

🧠 ¿A quién va dirigido?

🎓 Estudiantes que empiezan en diseño y desarrollo de videojuegos.
👩‍🏫 Docentes que buscan material práctico para el aula.
🎮 Personas autodidactas que sueñan con hacer su primer shooter arcade.

🛠️ Tecnologías Utilizadas

Unity (versión 6, pero compatible con anteriores)
C# usando MonoBehaviour y componentes personalizados
TextMeshPro para la UI
Doxygen para generar documentación de código clara y navegable

📌 Notas Importantes

Todos los scripts están comentados al estilo pro, para que Doxygen pueda generar documentación automática.
Este proyecto puede crecer: niveles, jefes, mejoras permanentes, power-ups avanzados... ¡Todo está preparado para escalar! 🔝

✨ ¡A jugar, aprender y crear!

Este no es solo un juego.
Es una experiencia de aprendizaje jugable.

🎮 Convierte tu curiosidad en código.
🧠 Convierte tu código en conocimiento.
🔥 Y si te equivocas... ¡revienta un enemigo y vuelve a intentarlo!

Gracias por acompañarme en este pequeño gran proyecto lleno de cariño, código y pasión por enseñar.

“El mejor juego es el que también te enseña algo.”

👾 Ayose Lomba Pérez
Docente y entusiasta de la creación de videojuegos educativos