Actualitzat README.md

README.md

@@ -1,45 +1,72 @@
 # Coffee Crisis Arcade Edition
 
-Coffee Crisis Arcade Edition es la versió ampliada i millorada del aclamat Coffee Crisis. Preparat per a jugar sense parar amn dos jugadors, nous gràfics i moltes sorpreses mes.
+**¡La batalla definitiva pel cafè està ací!**
+
+Coffee Crisis Arcade Edition és una versió ampliada i millorada del aclamat Coffee Crisis. Aquesta versió porta l'acció cooperativa al següent nivell, amb:
+
+- **Mode multijugador** per a dues persones.
+- **Nous gràfics** que revitalitzen l'experiència arcade clàssica.
+- **Moltes sorpreses** per descobrir en cada partida.
+
+Defensa el teu cafè contra les bambolles gegants en aquest trepidant joc d'arcade! 🍵
 
 <p align="center">
-    <img src="https://php.sustancia.synology.me/images/ccae_title.png" alt="Titol" 
+    <img src="https://php.sustancia.synology.me/images/ccae_title.png" alt="Títol" />
 </p>
 
 ## Controls
-El joc està optimitzat per a ser jugat amb un mando de jocs, encara que un dels jugadors pot utilitzar el teclat.
-Les tecles son les següents:
 
-* **Fletxes**: Mou al personatge
+El joc està optimitzat per a ser jugat amb un mando de jocs, encara que un dels jugadors pot utilitzar el teclat.
-* **Q, W, E**: Disparar a la esquerra, al centre i a la dreta respectivament
+
+### Controls del teclat:
+- **Fletxes**: Mou al personatge.
+- **Q, W, E**: Disparar a l'esquerra, al centre i a la dreta, respectivament.
+
+> Nota: El joc suporta nomes un jugador amb teclat.
 
 <p align="center">
-    <img src="https://php.sustancia.synology.me/images/ccae1.png" alt="Joc" 
+    <img src="https://php.sustancia.synology.me/images/ccae1.png" alt="Joc" />
 </p>
 
 ## Altres tecles
-- **Tecla ESC**: Tancar el joc
 
-- **Tecla F1**: Fa la finestra mes xicoteta
+| Tecla       | Funció                                       |
-
+|-------------|----------------------------------------------|
-- **Tecla F2**: Fa la finestra mes gran
+| **ESC**     | Tancar el joc                                |
-
+| **F1**      | Fa la finestra més xicoteta                 |
-- **Tecla F3**: Alterna entre el mode de pantalla completa i el de finestra
+| **F2**      | Fa la finestra més gran                     |
-
+| **F3**      | Alterna entre mode de pantalla completa i finestra |
-- **Tecla F4**: Activa o desactiva els shaders
+| **F4**      | Activa o desactiva els shaders              |
-
+| **F5**      | Activa o desactiva l'àudio                 |
-- **Tecla F5**: Activa o desactiva l'audio
+| **F6**      | Activa o desactiva el dispar automàtic      |
-
+| **F7**      | Canvia l'idioma del joc i reinicia         |
-- **Tecla F6**: Activa o desactiva el dispar automàtic
+| **F10**     | Reset del joc                               |
-
-- **Tecla F7**: Canvia el idioma del joc i reinicia
-
-- **Tecla F10**: Reset
 
 <p align="center">
-    <img src="https://php.sustancia.synology.me/images/ccae2.png" alt="Joc" 
+    <img src="https://php.sustancia.synology.me/images/ccae2.png" alt="Joc" />
 </p>
 
