mes granera

CLAUDE.md

@@ -28,26 +28,31 @@ The executable is output to the project root. The `data/` folder contains runtim
 
 All engine modules are flat C-style APIs (no classes), prefixed by subsystem:
 
-- **JG** (`source/jgame`) — Game loop timing: init/finalize, fixed-timestep update via `JG_ShouldUpdate()`
-- **JD8** (`source/jdraw8`) — 8-bit paletted software renderer. 320x200 screen buffer (`JD8_Surface` = `Uint8*`), palette-indexed blitting with color-key transparency, fade effects. `JD8_Flip()` converts the indexed buffer to ARGB, uploads to SDL texture, and renders through the CRT shader
-- **JA** (`source/jail_audio`) — Custom audio mixing using SDL3 audio streams directly (OGG via stb_vorbis, WAV). Manages music and sound channels independently
-- **JI** (`source/jinput`) — Input: keyboard state polling, key debouncing, cheat code detection
-- **JF** (`source/jfile`) — File I/O: supports loading from filesystem folder or a packed resource file (`.jrf`). Currently uses folder mode (`data/`)
-- **shader** (`source/jshader`) — OpenGL post-processing shader (CRT effect) applied to the back buffer
+- **JG** (`source/core/jgame`) — Game loop timing: init/finalize, fixed-timestep update via `JG_ShouldUpdate()`
+- **JD8** (`source/core/jdraw8`) — 8-bit paletted software renderer. 320x200 screen buffer (`JD8_Surface` = `Uint8*`), palette-indexed blitting with color-key transparency, fade effects. `JD8_Flip()` converts the indexed buffer to ARGB, uploads to SDL texture, and renders through the CRT shader
+- **JA** (`source/core/jail_audio`) — Custom audio mixing using SDL3 audio streams directly (OGG via stb_vorbis, WAV). Manages music and sound channels independently
+- **JI** (`source/core/jinput`) — Input: keyboard state polling, key debouncing, cheat code detection
+- **JF** (`source/core/jfile`) — File I/O: supports loading from filesystem folder or a packed resource file (`.jrf`). Currently uses folder mode (`data/`)
+- **shader** (`source/core/jshader`) — OpenGL post-processing shader (CRT effect) applied to the back buffer
 
-### Game Modules
+### Game Modules (`source/game/`)
 
-- **ModuleSequence** (`modulesequence.cpp/h`) — Non-gameplay screens: intro, menu, slides, banners, credits, death screen. State machine entry point (state=1)
-- **ModuleGame** (`modulegame.cpp/h`) — Core gameplay loop. Owns and orchestrates all game objects. State=0
-- **Sprite** (`sprite.cpp/h`) — Base class for animated entities (frame/animation data via `Entitat`)
-- **Prota** (`prota.cpp/h`) — Player character ("Sam"), extends Sprite
-- **Mapa** (`mapa.cpp/h`) — Level map with tomb grid (16 tombs), items (treasure, keys, pharaoh, mummy, scroll, diamond), door logic
-- **Momia** (`momia.cpp/h`) — Enemy: mummies
-- **Bola** (`bola.cpp/h`) — Enemy: projectile ball
-- **Marcador** (`marcador.cpp/h`) — HUD/scoreboard
-- **info** (`info.cpp/h`) — Global game state namespace (room number, pyramid, money, diamonds, lives, etc.)
+- **ModuleSequence** — Non-gameplay screens: intro, menu, slides, banners, credits, death screen. State machine entry point (state=1)
+- **ModuleGame** — Core gameplay loop. Owns and orchestrates all game objects. State=0
+- **Sprite** — Base class for animated entities (frame/animation data via `Entitat`)
+- **Prota** — Player character ("Sam"), extends Sprite
+- **Mapa** — Level map with tomb grid (16 tombs), items (treasure, keys, pharaoh, mummy, scroll, diamond), door logic
+- **Momia** — Enemy: mummies
+- **Bola** — Enemy: projectile ball
+- **Marcador** — HUD/scoreboard
+- **info** — Global game state namespace (room number, pyramid, money, diamonds, lives, etc.)
 
-### Main Loop (`main.cpp`)
+### External Libraries (`source/external/`)
+
+- `gif.h` — Header-only GIF decoder
+- `stb_vorbis.h` — stb single-header OGG decoder
+
+### Main Loop (`source/main.cpp`)
 
 A state machine alternates between `ModuleSequence` (state 1) and `ModuleGame` (state 0). Each module's `Go()` returns the next state (-1 to quit). Modules are allocated/freed each transition.
 
