diff --git a/README.md b/README.md
index d606de4..91a87ae 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,120 @@
-# Counter-Strike-Grupo8
+# 🕹️ Counter-Strike 2D - Remake
 
-Grupo 8 - Trabajo Final 2025-1C Taller de Programacion Catedra Veiga
+**Trabajo Final - 1C 2025**  
+**Taller de Programación I – Cátedra Veiga**  
+Facultad de Ingeniería, Universidad de Buenos Aires
 
-## Desarrollo
+---
 
-1. Instalar los hooks de pre-commit
+## 👥 Integrantes
+
+- **[FernandYu](https://github.com/FernandoYu)**
+- **[Tcorzo](https://github.com/tcorzo)**
+- **[fnpratto](https://github.com/fnpratto)**
+- **[jesapugliese](https://github.com/jesapugliese)**
+
+**Corrector**: Francisco Vázquez
+
+---
+
+## 📄 Descripción del Proyecto
+
+Este proyecto es un remake en 2D del clásico juego **Counter-Strike**, desarrollado como trabajo final de la materia **Taller de Programación I**. Incluye:
+
+- Cliente y servidor en C++20
+- Comunicación en red mediante sockets
+- Editor de niveles visual
+- Lógica de juego en rondas, con roles, tienda, bombas, y puntajes
+- Efectos visuales y sonoros (SDL)
+- Configuración flexible vía archivos YAML
+
+---
+
+## 📽️ Demo / Video Trailer
+
+[![Watch the video](docs\img\log-in-window.png)](https://youtu.be/liW75mH29Ns)
+
+---
+
+## 🎥 Vistazo al juego
+
+> Muestra de las funcionalidades principales del juego en acción:
+
+---
+
+### 🧢 Selección de equipo y skin  
+¡Elegí tu bando y personalizá tu personaje antes de cada partida!
+
+![Selección de equipo](docs/gif/choose_skin_team.gif)
+
+---
+
+### 💼 Compra de armas  
+Abrí la tienda con `B`, seleccioná tu equipo y armate hasta los dientes.
+
+![Tienda en juego](docs/gif/store.gif)
+
+---
+
+### ⏱️ Esperando jugadores  
+El juego comienza cuando todos están listos para la batalla.
+
+![Esperando jugadores](docs/gif/wait_for_player.gif)
+
+---
+
+### 📊 Scoreboard  
+Al final de cada ronda, se muestra un resumen con estadísticas por jugador.
+
+![Scoreboard](docs/gif/score_board_view.gif)
+
+---
+
+### ✅ Victoria de los Counter-Terrorists  
+Los CTs logran defender el sitio y desactivar la bomba a tiempo.
+
+![Victoria CT](docs/gif/ct_win.gif)
+
+---
+
+### 💣 Victoria de los Terroristas  
+Los terroristas consiguen plantar la bomba y hacerla estallar.
+
+![Victoria Terrorista](docs/gif/terrorist_win.gif)
+
+---
+
+### 🔧 Desactivación de bomba  
+Un anti-terrorista logra el defuse en el último segundo. ¡Épico!
+
+![Defuse bomba](docs/gif/defuse_bomb.gif)
+-----
+
+
+
+### Compilar
 
 ```bash
-pre-commit install
-pre-commit install --hook-type commit-msg
+make
 ```
+
+### Ejecutar servidor
+```
+./build/taller_server <puerto>
+```
+
+### Ejecutar cliente
+```
+./build/taller_client
+```
+
+---
+📚 Documentación
+
+Toda la documentación se encuentra en la carpeta `/docs`:
+
+📘 [Manual de Usuario](docs\manual_usuario.md): cómo compilar, ejecutar y jugar.
+
+🧠 [Documentación Técnica](docs\documentacion_tecnica.md): estructura del código, módulos, funcionalidades y pendientes.
+
+🛠️ [Manual del Proyecto](docs\manual_de_proyecto.md): organización del equipo, herramientas utilizadas, problemas y aprendizajes.
diff --git a/assets/gfx/guns/ammo.xcf b/assets/gfx/guns/ammo.xcf
index 2abb4c9..c1b1181 100644
Binary files a/assets/gfx/guns/ammo.xcf and b/assets/gfx/guns/ammo.xcf differ
diff --git a/docs/documentacion_tecnica.md b/docs/documentacion_tecnica.md
index 8b7bca1..cc7a7da 100644
--- a/docs/documentacion_tecnica.md
+++ b/docs/documentacion_tecnica.md
@@ -6,13 +6,12 @@ Todas las funcionalidades y mejoras se rastrean mediante issues y pull requests
 
 ### 1. Client
 
-- Shop ( el cliente le llega la información de la tienda pero no la usa esta hardcodeado y no envia los mensajes correspondientes para la compra)
+- Shop 
 - Implementación del campo de visión
 - Implementación de animaciones del disparo y plantar bomba
 - Visualización del contador de tiempo bomba y objetos en el suelo
 - Integración de sonidos (gestor y eventos)
 - Visualización de fin de ronda ( mostrar los scores de equipos, mensaje de quipo ganador de ronda)
-- Hay problemas de delay al mandar muchos comandos a la vez
 
 ### 2. Server
 
@@ -28,15 +27,9 @@ Todas las funcionalidades y mejoras se rastrean mediante issues y pull requests
 - Agregado de dinero a los jugadores al empezar una nueva ronda
 - Bonificaciones de dinero de acuerdo a estadísticas de los jugadores
 - Finalización de la partida tras 10 rondas (victoria / derrota).
-- Respuestas de error desde el server (error responses).
 
 ### Editor de niveles
 
-## Posibles modificaciones
-
-### 1. Server
-
--
 
 ## Funcionalidades incompletas
 
diff --git a/docs/gif/choose_skin_team.gif b/docs/gif/choose_skin_team.gif
new file mode 100644
index 0000000..122eb0e
Binary files /dev/null and b/docs/gif/choose_skin_team.gif differ
diff --git a/docs/gif/ct_win.gif b/docs/gif/ct_win.gif
new file mode 100644
index 0000000..7f0abb3
Binary files /dev/null and b/docs/gif/ct_win.gif differ
diff --git a/docs/gif/defuse_bomb.gif b/docs/gif/defuse_bomb.gif
new file mode 100644
index 0000000..e5b5611
Binary files /dev/null and b/docs/gif/defuse_bomb.gif differ
diff --git a/docs/gif/score_board_view.gif b/docs/gif/score_board_view.gif
new file mode 100644
index 0000000..54900fa
Binary files /dev/null and b/docs/gif/score_board_view.gif differ
diff --git a/docs/gif/store.gif b/docs/gif/store.gif
new file mode 100644
index 0000000..ec3d274
Binary files /dev/null and b/docs/gif/store.gif differ
diff --git a/docs/gif/terrorist_win.gif b/docs/gif/terrorist_win.gif
new file mode 100644
index 0000000..5d72692
Binary files /dev/null and b/docs/gif/terrorist_win.gif differ
diff --git a/docs/gif/wait_for_player.gif b/docs/gif/wait_for_player.gif
new file mode 100644
index 0000000..8cab066
Binary files /dev/null and b/docs/gif/wait_for_player.gif differ