+## Com instal·lar i jugar
+
+1. Descarrega el joc des de [l'apartat de llançaments](https://gitea.sustancia.synology.me/JailDesigner/coffee_crisis_arcade_edition/releases).
+2. Descomprimix i executa l'arxiu `coffee_crisis_arcade_edition.exe`.
+3. Gaudeix del joc!
+
+## Agraïments
+
+Vull expressar la meua gratitud a **ChatGPT** i **GitHub Copilot**. Gràcies per ser un suport constant en el desenvolupament d'aquest joc!
+
+També vull agrair a tots els jugadors que fan que aquest projecte valgui la pena. 🕹️❤️
+
+## Com contribuir
+
+Accepte contribucions! Si tens una idea o vols ajudar:
+
+1. Fes un fork d'aquest repositori.
+2. Crea una branca nova amb els teus canvis.
+3. Fes un pull request.
+
+## Llicència
+
+Aquest joc està subjecte a una llicència [MIT](https://opensource.org/licenses/MIT). Consulta el fitxer LICENSE per a més detalls.
 
-## Agraiments
-A chatGPT i sobretot a Copilot. Gracies per estar sempre quan vos he necesitat.

source/credits.cpp

@@ -4,7 +4,6 @@
 #include <SDL2/SDL_events.h>    // Para SDL_PollEvent, SDL_Event, SDL_QUIT
 #include <SDL2/SDL_pixels.h>    // Para SDL_PIXELFORMAT_RGBA8888
 #include <SDL2/SDL_timer.h>     // Para SDL_GetTicks
-#include <cstdlib>              // Para abs
 #include <algorithm>            // Para max, min, clamp
 #include <cstdlib>              // Para abs
 #include <stdexcept>            // Para runtime_error
@@ -122,7 +121,7 @@ void Credits::render()
     SDL_RenderCopy(Screen::get()->getRenderer(), canvas_, nullptr, nullptr);
 
     // Vuelca el contenido del renderizador en pantalla
-    Screen::get()->blit();
+    Screen::get()->render();
 }
 
 // Comprueba el manejador de eventos

source/director.cpp

@@ -9,42 +9,41 @@
 #include <SDL2/SDL_scancode.h>		 // Para SDL_SCANCODE_0, SDL_SCANCODE_DOWN
 #include <SDL2/SDL_stdinc.h>		 // Para SDL_bool, Uint32
 #include <errno.h>					 // Para errno, EEXIST, EACCES, ENAMETOO...
-#include <stdio.h>					 // Para printf, perror
-#include <sys/stat.h>				 // Para mkdir, stat, S_IRWXU
-#include <unistd.h>					 // Para getuid
-#include <algorithm>				 // Para min
-#include <chrono>					 // Para chrono
-#include <cstdlib>					 // Para exit, EXIT_FAILURE, size_t, rand
-#include <iostream>					 // Para basic_ostream, operator<<, basi...
-#include <memory>					 // Para make_unique, unique_ptr
-#include <stdexcept>				 // Para runtime_error
-#include <string>					 // Para operator+, char_traits, allocator
-#include <vector>					 // Para vector
-#include "asset.h"					 // Para Asset, AssetType
-#include "credits.h"				 // Para Credits
-#include "dbgtxt.h"					 // Para dbg_init
-#include "game.h"					 // Para Game, GAME_MODE_DEMO_OFF, GAME_...
-#include "hiscore_table.h"			 // Para HiScoreTable
-#include "input.h"					 // Para Input, InputType
-#include "instructions.h"			 // Para Instructions
-#include "intro.h"					 // Para Intro
-#include "jail_audio.h"				 // Para JA_SetMusicVolume, JA_SetSoundV...
-#include "lang.h"					 // Para Code, loadFromFile
-#include "logo.h"					 // Para Logo
-#include "manage_hiscore_table.h"	 // Para ManageHiScoreTable
-#include "notifier.h"				 // Para Notifier
-#include "on_screen_help.h"			 // Para OnScreenHelp
-#include "options.h"				 // Para Options, options, OptionsContro...
-#include "param.h"					 // Para Param, ParamGame, param, loadPa...
-#include "resource.h"				 // Para Resource
-#include "screen.h"					 // Para Screen
-#include "section.h"				 // Para Name, Options, name, options
-#include "title.h"					 // Para Title
-#include "utils.h"					 // Para Overrides, overrides
-
 #ifndef _WIN32
-#include <pwd.h> // para getpwuid, passwd
+#include <pwd.h> // Para getpwuid, passwd
 #endif
+#include <stdio.h>				  // Para printf, perror
+#include <sys/stat.h>			  // Para mkdir, stat, S_IRWXU
+#include <unistd.h>				  // Para getuid
+#include <algorithm>			  // Para min
+#include <chrono>				  // Para chrono
+#include <cstdlib>				  // Para exit, EXIT_FAILURE, size_t, rand
+#include <iostream>				  // Para basic_ostream, operator<<, basi...
+#include <memory>				  // Para make_unique, unique_ptr
+#include <stdexcept>			  // Para runtime_error
+#include <string>				  // Para operator+, char_traits, allocator
+#include <vector>				  // Para vector
+#include "asset.h"				  // Para Asset, AssetType
+#include "credits.h"			  // Para Credits
+#include "dbgtxt.h"				  // Para dbg_init
+#include "game.h"				  // Para Game, GAME_MODE_DEMO_OFF, GAME_...
+#include "hiscore_table.h"		  // Para HiScoreTable
+#include "input.h"				  // Para Input, InputType
+#include "instructions.h"		  // Para Instructions
+#include "intro.h"				  // Para Intro
+#include "jail_audio.h"			  // Para JA_SetMusicVolume, JA_SetSoundV...
+#include "lang.h"				  // Para Code, loadFromFile
+#include "logo.h"				  // Para Logo
+#include "manage_hiscore_table.h" // Para ManageHiScoreTable
+#include "notifier.h"			  // Para Notifier
+#include "on_screen_help.h"		  // Para OnScreenHelp
+#include "options.h"			  // Para Options, options, OptionsContro...
+#include "param.h"				  // Para Param, ParamGame, param, loadPa...
+#include "resource.h"			  // Para Resource
+#include "screen.h"				  // Para Screen
+#include "section.h"			  // Para Name, Options, name, options
+#include "title.h"				  // Para Title
+#include "utils.h"				  // Para Overrides, overrides
 
 // Constructor
 Director::Director(int argc, const char *argv[])

source/game.cpp

@@ -917,7 +917,6 @@ void Game::update()
 	if (SDL_GetTicks() - ticks_ > TICKS_SPEED)
 	{
 		ticks_ = SDL_GetTicks();
-		counter_++;
 
 		updateDemo();
 #ifdef RECORDING
@@ -927,15 +926,6 @@ void Game::update()
 		{
 			switch (state_)
 			{
-			case GameState::COMPLETED:
-				updateGameStateCompleted();
-				break;
-			case GameState::GAME_OVER:
-				updateGameStateGameOver();
-				break;
-			case GameState::PLAYING:
-				updateGameStatePlaying();
-				break;
 			case GameState::FADE_IN:
 				updateGameStateFadeIn();
 				break;
@@ -945,7 +935,15 @@ void Game::update()
 			case GameState::SHOWING_GET_READY_MESSAGE:
 				updateGameStateShowingGetReadyMessage();
 				break;
-
+			case GameState::PLAYING:
+				updateGameStatePlaying();
+				break;
+			case GameState::COMPLETED:
+				updateGameStateCompleted();
+				break;
+			case GameState::GAME_OVER:
+				updateGameStateGameOver();
+				break;
 			default:
 				break;
 			}
@@ -1027,7 +1025,7 @@ void Game::render()
 	fade_out_->render();
 
 	// Vuelca el contenido del renderizador en pantalla
-	screen_->blit();
+	screen_->render();
 }
 
 // Habilita el efecto del item de detener el tiempo

source/hiscore_table.cpp

@@ -164,7 +164,7 @@ void HiScoreTable::render()
 	fade_->render();
 
 	// Vuelca el contenido del renderizador en pantalla
-	Screen::get()->blit();
+	Screen::get()->render();
 }
 
 // Recarga todas las texturas

source/instructions.cpp

@@ -265,7 +265,7 @@ void Instructions::render()
 	fade_->render();
 
 	// Vuelca el contenido del renderizador en pantalla
-	Screen::get()->blit();
+	Screen::get()->render();
 }
 
 // Recarga todas las texturas