@@ -57,4 +62,5 @@ A state machine alternates between `ModuleSequence` (state 1) and `ModuleGame` (
 - Graphics loaded from GIF files, palettes extracted from GIF headers
 - Music files are numbered OGG files (`00000001.ogg` etc.)
 - `trick.ini` presence enables the secret character
-- The `gif.h` is a header-only GIF decoder; `stb_vorbis.h` is the stb single-header OGG decoder
+- Includes use absolute paths from `source/` (e.g., `#include "core/jgame.hpp"`, `#include "game/info.hpp"`)
+- Headers use `.hpp` extension; external third-party headers in `source/external/` keep `.h`

CMakeLists.txt

@@ -12,23 +12,28 @@ set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
 
 # --- LISTA EXPLÍCITA DE FUENTES ---
 set(APP_SOURCES
+    # Core - Motor "Jail"
+    source/core/jail_audio.cpp
+    source/core/jdraw8.cpp
+    source/core/jfile.cpp
+    source/core/jgame.cpp
+    source/core/jinput.cpp
+    source/core/jshader.cpp
+
+    # Game
+    source/game/bola.cpp
+    source/game/engendro.cpp
+    source/game/info.cpp
+    source/game/mapa.cpp
+    source/game/marcador.cpp
+    source/game/modulegame.cpp
+    source/game/modulesequence.cpp
+    source/game/momia.cpp
+    source/game/prota.cpp
+    source/game/sprite.cpp
+
+    # Main
     source/main.cpp
-    source/bola.cpp
-    source/engendro.cpp
-    source/info.cpp
-    source/jail_audio.cpp
-    source/jdraw8.cpp
-    source/jfile.cpp
-    source/jgame.cpp
-    source/jinput.cpp
-    source/jshader.cpp
-    source/mapa.cpp
-    source/marcador.cpp
-    source/modulegame.cpp
-    source/modulesequence.cpp
-    source/momia.cpp
-    source/prota.cpp
-    source/sprite.cpp
 )
 
 # Configuración de SDL3

source/core/jail_audio.cpp

@@ -1,6 +1,6 @@
 #ifndef JA_USESDLMIXER
-#include "jail_audio.h"
-#include "stb_vorbis.h"
+#include "core/jail_audio.hpp"
+#include "external/stb_vorbis.h"
 #include <SDL3/SDL.h>
 #include <stdio.h>
 

source/core/jdraw8.cpp

@@ -1,8 +1,8 @@
-#include "jdraw8.h"
-#include "jfile.h"
+#include "core/jdraw8.hpp"
+#include "core/jfile.hpp"
 #include <fstream>
-#include "gif.h"
-#include "jshader.h"
+#include "external/gif.h"
+#include "core/jshader.hpp"
 
 #define SCREEN_WIDTH 960
 #define SCREEN_HEIGHT 720

source/core/jfile.cpp

@@ -2,7 +2,7 @@
 #include <string.h>
 #include <stdio.h>
 #include <stdint.h>
-#include "jfile.h"
+#include "core/jfile.hpp"
 #include <sys/stat.h>
 #include <unistd.h>
 #include <iostream>

source/core/jgame.cpp

@@ -1,4 +1,4 @@
-#include "jgame.h"
+#include "core/jgame.hpp"
 
 bool eixir = false;
 Uint32 updateTicks = 0;

source/core/jinput.cpp

@@ -1,5 +1,5 @@
-#include "jinput.h"
-#include "jgame.h"
+#include "core/jinput.hpp"
+#include "core/jgame.hpp"
 #include <string>
 
 const bool *keystates;// = SDL_GetKeyboardState( NULL );

source/core/jshader.cpp

@@ -1,4 +1,4 @@
-#include "jshader.h"
+#include "core/jshader.hpp"
 
 #include <iostream>
 

source/game/bola.cpp

@@ -1,5 +1,5 @@
-#include "bola.h"
-#include "jgame.h"
+#include "game/bola.hpp"
+#include "core/jgame.hpp"
 #include <stdlib.h>
 
 Bola::Bola( JD8_Surface gfx, Prota* sam ) : Sprite( gfx ) {

source/game/bola.hpp

@@ -1,8 +1,8 @@
 #pragma once
 
-#include "sprite.h"
-#include "prota.h"
-#include "info.h"
+#include "game/sprite.hpp"
+#include "game/prota.hpp"
+#include "game/info.hpp"
 
 class Bola : public Sprite {
 

source/game/engendro.cpp

@@ -1,5 +1,5 @@
-#include "engendro.h"
-#include "jgame.h"
+#include "game/engendro.hpp"
+#include "core/jgame.hpp"
 #include <stdlib.h>
 
 Engendro::Engendro( JD8_Surface gfx, Uint16 x, Uint16 y ) : Sprite( gfx ) {

source/game/engendro.hpp

@@ -1,6 +1,6 @@
 #pragma once
 
-#include "sprite.h"
+#include "game/sprite.hpp"
 
 class Engendro : public Sprite {
 

source/game/info.cpp

@@ -1,4 +1,4 @@
-#include "info.h"
+#include "game/info.hpp"
 
 namespace info
 {

source/game/mapa.cpp

@@ -1,7 +1,7 @@
-#include "mapa.h"
+#include "game/mapa.hpp"
 
-#include "jgame.h"
-#include "jinput.h"
+#include "core/jgame.hpp"
+#include "core/jinput.hpp"
 #include <stdlib.h>
 
 Mapa::Mapa( JD8_Surface gfx, Prota* sam ) {

source/game/mapa.hpp

@@ -1,9 +1,9 @@
 #pragma once
 
-#include "jdraw8.h"
+#include "core/jdraw8.hpp"
 
-#include "info.h"
-#include "prota.h"
+#include "game/info.hpp"
+#include "game/prota.hpp"
 
 #define CONTE_RES 0
 #define CONTE_TRESOR 1

source/game/marcador.cpp

@@ -1,4 +1,4 @@
-#include "marcador.h"
+#include "game/marcador.hpp"
 
 Marcador::Marcador( JD8_Surface gfx, Prota* sam ) {
 

source/game/marcador.hpp

@@ -1,8 +1,8 @@
 #pragma once
 
-#include "jdraw8.h"
-#include "info.h"
-#include "prota.h"
+#include "core/jdraw8.hpp"
+#include "game/info.hpp"
+#include "game/prota.hpp"
 
 class Marcador {
 

source/game/modulegame.cpp

@@ -1,10 +1,10 @@
-#include "modulegame.h"
+#include "game/modulegame.hpp"
 
-#include "jgame.h"
-#include "jdraw8.h"
-#include "jail_audio.h"
-#include "jinput.h"
-#include "jfile.h"
+#include "core/jgame.hpp"
+#include "core/jdraw8.hpp"
+#include "core/jail_audio.hpp"
+#include "core/jinput.hpp"
+#include "core/jfile.hpp"
 
 ModuleGame::ModuleGame() {
 

source/game/modulegame.hpp

@@ -1,11 +1,11 @@
 #pragma once
 
-#include "info.h"
-#include "mapa.h"
-#include "prota.h"
-#include "marcador.h"
-#include "momia.h"
-#include "bola.h"
+#include "game/info.hpp"
+#include "game/mapa.hpp"
+#include "game/prota.hpp"
+#include "game/marcador.hpp"
+#include "game/momia.hpp"
+#include "game/bola.hpp"
 
 class ModuleGame {
 

source/game/modulesequence.cpp

@@ -1,10 +1,10 @@
-#include "modulesequence.h"
+#include "game/modulesequence.hpp"
 
-#include "jgame.h"
-#include "jdraw8.h"
-#include "jinput.h"
-#include "jfile.h"
-#include "jail_audio.h"
+#include "core/jgame.hpp"
+#include "core/jdraw8.hpp"
+#include "core/jinput.hpp"
+#include "core/jfile.hpp"
+#include "core/jail_audio.hpp"
 #include <stdlib.h>
 #include <string>
 

source/game/modulesequence.hpp

@@ -1,6 +1,6 @@
 #pragma once
 
-#include "info.h"
+#include "game/info.hpp"
 
 class ModuleSequence {
 

source/game/momia.cpp

@@ -1,5 +1,5 @@
-#include "momia.h"
-#include "jgame.h"
+#include "game/momia.hpp"
+#include "core/jgame.hpp"
 #include <stdlib.h>
 
 Momia::Momia( JD8_Surface gfx, bool dimoni, Uint16 x, Uint16 y, Prota* sam ) : Sprite( gfx ) {

source/game/momia.hpp

@@ -1,9 +1,9 @@
 #pragma once
 
-#include "sprite.h"
-#include "prota.h"
-#include "engendro.h"
-#include "info.h"
+#include "game/sprite.hpp"
+#include "game/prota.hpp"
+#include "game/engendro.hpp"
+#include "game/info.hpp"
 
 class Momia : public Sprite {
 

source/game/prota.cpp

@@ -1,6 +1,6 @@
-#include "prota.h"
-#include "jgame.h"
-#include "jinput.h"
+#include "game/prota.hpp"
+#include "core/jgame.hpp"
+#include "core/jinput.hpp"
 #include <stdlib.h>
 
 Prota::Prota( JD8_Surface gfx ) : Sprite( gfx ) {

source/game/prota.hpp

@@ -1,7 +1,7 @@
 #pragma once
 
-#include "sprite.h"
-#include "info.h"
+#include "game/sprite.hpp"
+#include "game/info.hpp"
 
 class Prota : public Sprite {
 

source/game/sprite.cpp

@@ -1,4 +1,4 @@
-#include "sprite.h"
+#include "game/sprite.hpp"
 #include <stdlib.h>
 
 Sprite::Sprite( JD8_Surface gfx ) {

source/game/sprite.hpp

@@ -1,6 +1,6 @@
 #pragma once
 
-#include "jdraw8.h"
+#include "core/jdraw8.hpp"
 
 struct Frame {
 	Uint16 x;

source/main.cpp

@@ -1,11 +1,11 @@
-#include "jgame.h"
-#include "jdraw8.h"
-#include "jail_audio.h"
-#include "jfile.h"
-#include "info.h"
-#include "modulegame.h"
-#include "modulesequence.h"
-#include "time.h"
+#include "core/jgame.hpp"
+#include "core/jdraw8.hpp"
+#include "core/jail_audio.hpp"
+#include "core/jfile.hpp"
+#include "game/info.hpp"
+#include "game/modulegame.hpp"
+#include "game/modulesequence.hpp"
+#include <ctime>
 #include <string>
 
 /*