source/intro.cpp

@@ -415,7 +415,7 @@ void Intro::render()
 	}
 
 	// Vuelca el contenido del renderizador en pantalla
-	Screen::get()->blit();
+	Screen::get()->render();
 }
 
 // Bucle principal

source/jail_audio.h

@@ -1,8 +1,9 @@
 #pragma once
+
 #include <SDL2/SDL_audio.h>  // Para SDL_AudioFormat
 #include <SDL2/SDL_stdinc.h> // Para Uint32, Uint8
-struct JA_Music_t;           // lines 8-8
+struct JA_Music_t;           // lines 4-4
-struct JA_Sound_t;           // lines 7-7
+struct JA_Sound_t;           // lines 5-5
 
 enum JA_Channel_state
 {
@@ -21,9 +22,6 @@ enum JA_Music_state
     JA_MUSIC_DISABLED
 };
 
-struct JA_Sound_t;
-struct JA_Music_t;
-
 void JA_Init(const int freq, const SDL_AudioFormat format, const int channels);
 void JA_Quit();
 

source/logo.cpp

@@ -231,7 +231,7 @@ void Logo::render()
 	}
 
 	// Vuelca el contenido del renderizador en pantalla
-	Screen::get()->blit();
+	Screen::get()->render();
 }
 
 // Bucle para el logo del juego

source/mouse.cpp

@@ -1,4 +1,6 @@
 #include "mouse.h"
+#include <SDL2/SDL_mouse.h> // Para SDL_ShowCursor
+#include <SDL2/SDL_timer.h> // Para SDL_GetTicks
 
 namespace Mouse
 {

source/mouse.h

@@ -1,5 +1,7 @@
 #pragma once
-#include <SDL2/SDL.h>
+
+#include <SDL2/SDL_events.h> // Para SDL_Event
+#include <SDL2/SDL_stdinc.h> // Para Uint32
 
 namespace Mouse
 {

source/screen.cpp

@@ -83,7 +83,7 @@ void Screen::start()
 }
 
 // Vuelca el contenido del renderizador en pantalla
-void Screen::blit()
+void Screen::render()
 {
     // Actualiza el contador de FPS
     fps_counter_++;

source/screen.h

@@ -136,7 +136,7 @@ public:
 	void start();
 
 	// Vuelca el contenido del renderizador en pantalla
-	void blit();
+	void render();
 
 	// Establece el modo de video
 	void setVideoMode(ScreenVideoMode video_mode);

source/title.cpp

@@ -207,7 +207,7 @@ void Title::render()
 	fade_->render();
 
 	// Vuelca el contenido del renderizador en pantalla
-	Screen::get()->blit();
+	Screen::get()->render();
 }
 
 // Comprueba los eventos