changelog.md

- ResourceList gestiona addAsset i removeAsset

.clang-format

@@ -0,0 +1,22 @@
+BasedOnStyle: Google
+IndentWidth: 4
+NamespaceIndentation: All
+IndentAccessModifiers: false
+ColumnLimit: 0  # Sin límite de longitud de línea
+BreakBeforeBraces: Attach  # Llaves en la misma línea
+AllowShortIfStatementsOnASingleLine: true
+AllowShortBlocksOnASingleLine: true
+AllowShortFunctionsOnASingleLine: All
+AlignOperands: DontAlign
+AlignAfterOpenBracket: DontAlign
+BinPackArguments: false
+BinPackParameters: false
+ContinuationIndentWidth: 4
+ConstructorInitializerIndentWidth: 4
+IndentWrappedFunctionNames: false
+Cpp11BracedListStyle: true
+BreakConstructorInitializers: BeforeColon
+AllowAllConstructorInitializersOnNextLine: false
+PackConstructorInitializers: Never
+AllowAllArgumentsOnNextLine: false
+AllowAllParametersOfDeclarationOnNextLine: false

.clang-tidy

@@ -0,0 +1,85 @@
+Checks:
+  - readability-*
+  - modernize-*
+  - performance-*
+  - bugprone-unchecked-optional-access
+  - bugprone-sizeof-expression
+  - bugprone-suspicious-missing-comma
+  - bugprone-suspicious-index
+  - bugprone-undefined-memory-manipulation
+  - bugprone-use-after-move
+  - bugprone-out-of-bound-access
+  - -readability-identifier-length
+  - -readability-magic-numbers
+  - -bugprone-narrowing-conversions
+  - -performance-enum-size
+  - -performance-inefficient-string-concatenation
+  - -bugprone-integer-division
+  - -bugprone-easily-swappable-parameters
+  - -modernize-avoid-c-arrays,-warnings-as-errors
+
+WarningsAsErrors: '*'
+# Solo incluir archivos de tu código fuente (external tiene su propio .clang-tidy)
+# Excluye jail_audio.hpp del análisis
+HeaderFilterRegex: 'source/(?!core/audio/jail_audio\.hpp|core/rendering/sdl3gpu/.*_spv\.h).*'
+FormatStyle: file
+
+CheckOptions:
+  # Variables locales en snake_case
+  - { key: readability-identifier-naming.VariableCase, value: lower_case }
+
+  # Miembros privados en snake_case con sufijo _
+  - { key: readability-identifier-naming.PrivateMemberCase, value: lower_case }
+  - { key: readability-identifier-naming.PrivateMemberSuffix, value: _ }
+
+  # Miembros protegidos en snake_case con sufijo _
+  - { key: readability-identifier-naming.ProtectedMemberCase, value: lower_case }
+  - { key: readability-identifier-naming.ProtectedMemberSuffix, value: _ }
+
+  # Miembros públicos en snake_case (sin sufijo)
+  - { key: readability-identifier-naming.PublicMemberCase, value: lower_case }
+
+  # Namespaces en CamelCase
+  - { key: readability-identifier-naming.NamespaceCase, value: CamelCase }
+
+  # Variables estáticas privadas como miembros privados
+  - { key: readability-identifier-naming.StaticVariableCase, value: lower_case }
+  - { key: readability-identifier-naming.StaticVariableSuffix, value: _ }
+  
+  # Constantes estáticas sin sufijo
+  - { key: readability-identifier-naming.StaticConstantCase, value: UPPER_CASE }
+
+  # Constantes globales en UPPER_CASE
+  - { key: readability-identifier-naming.GlobalConstantCase, value: UPPER_CASE }
+
+  # Variables constexpr globales en UPPER_CASE
+  - { key: readability-identifier-naming.ConstexprVariableCase, value: UPPER_CASE }
+
+  # Constantes locales en UPPER_CASE
+  - { key: readability-identifier-naming.LocalConstantCase, value: UPPER_CASE }
+
+  # Constexpr miembros en UPPER_CASE (sin sufijo)
+  - { key: readability-identifier-naming.ConstexprMemberCase, value: UPPER_CASE }
+
+  # Constexpr miembros privados/protegidos con sufijo _
+  - { key: readability-identifier-naming.ConstexprMethodCase, value: UPPER_CASE }
+
+  # Clases, structs y enums en CamelCase
+  - { key: readability-identifier-naming.ClassCase, value: CamelCase }
+  - { key: readability-identifier-naming.StructCase, value: CamelCase }
+  - { key: readability-identifier-naming.EnumCase, value: CamelCase }
+
+  # Valores de enums en UPPER_CASE
+  - { key: readability-identifier-naming.EnumConstantCase, value: UPPER_CASE }
+
+  # Métodos en camelBack (sin sufijos)
+  - { key: readability-identifier-naming.MethodCase, value: camelBack }
+  - { key: readability-identifier-naming.PrivateMethodCase, value: camelBack }
+  - { key: readability-identifier-naming.ProtectedMethodCase, value: camelBack }
+  - { key: readability-identifier-naming.PublicMethodCase, value: camelBack }
+
+  # Funciones en camelBack
+  - { key: readability-identifier-naming.FunctionCase, value: camelBack }
+
+  # Parámetros en lower_case
+  - { key: readability-identifier-naming.ParameterCase, value: lower_case }

.claude/commands/lint-clang-tidy.md

@@ -0,0 +1,172 @@
+---
+description: Ejecuta clang-tidy en archivos C++ y analiza los resultados
+---
+
+# Lint clang-tidy Command
+
+Ejecuta análisis estático con clang-tidy en archivos C++ específicos, analiza los resultados inteligentemente, e identifica issues reales vs falsos positivos.
+
+## Propósito
+
+clang-tidy detecta:
+- Oportunidades de modernización C++ (auto, range-for, etc.)
+- Problemas de legibilidad del código
+- Potenciales bugs y memory leaks
+- Optimizaciones de performance
+- Violaciones de mejores prácticas
+
+## Workflow de Ejecución
+
+1. **Solicitar archivos al usuario** (si no se especifican)
+   - Pedir rutas de archivos `.cpp` o `.hpp` a analizar
+   - Validar que los archivos existen
+
+2. **Verificar build directory**
+   - Confirmar que `build/compile_commands.json` existe
+   - Si no existe, informar al usuario que debe compilar primero
+
+3. **Ejecutar clang-tidy (sin --fix)**
+   ```bash
+   tools/linter/run_clang-tidy.sh archivo1.cpp archivo2.hpp
+   ```
+
+4. **Capturar y analizar salida**
+   - Parsear mensajes de error/warning
+   - Clasificar por categoría (modernize, readability, performance, bugprone, etc.)
+   - Identificar falsos positivos conocidos
+
+5. **Presentar resumen al usuario**
+   - Agrupar por tipo de issue
+   - Separar "Críticos" vs "Recomendaciones" vs "Falsos Positivos"
+   - Mostrar líneas de código afectadas con contexto
+
+6. **Ofrecer acciones**
+   - Preguntar si aplicar `--fix` automáticamente
+   - Si el usuario acepta, ejecutar con `--fix` y recompilar
+
+## Falsos Positivos Conocidos
+
+Ignorar o marcar como "Opcional" estos casos:
+
+### `readability-magic-numbers` / `cppcoreguidelines-avoid-magic-numbers`
+- **Contexto:** Game constants (block sizes, velocities, timers)
+- **Ejemplo:** `const int BLOCK = 16;`, `player.vx = 3.0F;`
+- **Acción:** Marcar como "Opcional - Game constant"
+
+### `modernize-use-trailing-return-type`
+- **Contexto:** Funciones con tipos de retorno simples
+- **Ejemplo:** `int getValue() { return x_; }`
+- **Acción:** Marcar como "Opcional - Style preference"
+
+### Errores en `defaults.hpp`
+- **Contexto:** Archivos de constantes del juego
+- **Acción:** Ignorar completamente, mencionar al usuario que es conocido
+
+### `readability-identifier-length`
+- **Contexto:** Variables cortas comunes en loops o coordenadas (`x`, `y`, `i`, `j`)
+- **Acción:** Marcar como "Opcional - Common convention"
+
+## Categorización de Issues
+
+### 🔴 Críticos (Requieren atención)
+- `bugprone-*`: Potenciales bugs
+- `cert-*`: Security issues
+- Memory leaks y null pointer dereferences
+- Undefined behavior
+
+### 🟡 Recomendados (Mejoran calidad)
+- `modernize-*`: C++20 modernization
+- `performance-*`: Optimizaciones
+- `readability-*`: Mejoras de legibilidad (excepto magic-numbers)
+
+### ⚪ Opcionales (A criterio)
+- `readability-magic-numbers` en game constants
+- `modernize-use-trailing-return-type`
+- `readability-identifier-length` para `x`, `y`, `i`, `j`
+
+### ⚫ Ignorar (Falsos positivos)
+- Errores en `defaults.hpp`
+- Issues en carpeta `external/`
+- Warnings en headers del sistema
+
+## Formato de Reporte al Usuario
+
+```
+=== clang-tidy Analysis Results ===
+
+📁 Archivos analizados:
+  - source/game/entities/player.cpp
+  - source/game/entities/player.hpp
+
+🔴 Críticos (2):
+  player.cpp:145 [bugprone-use-after-move] - Uso de variable después de std::move()
+  player.cpp:230 [cert-err58-cpp] - Excepción en inicialización estática
+
+🟡 Recomendados (5):
+  player.cpp:67 [modernize-use-auto] - Puede usar 'auto' en lugar de tipo explícito
+  player.cpp:102 [performance-unnecessary-copy-initialization] - Copia innecesaria
+  player.hpp:23 [readability-redundant-access-specifiers] - Especificador de acceso redundante
+
+⚪ Opcionales (3):
+  player.cpp:88 [readability-magic-numbers] - Magic number '16' (Game constant: BLOCK size)
+  player.cpp:120 [modernize-use-trailing-return-type] - Style preference
+
+✅ Total: 10 issues (2 críticos, 5 recomendados, 3 opcionales)
+
+---
+
+💡 Recomendaciones:
+1. Corregir los 2 issues críticos manualmente
+2. Aplicar --fix para 5 recomendaciones (revisa cambios antes de commitear)
+3. Los opcionales son aceptables en código de juego
+
+¿Deseas aplicar fixes automáticos para los issues recomendados? (y/n)
+```
+
+## Aplicar Fixes Automáticos
+
+Si el usuario acepta:
+
+1. **Ejecutar con --fix**
+   ```bash
+   tools/linter/run_clang-tidy.sh --fix archivo1.cpp archivo2.hpp
+   ```
+
+2. **Informar cambios**
+   - Listar archivos modificados
+   - Recomendar revisión manual
+
+3. **Recompilar**
+   ```bash
+   cmake --build build
+   ```
+
+4. **Verificar compilación exitosa**
+   - Si falla, informar errores
+   - Sugerir revertir cambios si es necesario
+
+## Notas Importantes
+
+- **Siempre analizar sin --fix primero** para revisar cambios propuestos
+- **Requiere build/compile_commands.json** - el usuario debe haber compilado antes
+- **Contexto importa** - Game code tiene patrones legítimos que linters marcan como issues
+- **No aplicar --fix ciegamente** - Algunos fixes pueden romper lógica del juego
+- **Archivos específicos** - Siempre analizar archivos concretos, no todo el proyecto
+
+## Integración con Otros Comandos
+
+Este comando puede ser llamado desde:
+- `/refactor-class` - Después de refactorizar una clase
+- Manualmente por el usuario para análisis ad-hoc
+- Antes de commits importantes
+
+---
+
+**Uso:**
+```
+/lint-clang-tidy
+(El comando preguntará qué archivos analizar)
+
+O especificar directamente:
+/lint-clang-tidy source/game/entities/player.cpp
+```

.claude/commands/lint-cppcheck.md

@@ -0,0 +1,275 @@
+---
+description: Ejecuta cppcheck en código C++ y analiza resultados
+---
+
+# Lint cppcheck Command
+
+Ejecuta análisis estático con cppcheck en código C++, filtra noise, e identifica issues reales relacionados con bugs, memory safety y undefined behavior.
+
+## Propósito
+
+cppcheck detecta:
+- Memory leaks y resource leaks
+- Null pointer dereferences
+- Buffer overflows y array bounds issues
+- Uninitialized variables
+- Dead code y unused functions
+- Style issues y code smells
+- Undefined behavior
+
+## Workflow de Ejecución
+
+1. **Solicitar archivos/rutas al usuario** (si no se especifican)
+   - Pedir rutas de archivos `.cpp`/`.hpp` o carpetas a analizar
+   - Preguntar nivel de análisis (warning/all/unused)
+   - Default: `-w` (warning, style, performance)
+
+2. **Validar precondiciones**
+   - Confirmar que los archivos/carpetas existen
+   - Si no existe `build/compile_commands.json`, el script lo generará automáticamente
+
+3. **Ejecutar cppcheck**
+   ```bash
+   # Para archivo específico
+   tools/linter/run_cppcheck.sh -w --path source/game/entities/player.cpp
+
+   # Para carpeta
+   tools/linter/run_cppcheck.sh -w --path source/game/entities/
+
+   # Proyecto completo (LENTO)
+   tools/linter/run_cppcheck.sh -w
+   ```
+
+4. **Leer archivo de resultados**
+   - `-w`: `tools/linter/cppcheck-result-warning-style-performance.txt`
+   - `-a`: `tools/linter/cppcheck-result-all.txt`
+   - `-u`: `tools/linter/cppcheck-result-unusedFunction.txt`
+
+5. **Analizar y clasificar issues**
+   - Parsear formato de cppcheck: `[archivo:línea]: (severidad) mensaje`
+   - Filtrar falsos positivos conocidos
+   - Agrupar por categoría
+
+6. **Presentar resumen al usuario**
+   - Mostrar issues críticos primero
+   - Explicar contexto cuando sea relevante
+   - Sugerir acciones correctivas
+
+## Niveles de Análisis
+
+### `-w` / `--warning` (Recomendado para uso diario)
+- **Velocidad:** Rápido
+- **Checks:** warning, style, performance
+- **Uso:** Refactoring diario, antes de commits
+- **Ejemplo:** `tools/linter/run_cppcheck.sh -w --path source/game/entities/player.cpp`
+
+### `-a` / `--all` (Análisis exhaustivo)
+- **Velocidad:** Lento
+- **Checks:** Todos los checks disponibles
+- **Uso:** Después de cambios mayores, auditorías de código
+- **Ejemplo:** `tools/linter/run_cppcheck.sh -a --path source/game/`
+
+### `-u` / `--unused` (Funciones no usadas)
+- **Velocidad:** Medio
+- **Checks:** unusedFunction
+- **Uso:** Limpieza de código muerto
+- **Ejemplo:** `tools/linter/run_cppcheck.sh -u`
+- **Nota:** Requiere análisis de proyecto completo
+
+## Falsos Positivos Conocidos
+
+### `unusedFunction` en métodos públicos
+- **Contexto:** Métodos de API pública, callbacks, getters/setters
+- **Ejemplo:** `Player::getX()` usado desde múltiples lugares
+- **Acción:** Ignorar si el método es parte de la interfaz pública
+
+### `passedByValue` para tipos pequeños
+- **Contexto:** SDL_FRect, SDL_Point, enums, small structs
+- **Ejemplo:** `void setPos(SDL_FPoint pos)`
+- **Acción:** Aceptable para tipos ≤ 16 bytes en game code
+
+### `constParameter` en APIs consistentes
+- **Contexto:** Parámetros que no se modifican pero mantienen consistencia de API
+- **Acción:** Opcional, depende de estilo del proyecto
+
+### `variableScope` en inicializaciones complejas
+- **Contexto:** Variables declaradas antes de inicialización compleja
+- **Acción:** Revisar caso por caso, puede ser falso positivo
+
+## Categorización de Issues
+
+### 🔴 Críticos (Requieren corrección inmediata)
+- `error`: Bugs confirmados
+- `memleakOnRealloc`: Memory leaks
+- `nullPointer`: Null pointer dereferences
+- `bufferAccessOutOfBounds`: Buffer overflows
+- `uninitvar`: Variables no inicializadas
+- `useAfterFree`: Use-after-free
+
+### 🟠 Advertencias (Revisar y corregir)
+- `warning`: Potenciales problemas
+- `memleak`: Posibles memory leaks
+- `resourceLeak`: Resource leaks (file handles, etc.)
+- `doubleFree`: Double free
+- `arrayIndexOutOfBounds`: Array bounds issues
+
+### 🟡 Estilo (Mejoran calidad)
+- `style`: Code smells
+- `unusedVariable`: Variables no usadas
+- `redundantAssignment`: Asignaciones redundantes
+- `unreadVariable`: Variables escritas pero no leídas
+
+### 🟢 Performance (Optimizaciones)
+- `performance`: Optimizaciones de rendimiento
+- `passedByValue`: Pasar por const& en vez de value
+- `postfixOperator`: Usar prefix++ en vez de postfix++
+
+### ⚪ Informativo (Opcional)
+- `information`: Información general
+- `portability`: Problemas de portabilidad
+- `unusedFunction`: Funciones no usadas (revisar contexto)
+
+## Formato de Reporte al Usuario
+
+```
+=== cppcheck Analysis Results ===
+
+📁 Archivos analizados: source/game/entities/player.cpp
+📊 Nivel: warning + style + performance
+📝 Resultados: tools/linter/cppcheck-result-warning-style-performance.txt
+
+🔴 Errores críticos (2):
+  player.cpp:156 [error:uninitvar] - Variable 'velocity' no inicializada
+  player.cpp:234 [error:nullPointer] - Posible null pointer dereference
+
+🟠 Advertencias (3):
+  player.cpp:89 [warning:memleak] - Posible memory leak en 'sprite_'
+  player.cpp:178 [warning:arrayIndexOutOfBounds] - Índice fuera de límites
+
+🟡 Estilo (4):
+  player.cpp:45 [style:unusedVariable] - Variable 'temp' declarada pero no usada
+  player.cpp:102 [style:redundantAssignment] - Asignación redundante a 'x_'
+
+🟢 Performance (2):
+  player.cpp:67 [performance:passedByValue] - Pasar 'data' por const& (8 bytes - FALSO POSITIVO)
+  player.hpp:34 [performance:postfixOperator] - Usar prefix++ en lugar de postfix++
+
+✅ Total: 11 issues
+   - 2 críticos ❗
+   - 3 advertencias
+   - 4 estilo
+   - 2 performance (1 falso positivo)
+
+---
+
+💡 Acción requerida:
+1. ✅ Corregir 2 errores críticos INMEDIATAMENTE
+2. ⚠️  Revisar 3 advertencias y corregir si aplica
+3. 🔧 Considerar 4 mejoras de estilo
+4. ⚡ 1 optimización real de performance (ignorar passedByValue)
+
+📄 Detalles completos en: tools/linter/cppcheck-result-warning-style-performance.txt
+```
+
+## Acciones Post-Análisis
+
+### Si hay errores críticos:
+1. **Mostrar código afectado** con contexto
+2. **Explicar el problema** en términos claros
+3. **Sugerir corrección** específica
+4. **Ofrecer aplicar fix** si es sencillo
+
+### Si solo hay warnings/style:
+1. **Resumir issues** por categoría
+2. **Indicar prioridades** (qué corregir primero)
+3. **Explicar falsos positivos** identificados
+4. **Preguntar si aplicar fixes** para issues simples
+
+### Si no hay issues:
+```
+✅ ¡Código limpio! No se encontraron issues.
+```
+
+## Ejemplos de Correcciones Comunes
+
+### Uninitialized variable
+```cpp
+// ❌ Antes
+int velocity;
+if (condition) {
+    velocity = 10;
+}
+use(velocity);  // Error: puede estar no inicializada
+
+// ✅ Después
+int velocity{0};  // Inicializar en declaración
+if (condition) {
+    velocity = 10;
+}
+use(velocity);
+```
+
+### Memory leak
+```cpp
+// ❌ Antes
+void loadTexture() {
+    texture_ = new SDL_Texture(...);
+    if (error) return;  // Leak si hay error después
+}
+
+// ✅ Después
+void loadTexture() {
+    auto temp = std::make_unique<SDL_Texture>(...)
+    if (error) return;  // RAII - se libera automáticamente
+    texture_ = std::move(temp);
+}
+```
+
+### Null pointer dereference
+```cpp
+// ❌ Antes
+Player* player = getPlayer();
+player->update();  // Puede ser nullptr
+
+// ✅ Después
+Player* player = getPlayer();
+if (player != nullptr) {
+    player->update();
+}
+```
+
+## Integración con Workflow
+
+### Cuándo ejecutar:
+
+1. **Después de refactoring** - Verificar que no se introdujeron bugs
+2. **Antes de commit** - Análisis `-w` rápido
+3. **Antes de PR** - Análisis `-a` completo
+4. **Periódicamente** - Análisis `-u` para limpieza de código
+
+### Integración con `/refactor-class`:
+
+El comando `/refactor-class` ejecuta automáticamente:
+```bash
+tools/linter/run_cppcheck.sh -w --path <archivo_refactorizado>
+```
+
+## Notas Importantes
+
+- **Genera archivos de salida** en `tools/linter/cppcheck-result-*.txt`
+- **Auto-genera compile_commands.json** si no existe
+- **Paralelización automática** usa N-1 cores
+- **Suppressions file** excluye external/ y system headers
+- **Contexto importa** - Revisar falsos positivos manualmente
+- **No modifica código** - Solo reporta, no aplica fixes automáticos
+
+---
+
+**Uso:**
+```
+/lint-cppcheck
+(El comando preguntará qué analizar y qué nivel usar)
+
+O especificar directamente:
+/lint-cppcheck source/game/entities/player.cpp
+```

.claude/commands/refactor-class.md

@@ -0,0 +1,279 @@
+---
+description: Refactoriza una clase C++ aplicando buenas prácticas de estilo
+---
+
+# Refactor Class Command
+
+Refactoriza una clase C++ siguiendo estas reglas de estilo y buenas prácticas:
+
+## Reglas de Refactorización
+
+### 1. Inicialización de Variables Miembro
+- **Inicializar en la declaración** todas las variables "simples" que no tengan dependencias complejas:
+  - Tipos primitivos: `int`, `float`, `bool`, etc.
+  - Enumeraciones: valores de enum class
+  - Valores por defecto conocidos: `0`, `0.0F`, `false`, `nullptr`, etc.
+- **NO inicializar en declaración** si:
+  - Dependen de otros miembros
+  - Requieren llamadas a funciones complejas
+  - Son punteros a recursos que necesitan construcción específica
+
+### 2. Structs con Valores por Defecto
+- **Todos los miembros de structs** deben tener valores por defecto:
+  - Tipos primitivos: `int x{0}`, `float y{0.0F}`, `bool flag{false}`
+  - Strings: `std::string name{}`
+  - Punteros: `Type* ptr{nullptr}`
+- **Ventajas**: Inicialización segura, evita valores indefinidos
+
+### 3. Arrays C-style → std::array
+- Convertir **todos** los arrays C-style a `std::array`:
+  - `Type array[N]` → `std::array<Type, N> array{}`
+  - Inicializar con `{}` para zero-initialization
+- Agregar `#include <array>` si no existe
+- **Ventajas**: type-safety, size(), métodos STL, sin decay a pointer
+
+### 3. Reorganización de la Clase
+
+#### Orden de Secciones
+1. **public** (primero)
+2. **private** (después)
+
+#### Dentro de cada sección (private principalmente)
+1. **Estructuras y enumeraciones** (tipos anidados)
+2. **Constantes** (static constexpr)
+3. **Métodos** (funciones miembro)
+4. **Variables miembro** (al final)
+
+### 4. Agrupación y Comentarios de Métodos
+- **En sección public**: Agrupar métodos relacionados funcionalmente
+- **Comentarios en línea** (a la derecha) para describir cada método/grupo
+- **Formato**: `void method();  // Descripción concisa`
+- **Espaciado**: Línea en blanco entre grupos funcionales
+
+**Ejemplo:**
+```cpp
+public:
+    static void init(...);    // Inicialización singleton
+    static void destroy();    // Destrucción singleton
+    static auto get() -> T*;  // Acceso al singleton
+
+    void render();            // Renderizado
+    void update(float dt);    // Actualización lógica
+
+    auto isActive() -> bool;  // Consulta estado
+```
+
+### 5. Comentarios de Variables
+- **Posición**: A la derecha de la variable/grupo
+- **Formato**: `// Descripción concisa`
+- Agrupar variables relacionadas con un comentario común
+
+### 6. Constructores en Structs
+- **Eliminar constructores por defecto redundantes** en structs:
+  - Si todos los miembros tienen inicialización en declaración
+  - Y no hay múltiples constructores
+  - Eliminar `explicit Type() = default;`
+- El compilador generará automáticamente un constructor por defecto
+
+**Ejemplo:**
+```cpp
+struct Data {
+    int x{0};
+    std::string name{};
+    // NO NECESITA: explicit Data() = default;
+};
+```
+
+### 7. Includes Necesarios
+- Agregar includes faltantes según lo que se use
+- Mantener orden alfabético si es posible
+
+### 8. Header Guards
+- **Usar `#pragma once`** en todas las cabeceras (`.hpp`)
+- **NO usar** `#ifndef`/`#define`/`#endif` tradicionales
+- `#pragma once` debe ser la primera línea del archivo (antes de includes)
+- **Ventajas**: Más simple, menos propenso a errores, ampliamente soportado
+
+## Ejemplo de Aplicación
+
+### Antes:
+```cpp
+class Example {
+    private:
+        struct Data {
+            std::string name;
+            int value;
+        };
+
+        int counter_;
+        bool flag_;
+        float values_[10];
+
+    public:
+        Example();
+        void update();
+};
+
+// Constructor
+Example::Example()
+    : counter_(0),
+      flag_(false) {
+    for (int i = 0; i < 10; ++i) {
+        values_[i] = 0.0F;
+    }
+}
+```
+
+### Después:
+```cpp
+#pragma once
+
+#include <array>
+
+class Example {
+    public:
+        Example() = default;  // Ya no necesita inicializar
+        void update();
+
+    private:
+        // Tipos anidados
+        struct Data {
+            std::string name{};    // Nombre con valor por defecto
+            int value{0};          // Valor inicializado
+        };
+
+        // Variables miembro
+        int counter_{0};                        // Contador de frames
+        bool flag_{false};                      // Estado activo
+        std::array<float, 10> values_{};        // Buffer de valores
+};
+```
+
+## Tareas a Realizar
+
+Cuando uses este comando en una clase específica:
+
+1. **Leer** el archivo `.hpp` y `.cpp` correspondiente
+2. **Verificar** que la cabecera use `#pragma once` (reemplazar `#ifndef`/`#define`/`#endif` si existen)
+3. **Identificar** structs y agregar valores por defecto a todos sus miembros
+4. **Identificar** variables que pueden inicializarse en declaración
+5. **Identificar** arrays C-style que convertir a std::array
+6. **Reorganizar** la estructura de la clase (public/private, agrupación)
+7. **Actualizar** el archivo `.cpp` eliminando inicializaciones redundantes
+8. **Compilar** para verificar sintaxis correcta
+9. **Ejecutar clang-tidy** (análisis, sin --fix) y revisar resultados
+10. **Ejecutar cppcheck** (nivel -w) y revisar resultados
+11. **Aplicar fixes apropiados** basados en análisis de linters
+12. **Recompilar** si se aplicaron fixes
+13. **Reportar resumen** al usuario: cambios + hallazgos de linters
+
+## Workflow de Linters (Pasos 9-12)
+
+### Paso 9: Ejecutar clang-tidy
+
+```bash
+tools/linter/run_clang-tidy.sh archivo.cpp archivo.hpp
+```
+
+**Analizar resultados:**
+- Identificar issues críticos (bugprone, cert)
+- Separar recomendaciones válidas de falsos positivos
+- Ignorar: magic-numbers en game constants, defaults.hpp errors
+- Si hay issues críticos, informar al usuario y pausar
+- Si solo hay recomendaciones, continuar
+
+### Paso 10: Ejecutar cppcheck
+
+```bash
+tools/linter/run_cppcheck.sh -w --path archivo.cpp
+```
+
+**Leer archivo de resultados:**
+- `tools/linter/cppcheck-result-warning-style-performance.txt`
+- Identificar errores críticos (error, nullPointer, uninitvar)
+- Separar warnings de style issues
+- Filtrar falsos positivos (passedByValue para tipos pequeños, unusedFunction en API pública)
+- Si hay errores críticos, informar al usuario y pausar
+
+### Paso 11: Aplicar Fixes
+
+**Si hay issues aplicables:**
+
+1. **Fixes automáticos de clang-tidy** (solo si son seguros):
+   - modernize-use-auto
+   - readability-redundant-access-specifiers
+   - Performance optimizations claras
+
+   ```bash
+   tools/linter/run_clang-tidy.sh --fix archivo.cpp archivo.hpp
+   ```
+
+2. **Fixes manuales necesarios:**
+   - Inicializar variables no inicializadas
+   - Corregir null pointer issues
+   - Resolver memory leaks
+
+3. **Documentar cambios** para el reporte final
+
+### Paso 12: Recompilar
+
+Si se aplicaron fixes en paso 11:
+
+```bash
+cmake --build build
+```
+
+**Verificar:**
+- ✅ Compilación exitosa → Continuar a reporte
+- ❌ Errores → Informar al usuario, sugerir revisión manual
+
+## Formato de Reporte Final (Paso 13)
+
+```
+=== Refactor Completado: ClassName ===
+
+📝 Cambios estructurales:
+  ✅ #pragma once aplicado
+  ✅ 3 structs actualizados con valores por defecto
+  ✅ 12 variables movidas a inicialización en declaración
+  ✅ 2 arrays C-style → std::array
+  ✅ Clase reorganizada (public primero, variables al final)
+  ✅ Constructor simplificado (elimina 12 inicializaciones redundantes)
+
+🔍 Análisis de linters:
+
+clang-tidy:
+  ✅ Sin issues críticos
+  🟡 3 recomendaciones aplicadas automáticamente:
+     - Modernize: use auto (2 lugares)
+     - Readability: redundant specifier (1 lugar)
+  ⚪ 2 opcionales ignorados:
+     - magic-numbers en game constants
+
+cppcheck:
+  ✅ Sin errores
+  🟡 2 style issues encontrados:
+     - Unused variable 'temp' en línea 45 → Eliminada
+     - Redundant assignment en línea 102 → Corregida
+
+📊 Resultado:
+  ✅ Compilación exitosa
+  ✅ Todos los linters pasan sin issues críticos
+  ✅ Código refactorizado y verificado
+
+💡 Próximos pasos:
+  - Revisar cambios manualmente
+  - Ejecutar tests si existen
+  - Commitear con mensaje descriptivo
+```
+
+## Notas Importantes
+
+- **No cambiar lógica**: Solo refactorización estructural
+- **Mantener compatibilidad**: std::array usa misma sintaxis [] para acceso
+- **Formato consistente**: Respetar estilo del proyecto (comentarios, espaciado)
+- **Validar compilación**: Siempre verificar que compile después de cambios
+- **Linters integrados**: Análisis automático post-refactor para garantizar calidad
+- **Fixes inteligentes**: Solo aplicar --fix de clang-tidy si los cambios son seguros
+- **Contexto importa**: Game code tiene patrones legítimos (magic numbers, etc.)
+- **Falsos positivos**: Identificar y documentar, no corregir ciegamente

.gitignore

@@ -1,5 +1,6 @@
-.vscode
+.cache/
-*data/config/config.txt
+
+*data/config/config.yaml
 *stats.txt
 *.DS_Store
 thumbs.db
@@ -11,8 +12,17 @@ thumbs.db
 *.zip
 *.app
 *_debug*
-sync_jail_engine.sh
 jaildoctors_dilemma*
 todo
 build/
-linux_utils/
+linux_utils/
+source/version.h
+resources.pack
+jdd_release/
+tools/pack_resources/pack_resources
+tools/pack_resources/pack_resources.exe
+tools/pack_resources/pack_tool
+tools/pack_resources/pack_tool.exe
+*.res
+dist/
+.claude/settings.local.json

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "C_Cpp.default.compileCommands": "${workspaceFolder}/build/compile_commands.json"
+}

BUILDING.md

@@ -0,0 +1,78 @@
+# Compilar JailDoctor's Dilemma
+
+## Linux (Debian/Ubuntu)
+
+Instal·la les dependències:
+
+```bash
+sudo apt install cmake make g++ xxd glslang-tools glslc
+```
+
+Per a SDL3, instal·la el paquet de desenvolupament si està disponible al teu repositori:
+
+```bash
+sudo apt install libsdl3-dev
+```
+
+Si `libsdl3-dev` no està als repos (SDL3 és recent i pot no estar a Debian stable), compila'l des del codi font:
+
+```bash
+git clone https://github.com/libsdl-org/SDL.git --branch release-3.x --depth 1
+cd SDL && cmake -B build && cmake --build build && sudo cmake --install build
+```
+
+Compila el joc:
+
+```bash
+cmake -B build
+cmake --build build
+```
+
+---
+
+## Windows (MinGW via WinLibs)
+
+1. Instal·la [WinLibs](https://winlibs.com/) (MinGW-w64 amb GCC)
+2. Instal·la [CMake](https://cmake.org/download/)
+3. Descarrega les [biblioteques de desenvolupament de SDL3 per a MinGW](https://github.com/libsdl-org/SDL/releases) — copia les capçaleres a `include/` i els fitxers `.a` a `lib/` de MinGW
+4. Instal·la el [Vulkan SDK](https://vulkan.lunarg.com/sdk/home) — proporciona `glslc` per a la compilació dels shaders
+
+Compila el joc (des d'un terminal MinGW):
+
+```bash
+cmake -B build -G "MinGW Makefiles"
+cmake --build build
+```
+
+---
+
+## macOS
+
+Instal·la les dependències amb [Homebrew](https://brew.sh):
+
+```bash
+brew install cmake sdl3 glslang
+```
+
+Compila el joc:
+
+```bash
+cmake -B build
+cmake --build build
+```
+
+---
+
+## Què fa la compilació
+
+`cmake --build build` ho gestiona tot en ordre:
+
+1. **Compila els shaders** — regenera `postfx_vert_spv.h` / `postfx_frag_spv.h` si els fitxers `.vert` o `.frag` han canviat (requereix `glslc`)
+2. **Compila el joc** — només recompila els fitxers `.cpp` modificats
+3. **Empaqueta els recursos** — regenera `resources.pack` des de `data/` si algun asset ha canviat
+
+Si `glslc` no està instal·lat, s'utilitzen les capçaleres de shaders precompilades (incloses al repositori).
+
+> **Nota:** El `file(GLOB_RECURSE)` sobre `data/` s'avalua en temps de configuració de CMake. Si **afegeixes un fitxer nou** a `data/`, executa `cmake -B build` de nou perquè CMake el detecte com a dependència.
+
+L'executable es genera a l'arrel del projecte: `./jaildoctors_dilemma`

CHANGELOG.md

@@ -0,0 +1,204 @@
+# Changelog
+
+Tots els canvis notables de JailDoctor's Dilemma es documenten ací.
+
+---
+
+## [v1.13] - 2026-04-03
+
+### Novetats
+- **Editor de mapes (mode debug):** editor complet de nivells integrat en el joc
+  - Drag & drop de jugador, enemics, boundaries i ítems
+  - Editor de tiles amb TilePicker (amb spacing_in i spacing_out)
+  - Edició de propietats d'enemics i d'habitacions
+  - MiniMapa amb visualització de tiles i càlcul correcte de minipíxels
+  - Rejilla configurable
+  - Navegació entre habitacions (left, right, up, down)
+  - Guardat automàtic dels canvis en l'habitació
+  - Creació i eliminació d'habitacions
+  - Nova font específica per a l'editor
+  - Opcions persistents de l'editor
+  - Tecla 9 per a entrar i eixir de l'editor
+  - Al eixir de l'editor, recarrega l'habitació amb els canvis
+  - Mostra les rutes dels enemics
+  - RoomSaver millorat (ja no corromp els fitxers YAML)
+  - Status bar de l'editor reorganitzada
+- **Àmbits en la consola:** filtratge de comandos per mode (editor, debug, global)
+- **Nou format per a assets.yaml:** ResourceList gestiona addAsset i removeAsset
+- Eliminats fitxers sobrants de frameworks
+- Arreglos en stats.cpp
+- Posat un poc d'ordre en els comandos de la consola
+
+### Correccions
+- Fix: bug que feia que en l'editor, al canviar d'habitació el renderInfo tornara a eixir
+- Fix: faltava propietat mirror en els enemics
+- Fix: al fer clic es tanca la consola
+- Arreglat el càlcul dels minipíxels en els tiles amb transparent
+- Verificació que l'habitació de debug.yaml existisca
+
+---
+
+## [v1.12] - 2026-04-02
+
+### Novetats
+- **Color del jugador configurable:** es pot canviar des de la consola (persistent), amb comprovació automàtica per a evitar que coincidisca amb el color de fons
+- **Skins d'enemics per al jugador:** possibilitat d'utilitzar skins d'enemics en el jugador, amb canvi en calent en el marcador
+- **Indicador de trucs millorat:** ja no gasta el color del jugador, ara es mostra al marcador
+- **Shader presets per nom:** es pot establir un shader preset directament per nom des de la consola, amb autocompletat
+- **Comandos externs en consola:** la consola llig els comandos des d'un fitxer extern
+- **Gestió de paletes millorada:**
+  - Noves paletes afegides
+  - Restaurat l'ordre original de les paletes
+  - Opció de reordenar paletes automàticament per luminositat o paregut a la paleta d'Spectrum
+  - Noms "pretty" per a les paletes (canvia els `-` per ` `)
+  - Eliminades responsabilitats d'`Options` sobre les paletes
+  - Nova ferramenta en Python per a reordenar paletes
+- **Acceleració hardware configurable:** possibilitat de desactivar l'acceleració hardware des del fitxer de configuració; si no hi ha acceleració, es deshabiliten tecles i comandos de shaders
+- **Autocompletat millorat:** shader preset i palette autocompleten amb la llista de noms
+- Reestructuració de comandos de consola
+- Reestructuració de l'apartat de vídeo en `config.yaml`
+- Optimitzacions en `Surface`
+
+### Correccions
+- Fix: entrar i eixir del mode debug manté l'estat previ del jugador
+- Corregit Makefile: migració completa a cmake, detecció automàtica de SO per a release
+
+---
+
+## [v1.11] - 2026-03-31
+
+### Novetats
+- **PaletteManager:** refactorització de `Screen`, responsabilitats de gestió de paletes extretes a classe pròpia
+- **Consola 2.1:** la consola pot canviar de paleta per nom (`Screen` torna llista de paletes)
+- **Zoom configurable:** `Screen` permet establir el nivell de zoom directament des de la consola
+- **Autocompletar en consola:** autocompletat de comandos amb Tab (incloent suport per a armadura de lagarto)
+- Generació automàtica de taula de tab-completions en la consola
+
+### Correccions
+- Fix: al entrar a GAME amb la consola oberta, el jugador no tenia els inputs deshabilitats
+- Fix: al fer restart amb la música de l'attract mode sonant, la música no parava al anar al logo
+- Fix: en mode debug, protecció per a que el jugador no caiga infinitament si ix de la pantalla
+- Corregit el case en algunes respostes de la consola
+- Corregit Makefile
+
+---
+
+## [v1.10] - 2026-03-30
+
+### Novetats
+- **Consola 2.0:** redisseny complet de la consola de desenvolupador
+  - Efecte typewriter al mostrar text
+  - Separació de línies automàtica
+  - Canvi de skin
+  - Historial i navegació millorada
+  - Comandos per a cheats, control d'escena, debug, àudio i shaders
+  - Tecles de funció operatives amb la consola oberta
+  - Límit de caràcters ampliat
+  - La consola ja no pausa al jugador
+  - Reorganització del sistema de comandos i aliases (`show info`, `hide info`, etc.)
+- **RenderInfo:** nova classe amb animació per a mostrar info de renderitzat en pantalla
+- **Suport multi-shader:** comandos i tecles per a manejar el nou disseny de shaders (SPIRV/SPIR-V)
+- **Mode kiosc:** defaults i restriccions de comandos per a mode kiosc
+- **Supersampling Lanczos:** implementació d'escalat Lanczos en el supersampling
+- **Driver GPU configurable:** permet triar driver de GPU o cap des de la consola
+- Cheats accessibles des de la consola
+- Canvi i reinici d'escena des de la consola
+- Posició i habitació inicial de debug configurables des de la consola i fitxer
+- `Debug` carrega posició i habitació inicial des de fitxer
+- Comandos d'àudio configurables des de la consola
+- Renderitzat del dispositiu GPU en info_debug
+- `Screen` optimitzat (`textureToRenderer()`)
+- Eliminat suport per a arguments de línia de comandos
+- Eliminat `Options::console`
+- Help de consola organitzat
+
+### Correccions
+- Fix: vsync off no funcionava en Wayland
+- Fix: en TITLE, la consola no bloquejava la pulsació de l'1 al 4 i entrava a opcions
+- Fix: dos logs de consola amb format incorrecte
+- Fix: lògica per a obrir i entrar a la jail (ara gasta número d'habitació, no nom)
+- Corregit `compile_spirv.cmake` i la `system_folder` per a shaders
+- Corregit caràcter de caret que s'havia perdut
+- Eliminats accents en títols d'habitacions que causaven problemes amb fonts
+- Revisades i corregides traduccions
+- Corregits fitxers `.fnt`
+- Correcció en `Screen` per a `std::setprecision()` (faltava `#include <iomanip>`)
+
+---
+
+## [v1.09] - 2025-03-01
+
+### Novetats
+- **Refactorització a singletons:** `Screen`, `Input`, `Audio`, `Resource::Cache`, `Resource::List`, `Director`, `Cheevos`, `Debug` convertits a singletons thread-safe
+- **Smart pointers:** ús de `std::shared_ptr` i `std::unique_ptr` per a gestió de recursos i sprites
+- **Surfaces 8-bit indexades:** nou sistema de renderitzat amb color indexat i paletes intercanviables
+- **Sistema de notificacions redissenyat:** nou engine de notificacions amb control d'offset
+- **Modes de vídeo millorats:** la finestra manté posició al canviar tamany o activar borde; pot créixer segons l'escriptori
+- **ItemTracker:** nou singleton per a rastrejar ítems arreplegats
+- **globalEvents:** nou sistema d'events globals SDL
+- **Barra de progrés en càrrega de recursos** (actualització cada 5 ítems per a major rendiment amb vsync)
+- **Mètodes show/hide finestra:** mètodes per a mostrar o amagar la finestra
+- Afinada la classe `Options`
+- Actualitzada a l'última versió de `jail_audio`
+- Implementats shaders
+- Nova tipografia afegida
+- Paràmetres de fitxers `.ani` migrats a snake_case
+- Música de Title i attract mode restaurada
+- Eliminat sistema online complet
+
+### Correccions
+- Fix: notificacions ja no embruten la pantalla de càrrega
+- Fix: no pintava l'efecte de càrrega del borde en `LoadingScreen`
+- Fix: bug amb el punter a `ScoreboardData`
+- Fix: càrrega d'opcions i recursos corregida
+- Eliminats accents problemàtics
+
+---
+
+## [v1.08] - 2024-02-22
+
+### Novetats
+- Possibilitat de saltar la pantalla de càrrega ja completada des del menú de títol
+- El `gamestate_title` pot començar en diferents estats
+- Pantalla de càrrega amb fade de paleta
+- GIF loader: dibuixat correcte de GIFs en pantalla
+- Afegida `paleta.cpp`/`.h` i `gif.c`
+
+### Correccions
+- Corregit bug en el fade de paleta (el canal blau no es propagava)
+- Arreglada la separació entre el títol i el fade
+- Online deshabilitat per defecte al crear el fitxer de configuració
+- Temps de la pantalla de càrrega augmentat
+
+---
+
+## [v1.07] - 2022-12-02
+
+### Novetats
+- El nom de l'habitació es pinta a partir d'una textura
+- Afegit Batman a FEEL THE HEAT
+- Cel de la Jail actualitzat
+- Retocada la pantalla de títol
+- Sprite de PACO modificat
+- Nom de l'enemic diskette canviat a floppy
+- Canvis cosmètics en algunes habitacions (BE CAREFUL WITH THE FUSE reanomenat)
+- El color de fons de l'habitació es pinta en la textura del mapa
+- Optimitzacions en intro i title
+- Preparació per a compatibilitat amb consoles
+- Actualitzat `jail_audio` a l'última versió
+- Eliminats la major part d'accessos a `vector::at()`
+
+### Correccions
+- Corregit bug: en la jail es rellenaven les vides mentre estava activa la pausa
+- Corregit memory leak en `texture.cpp`
+- Corregit bug en obertura de la Jail
+
+---
+
+## [v1.0] - 2022-11-13
+
+Versió de llançament inicial.
+
+---
+
+*El format d'este changelog seguix [Keep a Changelog](https://keepachangelog.com/).*

CMakeLists.txt

@@ -3,83 +3,341 @@
 cmake_minimum_required(VERSION 3.10)
 project(jaildoctors_dilemma VERSION 1.00)
 
-# Configuración de compilador para MinGW en Windows, si es necesario
-if(WIN32 AND NOT CMAKE_CXX_COMPILER_ID MATCHES "MSVC")
-    set(CMAKE_CXX_COMPILER "g++")
-    set(CMAKE_C_COMPILER "gcc")
-endif()
-
 # Establecer estándar de C++
 set(CMAKE_CXX_STANDARD 20)
 set(CMAKE_CXX_STANDARD_REQUIRED True)
 
-# Configuración global de flags de compilación
+# Exportar comandos de compilación para herramientas de análisis
-set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall")
+set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
-set(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} -Os -ffunction-sections -fdata-sections")
 
-# Define el directorio de los archivos fuente
+# --- GENERACIÓN DE VERSIÓN AUTOMÁTICA ---
-set(DIR_SOURCES "${CMAKE_SOURCE_DIR}/source")
+find_package(Git QUIET)
-
+if(GIT_FOUND)
-# Cargar todos los archivos fuente en DIR_SOURCES
+    execute_process(
-file(GLOB SOURCES "${DIR_SOURCES}/*.cpp")
+        COMMAND ${GIT_EXECUTABLE} rev-parse --short=7 HEAD
-
+        WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
-# Verificar si se encontraron archivos fuente
+        OUTPUT_VARIABLE GIT_HASH
-if(NOT SOURCES)
+        OUTPUT_STRIP_TRAILING_WHITESPACE
-    message(FATAL_ERROR "No se encontraron archivos fuente en ${DIR_SOURCES}. Verifica que el directorio existe y contiene archivos .cpp.")
+        ERROR_QUIET
-endif()
+    )
-
-# Configuración de SDL2
-find_package(SDL2 REQUIRED)
-if(SDL2_FOUND)
-    message(STATUS "SDL2 encontrado: ${SDL2_INCLUDE_DIRS}")
-    include_directories(${SDL2_INCLUDE_DIRS})
-    link_directories(${SDL2_LIBDIR})
 else()
-    message(FATAL_ERROR "SDL2 no encontrado")
+    set(GIT_HASH "unknown")
 endif()
 
-# Incluye rutas de SDL2 obtenidas con pkg-config
+# Configurar archivo de versión
-include_directories(/usr/local/include /usr/local/include/SDL2)
+configure_file(${CMAKE_SOURCE_DIR}/source/version.h.in ${CMAKE_BINARY_DIR}/version.h @ONLY)
-link_directories(/usr/local/lib)
 
-# Definir las bibliotecas comunes
+# --- 1. LISTA EXPLÍCITA DE FUENTES ---
-set(LIBS SDL2)
+set(APP_SOURCES
+    # Core - Audio
+    source/core/audio/audio.cpp
 
-# Configuración común de salida de ejecutables en el directorio raíz
+    # Core - Input
-set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_SOURCE_DIR})
+    source/core/input/global_inputs.cpp
+    source/core/input/input_types.cpp
+    source/core/input/input.cpp
+    source/core/input/mouse.cpp
 
-# Añadir ejecutable principal
+    # Core - Rendering
-add_executable(${PROJECT_NAME} ${SOURCES})
+    source/core/rendering/gif.cpp
+    source/core/rendering/palette_manager.cpp
+    source/core/rendering/pixel_reveal.cpp
+    source/core/rendering/render_info.cpp
+    source/core/rendering/screen.cpp
+    source/core/rendering/sprite/animated_sprite.cpp
+    source/core/rendering/sprite/dissolve_sprite.cpp
+    source/core/rendering/sprite/moving_sprite.cpp
+    source/core/rendering/sprite/sprite.cpp
+    source/core/rendering/surface.cpp
+    source/core/rendering/text.cpp
 
-# Añadir definiciones de compilación dependiendo del tipo de build
+    # Core - Locale
-target_compile_definitions(${PROJECT_NAME} PRIVATE $<$<CONFIG:DEBUG>:DEBUG VERBOSE>)
+    source/core/locale/locale.cpp
 
-# Enlazar bibliotecas
+    # Core - Resources
-target_link_libraries(${PROJECT_NAME} ${LIBS})
+    source/core/resources/resource_cache.cpp
+    source/core/resources/resource_helper.cpp
+    source/core/resources/resource_list.cpp
+    source/core/resources/resource_loader.cpp
+    source/core/resources/resource_pack.cpp
+
+    # Core - System
+    source/core/system/director.cpp
+    source/core/system/global_events.cpp
+
+    # Game - Entities
+    source/game/entities/enemy.cpp
+    source/game/entities/item.cpp
+    source/game/entities/player.cpp
+
+    # Game - Configuration
+    source/game/options.cpp
+
+    # Game - Gameplay
+    source/game/gameplay/cheevos.cpp
+    source/game/gameplay/collision_map.cpp
+    source/game/gameplay/enemy_manager.cpp
+    source/game/gameplay/item_manager.cpp
+    source/game/gameplay/item_tracker.cpp
+    source/game/gameplay/room_loader.cpp
+    source/game/gameplay/room_tracker.cpp
+    source/game/gameplay/room.cpp
+    source/game/gameplay/scoreboard.cpp
+    source/game/gameplay/stats.cpp
+    source/game/gameplay/tilemap_renderer.cpp
+
+    # Game - Scenes
+    source/game/scenes/credits.cpp
+    source/game/scenes/ending.cpp
+    source/game/scenes/ending2.cpp
+    source/game/scenes/game_over.cpp
+    source/game/scenes/game.cpp
+    source/game/scenes/loading_screen.cpp
+    source/game/scenes/logo.cpp
+    source/game/scenes/title.cpp
+
+    # Game - Editor (debug only, guarded by #ifdef _DEBUG in source)
+    source/game/editor/map_editor.cpp
+    source/game/editor/editor_statusbar.cpp
+    source/game/editor/room_saver.cpp
+    source/game/editor/tile_picker.cpp
+    source/game/editor/mini_map.cpp
+
+    # Game - UI
+    source/game/ui/console.cpp
+    source/game/ui/console_commands.cpp
+    source/game/ui/notifier.cpp
+
+    # Utils
+    source/utils/delta_timer.cpp
+    source/utils/utils.cpp
+
+    # Main
+    source/main.cpp
+)
+
+# Fuentes del sistema de renderizado (SDL3 GPU para todas las plataformas)
+set(RENDERING_SOURCES
+    source/core/rendering/sdl3gpu/sdl3gpu_shader.cpp
+)
+
+# Fuentes de debug (solo en modo Debug)
+set(DEBUG_SOURCES
+    source/core/system/debug.cpp
+)
+
+# Configuración de SDL3
+find_package(SDL3 REQUIRED CONFIG REQUIRED COMPONENTS SDL3)
+message(STATUS "SDL3 encontrado: ${SDL3_INCLUDE_DIRS}")
+
+# --- SHADER COMPILATION (Linux/Windows only - macOS uses Metal) ---
+if(NOT APPLE)
+    find_program(GLSLC_EXE NAMES glslc)
+
+    set(SHADERS_DIR "${CMAKE_SOURCE_DIR}/data/shaders")
+    set(HEADERS_DIR "${CMAKE_SOURCE_DIR}/source/core/rendering/sdl3gpu")
+
+    set(SHADER_POSTFX_VERT_SRC  "${SHADERS_DIR}/postfx.vert")
+    set(SHADER_POSTFX_FRAG_SRC  "${SHADERS_DIR}/postfx.frag")
+    set(SHADER_UPSCALE_FRAG_SRC "${SHADERS_DIR}/upscale.frag")
+    set(SHADER_DOWNSCALE_FRAG_SRC "${SHADERS_DIR}/downscale.frag")
+    set(SHADER_CRTPI_FRAG_SRC   "${SHADERS_DIR}/crtpi_frag.glsl")
+
+    set(SHADER_POSTFX_VERT_H    "${HEADERS_DIR}/postfx_vert_spv.h")
+    set(SHADER_POSTFX_FRAG_H    "${HEADERS_DIR}/postfx_frag_spv.h")
+    set(SHADER_UPSCALE_FRAG_H   "${HEADERS_DIR}/upscale_frag_spv.h")
+    set(SHADER_DOWNSCALE_FRAG_H "${HEADERS_DIR}/downscale_frag_spv.h")
+    set(SHADER_CRTPI_FRAG_H     "${HEADERS_DIR}/crtpi_frag_spv.h")
+
+    set(ALL_SHADER_HEADERS
+        "${SHADER_POSTFX_VERT_H}"
+        "${SHADER_POSTFX_FRAG_H}"
+        "${SHADER_UPSCALE_FRAG_H}"
+        "${SHADER_DOWNSCALE_FRAG_H}"
+        "${SHADER_CRTPI_FRAG_H}"
+    )
+    set(ALL_SHADER_SOURCES
+        "${SHADER_POSTFX_VERT_SRC}"
+        "${SHADER_POSTFX_FRAG_SRC}"
+        "${SHADER_UPSCALE_FRAG_SRC}"
+        "${SHADER_DOWNSCALE_FRAG_SRC}"
+        "${SHADER_CRTPI_FRAG_SRC}"
+    )
+
+    if(GLSLC_EXE)
+        add_custom_command(
+            OUTPUT  ${ALL_SHADER_HEADERS}
+            COMMAND ${CMAKE_COMMAND}
+                    -D GLSLC=${GLSLC_EXE}
+                    -D SHADERS_DIR=${SHADERS_DIR}
+                    -D HEADERS_DIR=${HEADERS_DIR}
+                    -P ${CMAKE_SOURCE_DIR}/tools/shaders/compile_spirv.cmake
+            DEPENDS ${ALL_SHADER_SOURCES}
+            WORKING_DIRECTORY "${CMAKE_SOURCE_DIR}"
+            COMMENT "Compilando shaders SPIR-V..."
+        )
+        add_custom_target(shaders DEPENDS ${ALL_SHADER_HEADERS})
+        message(STATUS "glslc encontrado: shaders se compilarán automáticamente")
+    else()
+        foreach(HDR ${ALL_SHADER_HEADERS})
+            if(NOT EXISTS "${HDR}")
+                message(FATAL_ERROR
+                    "glslc no encontrado y header SPIR-V no existe: ${HDR}\n"
+                    "  Instala glslc: sudo apt install glslang-tools  (Linux)\n"
+                    "                 choco install vulkan-sdk         (Windows)\n"
+                    "  O genera los headers manualmente: tools/shaders/compile_spirv.sh"
+                )
+            endif()
+        endforeach()
+        message(STATUS "glslc no encontrado - usando headers SPIR-V precompilados")
+    endif()
+else()
+    message(STATUS "macOS: shaders SPIR-V omitidos (usa Metal)")
+endif()
+
+# --- 2. AÑADIR EJECUTABLE ---
+add_executable(${PROJECT_NAME} ${APP_SOURCES} ${RENDERING_SOURCES})
+
+# Shaders deben compilarse antes que el ejecutable (Linux/Windows con glslc)
+if(NOT APPLE AND GLSLC_EXE)
+    add_dependencies(${PROJECT_NAME} shaders)
+endif()
+
+# Añadir fuentes de debug solo en modo Debug
+target_sources(${PROJECT_NAME} PRIVATE $<$<CONFIG:Debug>:${DEBUG_SOURCES}>)
+
+# --- 3. DIRECTORIOS DE INCLUSIÓN ---
+target_include_directories(${PROJECT_NAME} PUBLIC
+    "${CMAKE_SOURCE_DIR}/source"
+    "${CMAKE_BINARY_DIR}"
+)
+
+# Enlazar las librerías SDL3
+target_link_libraries(${PROJECT_NAME} PRIVATE SDL3::SDL3)
+
+
+# --- 4. CONFIGURACIÓN PLATAFORMAS Y COMPILADOR  ---
+# Configuración de flags de compilación
+target_compile_options(${PROJECT_NAME} PRIVATE -Wall)
+target_compile_options(${PROJECT_NAME} PRIVATE $<$<CONFIG:RELEASE>:-Os -ffunction-sections -fdata-sections>)
+
+# Definir _DEBUG en modo Debug y RELEASE_BUILD en modo Release
+target_compile_definitions(${PROJECT_NAME} PRIVATE $<$<CONFIG:DEBUG>:_DEBUG>)
+target_compile_definitions(${PROJECT_NAME} PRIVATE $<$<CONFIG:RELEASE>:RELEASE_BUILD>)
 
 # Configuración específica para cada plataforma
 if(WIN32)
     target_compile_definitions(${PROJECT_NAME} PRIVATE WINDOWS_BUILD)
-    target_link_libraries(${PROJECT_NAME} mingw32 opengl32 gdi32 winmm imm32 ole32 version)
+    target_link_libraries(${PROJECT_NAME} PRIVATE ws2_32 mingw32)
 elseif(APPLE)
-    set(LIBS ${LIBS} "-framework OpenGL")
     target_compile_definitions(${PROJECT_NAME} PRIVATE MACOS_BUILD)
-    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wno-deprecated")
+    target_compile_options(${PROJECT_NAME} PRIVATE -Wno-deprecated)
-    # Configurar compilación para Apple Silicon
+    if(NOT CMAKE_OSX_ARCHITECTURES)
-    set(CMAKE_OSX_ARCHITECTURES "arm64")
+        set(CMAKE_OSX_ARCHITECTURES "arm64")
+    endif()
+    if(MACOS_BUNDLE)
+        target_compile_definitions(${PROJECT_NAME} PRIVATE MACOS_BUNDLE)
+        target_link_options(${PROJECT_NAME} PRIVATE
+            -framework SDL3
+            -F ${CMAKE_SOURCE_DIR}/release/macos/frameworks/SDL3.xcframework/macos-arm64_x86_64
+            -rpath @executable_path/../Frameworks/
+        )
+    endif()
 elseif(UNIX AND NOT APPLE)
-    set(LIBS ${LIBS} GL)
     target_compile_definitions(${PROJECT_NAME} PRIVATE LINUX_BUILD)
-    target_link_libraries(${PROJECT_NAME} ${LIBS})
 endif()
 
-# Añadir OpenGL a las bibliotecas enlazadas
+# Especificar la ubicación del ejecutable
-if(NOT WIN32)
+set_target_properties(${PROJECT_NAME} PROPERTIES RUNTIME_OUTPUT_DIRECTORY ${CMAKE_SOURCE_DIR})
-    find_package(OpenGL REQUIRED)
+
-    if(OPENGL_FOUND)
+# --- 5. STATIC ANALYSIS TARGETS ---
-        message(STATUS "OpenGL encontrado: ${OPENGL_LIBRARIES}")
+
-        target_link_libraries(${PROJECT_NAME} ${OPENGL_LIBRARIES})
+# Buscar herramientas de análisis estático
-    else()
+find_program(CLANG_TIDY_EXE NAMES clang-tidy)
-        message(FATAL_ERROR "OpenGL no encontrado")
+find_program(CLANG_FORMAT_EXE NAMES clang-format)
-    endif()
+
+# Recopilar todos los archivos fuente para formateo
+file(GLOB_RECURSE ALL_SOURCE_FILES
+    "${CMAKE_SOURCE_DIR}/source/*.cpp"
+    "${CMAKE_SOURCE_DIR}/source/*.hpp"
+    "${CMAKE_SOURCE_DIR}/source/*.h"
+)
+
+# Excluir directorio external del análisis
+list(FILTER ALL_SOURCE_FILES EXCLUDE REGEX ".*/external/.*")
+
+# Para clang-tidy, también excluir jail_audio.hpp
+set(CLANG_TIDY_SOURCES ${ALL_SOURCE_FILES})
+list(FILTER CLANG_TIDY_SOURCES EXCLUDE REGEX ".*jail_audio\\.hpp$")
+list(FILTER CLANG_TIDY_SOURCES EXCLUDE REGEX ".*_spv\\.h$")
+
+# Targets de clang-tidy
+if(CLANG_TIDY_EXE)
+    add_custom_target(tidy
+        COMMAND ${CLANG_TIDY_EXE}
+            -p ${CMAKE_BINARY_DIR}
+            ${CLANG_TIDY_SOURCES}
+        WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
+        COMMENT "Running clang-tidy..."
+    )
+
+    add_custom_target(tidy-fix
+        COMMAND ${CLANG_TIDY_EXE}
+            -p ${CMAKE_BINARY_DIR}
+            --fix
+            ${CLANG_TIDY_SOURCES}
+        WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
+        COMMENT "Running clang-tidy with fixes..."
+    )
+else()
+    message(STATUS "clang-tidy no encontrado - targets 'tidy' y 'tidy-fix' no disponibles")
 endif()
+
+# Targets de clang-format
+if(CLANG_FORMAT_EXE)
+    add_custom_target(format
+        COMMAND ${CLANG_FORMAT_EXE}
+            -i
+            ${ALL_SOURCE_FILES}
+        WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
+        COMMENT "Running clang-format..."
+    )
+
+    add_custom_target(format-check
+        COMMAND ${CLANG_FORMAT_EXE}
+            --dry-run
+            --Werror
+            ${ALL_SOURCE_FILES}
+        WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
+        COMMENT "Checking clang-format..."
+    )
+else()
+    message(STATUS "clang-format no encontrado - targets 'format' y 'format-check' no disponibles")
+endif()
+
+# --- 6. PACK RESOURCES TARGETS ---
+set(PACK_TOOL_SOURCES
+    ${CMAKE_SOURCE_DIR}/tools/pack_resources/pack_resources.cpp
+    ${CMAKE_SOURCE_DIR}/source/core/resources/resource_pack.cpp
+)
+
+add_executable(pack_tool ${PACK_TOOL_SOURCES})
+target_include_directories(pack_tool PRIVATE ${CMAKE_SOURCE_DIR}/source)
+set_target_properties(pack_tool PROPERTIES
+    RUNTIME_OUTPUT_DIRECTORY ${CMAKE_SOURCE_DIR}/tools/pack_resources
+)
+
+file(GLOB_RECURSE DATA_FILES "${CMAKE_SOURCE_DIR}/data/*")
+
+add_custom_command(
+    OUTPUT  "${CMAKE_SOURCE_DIR}/resources.pack"
+    COMMAND $<TARGET_FILE:pack_tool>
+            "${CMAKE_SOURCE_DIR}/data"
+            "${CMAKE_SOURCE_DIR}/resources.pack"
+    DEPENDS pack_tool ${DATA_FILES}
+    WORKING_DIRECTORY "${CMAKE_SOURCE_DIR}"
+    COMMENT "Generando resources.pack desde data/..."
+)
+
+add_custom_target(pack DEPENDS "${CMAKE_SOURCE_DIR}/resources.pack")
+add_dependencies(${PROJECT_NAME} pack)

LICENSE

@@ -1 +1,21 @@
-GNU General Public License v3.0 only
+Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License
+
+Copyright (c) 2022 JailDoctor's Dilemma - JailDesigner
+
+This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
+
+You are free to:
+- Share — copy and redistribute the material in any medium or format
+- Adapt — remix, transform, and build upon the material
+
+Under the following terms:
+- Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
+- NonCommercial — You may not use the material for commercial purposes.
+- ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.
+
+No additional restrictions — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.
+
+To view a copy of this license, visit:
+https://creativecommons.org/licenses/by-nc-sa/4.0/
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Makefile

@@ -1,145 +1,317 @@
-executable = jaildoctors_dilemma
+# ==============================================================================
-source = source/*.cpp
+# DIRECTORIES
-appName = JailDoctor's Dilemma
+# ==============================================================================
-releaseFolder = jdd_release
+DIR_ROOT       := $(dir $(abspath $(MAKEFILE_LIST)))
-version = v1.09
+DIR_SOURCES    := $(addsuffix /, $(DIR_ROOT)source)
+DIR_BIN        := $(addsuffix /, $(DIR_ROOT))
+DIR_TOOLS      := $(addsuffix /, $(DIR_ROOT)tools)
 
-# Release names
+# ==============================================================================
-windowsRelease = $(executable)-$(version)-win32-x64.zip
+# TARGET NAMES
-macosIntelRelease = $(executable)-$(version)-macos-intel.dmg
+# ==============================================================================
-macosAppleSiliconRelease = $(executable)-$(version)-macos-apple-silicon.dmg
+TARGET_NAME    := jaildoctors_dilemma
-linuxRelease = $(executable)-$(version)-linux.tar.gz
+TARGET_FILE    := $(DIR_BIN)$(TARGET_NAME)
+APP_NAME       := JailDoctor's Dilemma
+DIST_DIR       := dist
+RELEASE_FOLDER := dist/_tmp
+RELEASE_FILE   := $(RELEASE_FOLDER)/$(TARGET_NAME)
+RESOURCE_FILE  := release/windows/jdd.res
 
-# Specify the C++ standard
+# ==============================================================================
-cpp_standard = c++20
+# TOOLS
+# ==============================================================================
+DIR_PACK_TOOL  := $(DIR_TOOLS)pack_resources
+SHADER_SCRIPT  := $(DIR_ROOT)tools/shaders/compile_spirv.sh
+SHADER_CMAKE   := $(DIR_ROOT)tools/shaders/compile_spirv.cmake
+SHADERS_DIR    := $(DIR_ROOT)data/shaders
+HEADERS_DIR    := $(DIR_ROOT)source/core/rendering/sdl3gpu
+ifeq ($(OS),Windows_NT)
+    GLSLC      := $(shell where glslc 2>NUL)
+else
+    GLSLC      := $(shell command -v glslc 2>/dev/null)
+endif
 
-windows:
+# ==============================================================================
-	@echo off
+# VERSION (extracted from defines.hpp)
-	g++ $(source) -std=$(cpp_standard) -Wall -Os -lmingw32 -lws2_32 -lSDL2main -lSDL2 -lopengl32 -ffunction-sections -fdata-sections -Wl,--gc-sections -static-libstdc++ -Wl,-subsystem,windows -o "$(executable).exe"
+# ==============================================================================
-	strip -s -R .comment -R .gnu.version "$(executable).exe" --strip-unneeded
+ifeq ($(OS),Windows_NT)
+    VERSION := v$(shell powershell -Command "(Select-String -Path 'source/utils/defines.hpp' -Pattern 'constexpr const char\* VERSION = \"(.+?)\"').Matches.Groups[1].Value")
+else
+    VERSION := v$(shell grep 'constexpr const char\* VERSION' source/utils/defines.hpp | sed -E 's/.*VERSION = "([^"]+)".*/\1/')
+endif
 
-windows_debug:
+# ==============================================================================
-	@echo off
+# SHELL (Windows usa cmd.exe para que las recetas con powershell funcionen igual
-	g++ $(source) -D DEBUG -std=$(cpp_standard) -Wall -Os -lmingw32 -lws2_32 -lSDL2main -lSDL2 -lopengl32 -ffunction-sections -fdata-sections -Wl,--gc-sections -static-libstdc++ -Wl,-subsystem,windows -o "$(executable)_debug.exe"
+# desde cualquier terminal: PowerShell, cmd o git-bash)
-	strip -s -R .comment -R .gnu.version "$(executable)_debug.exe" --strip-unneeded
+# ==============================================================================
+ifeq ($(OS),Windows_NT)
+    SHELL := cmd.exe
+endif
 
+# ==============================================================================
+# WINDOWS-SPECIFIC VARIABLES
+# ==============================================================================
+ifeq ($(OS),Windows_NT)
+    WIN_TARGET_FILE    := $(DIR_BIN)$(APP_NAME)
+    WIN_RELEASE_FILE   := $(RELEASE_FOLDER)/$(APP_NAME)
+else
+    WIN_TARGET_FILE    := $(TARGET_FILE)
+    WIN_RELEASE_FILE   := $(RELEASE_FILE)
+endif
+
+# ==============================================================================
+# RELEASE NAMES
+# ==============================================================================
+WINDOWS_RELEASE             := $(DIST_DIR)/$(TARGET_NAME)-$(VERSION)-win32-x64.zip
+MACOS_INTEL_RELEASE         := $(DIST_DIR)/$(TARGET_NAME)-$(VERSION)-macos-intel.dmg
+MACOS_APPLE_SILICON_RELEASE := $(DIST_DIR)/$(TARGET_NAME)-$(VERSION)-macos-apple-silicon.dmg
+LINUX_RELEASE               := $(DIST_DIR)/$(TARGET_NAME)-$(VERSION)-linux.tar.gz
+
+# ==============================================================================
+# PLATAFORMA
+# ==============================================================================
+ifeq ($(OS),Windows_NT)
+    FixPath         = $(subst /,\\,$1)
+    RM              := del /Q
+    MKDIR           := mkdir
+else
+    FixPath         = $1
+    RMFILE          := rm -f
+    RMDIR           := rm -rdf
+    MKDIR           := mkdir -p
+    UNAME_S         := $(shell uname -s)
+endif
+
+# ==============================================================================
+# COMPILACIÓN CON CMAKE
+# ==============================================================================
+all:
+	@cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
+	@cmake --build build
+
+debug:
+	@cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug
+	@cmake --build build
+
+# ==============================================================================
+# RELEASE AUTOMÁTICO (detecta SO)
+# ==============================================================================
+release:
+ifeq ($(OS),Windows_NT)
+	@"$(MAKE)" windows_release
+else
+ifeq ($(UNAME_S),Darwin)
+	@$(MAKE) macos_release
+else
+	@$(MAKE) linux_release
+endif
+endif
+
+# ==============================================================================
+# REGLAS PARA COMPILACIÓN DE SHADERS (multiplataforma via cmake)
+# ==============================================================================
+compile_shaders:
+ifdef GLSLC
+	@cmake -D GLSLC=$(GLSLC) -D SHADERS_DIR=$(SHADERS_DIR) -D HEADERS_DIR=$(HEADERS_DIR) -P $(SHADER_CMAKE)
+else
+	@echo "glslc no encontrado - asegurate de que los headers SPIR-V precompilados existen"
+endif
+
+# ==============================================================================
+# REGLAS PARA HERRAMIENTA DE EMPAQUETADO Y RESOURCES.PACK
+# ==============================================================================
+pack_tool:
+	@$(MAKE) -C $(DIR_PACK_TOOL)
+
+resources.pack: pack_tool
+	@$(MAKE) -C $(DIR_PACK_TOOL) pack
+
+# ==============================================================================
+# COMPILACIÓN PARA WINDOWS (RELEASE)
+# ==============================================================================
 windows_release:
 	@echo off
+	@echo Creando release para Windows - Version: $(VERSION)
 
-# Create release folder
+# Compila con cmake (genera shaders, resources.pack y ejecutable)
-	powershell if (Test-Path "$(releaseFolder)") {Remove-Item "$(releaseFolder)" -Recurse -Force}
+	@cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
-	powershell if (-not (Test-Path "$(releaseFolder)")) {New-Item "$(releaseFolder)" -ItemType Directory}
+	@cmake --build build
 
-# Prepare data folder
+# Crea carpeta de distribución y carpeta temporal 'RELEASE_FOLDER'
-	powershell Copy-Item -Path "data" -Destination "$(releaseFolder)" -recurse -Force
+	@powershell -Command "if (-not (Test-Path '$(DIST_DIR)')) {New-Item '$(DIST_DIR)' -ItemType Directory}"
-	powershell if (Test-Path "$(releaseFolder)\data\room\map.world") {Remove-Item "$(releaseFolder)\data\room\map.world" -Recurse -Force}
+	@powershell -Command "if (Test-Path '$(RELEASE_FOLDER)') {Remove-Item '$(RELEASE_FOLDER)' -Recurse -Force}"
-	powershell if (Test-Path "$(releaseFolder)\data\room\standard.tsx") {Remove-Item "$(releaseFolder)\data\room\standard.tsx" -Recurse -Force}
+	@powershell -Command "if (-not (Test-Path '$(RELEASE_FOLDER)')) {New-Item '$(RELEASE_FOLDER)' -ItemType Directory}"
-	
-# Copy root files
-	powershell Copy-Item "LICENSE" -Destination "$(releaseFolder)"
-	powershell Copy-Item "README.md" -Destination "$(releaseFolder)"
-	powershell Copy-Item "release\*.dll" -Destination "$(releaseFolder)"
 
-# Build
+# Copia ficheros
-	g++ $(source) -std=$(cpp_standard) -Wall -Os -lmingw32 -lws2_32 -lSDL2main -lSDL2 -lopengl32 -ffunction-sections -fdata-sections -Wl,--gc-sections -static-libstdc++ -Wl,-subsystem,windows -o "$(releaseFolder)/$(executable).exe"
+	@powershell -Command "Copy-Item -Path 'resources.pack' -Destination '$(RELEASE_FOLDER)'"
-	strip -s -R .comment -R .gnu.version "$(releaseFolder)/$(executable).exe" --strip-unneeded
+	@powershell -Command "Copy-Item 'LICENSE' -Destination '$(RELEASE_FOLDER)'"
+	@powershell -Command "Copy-Item 'README.md' -Destination '$(RELEASE_FOLDER)'"
+	@powershell -Command "Copy-Item 'gamecontrollerdb.txt' -Destination '$(RELEASE_FOLDER)'"
+	@powershell -Command "Copy-Item 'release\windows\dll\*.dll' -Destination '$(RELEASE_FOLDER)'"
+	@powershell -Command "Copy-Item -Path '$(TARGET_FILE)' -Destination '\"$(WIN_RELEASE_FILE).exe\"'"
+	strip -s -R .comment -R .gnu.version "$(WIN_RELEASE_FILE).exe" --strip-unneeded
 
-# Create ZIP
+# Crea el fichero .zip
-	powershell if (Test-Path $(windowsRelease)) {Remove-Item $(windowsRelease)}
+	@powershell -Command "if (Test-Path '$(WINDOWS_RELEASE)') {Remove-Item '$(WINDOWS_RELEASE)'}"
-	powershell Compress-Archive -Path "$(releaseFolder)"/* -DestinationPath $(windowsRelease)
+	@powershell -Command "Compress-Archive -Path '$(RELEASE_FOLDER)/*' -DestinationPath '$(WINDOWS_RELEASE)'"
+	@echo Release creado: $(WINDOWS_RELEASE)
 
-# Remove folder
+# Elimina la carpeta temporal 'RELEASE_FOLDER'
-	powershell if (Test-Path "$(releaseFolder)") {Remove-Item "$(releaseFolder)" -Recurse -Force}
+	@powershell -Command "if (Test-Path '$(RELEASE_FOLDER)') {Remove-Item '$(RELEASE_FOLDER)' -Recurse -Force}"
-
-macos:
-	clang++ $(source) -std=$(cpp_standard) -Wall -Os -lSDL2 -framework OpenGL -Wno-deprecated -ffunction-sections -fdata-sections -o "$(executable)"
-
-macos_debug:
-	clang++ $(source) -D DEBUG -std=$(cpp_standard) -Wall -Os -lSDL2 -framework OpenGL -Wno-deprecated -ffunction-sections -fdata-sections -o "$(executable)_debug"
 
+# ==============================================================================
+# COMPILACIÓN PARA MACOS (RELEASE)
+# ==============================================================================
 macos_release:
-# Remove data and possible data from previous builds
+	@echo "Creando release para macOS - Version: $(VERSION)"
-	rm -rdf "$(releaseFolder)"
-	rm -rdf Frameworks
-	rm -f tmp.dmg
-	rm -f "$(macosIntelRelease)"
-	rm -f "$(macosAppleSiliconRelease)"
 
-# Create folders
+# Verificar e instalar create-dmg si es necesario
-	mkdir -p "$(releaseFolder)/$(appName).app/Contents/Frameworks"
+	@which create-dmg > /dev/null || (echo "Instalando create-dmg..." && brew install create-dmg)
-	mkdir -p "$(releaseFolder)/$(appName).app/Contents/MacOS"
-	mkdir -p "$(releaseFolder)/$(appName).app/Contents/Resources"
-	mkdir -p Frameworks
 
-# Copy folders
+# Compila la versión para procesadores Intel con cmake (genera shaders y resources.pack)
-	cp -R data "$(releaseFolder)/$(appName).app/Contents/Resources"
+	@cmake -S . -B build/intel -DCMAKE_BUILD_TYPE=Release -DCMAKE_OSX_ARCHITECTURES=x86_64 -DCMAKE_OSX_DEPLOYMENT_TARGET=10.15 -DMACOS_BUNDLE=ON
-	cp -R release/SDL2.framework "$(releaseFolder)/$(appName).app/Contents/Frameworks"
+	@cmake --build build/intel
-	cp -R release/SDL2.framework Frameworks
 
-# Delete data
+# Elimina datos de compilaciones anteriores
-	rm -f "$(releaseFolder)/$(appName).app/Contents/Resources/data/room/map.world"
+	$(RMDIR) "$(RELEASE_FOLDER)"
-	rm -f "$(releaseFolder)/$(appName).app/Contents/Resources/data/room/standard.tsx"
+	$(RMFILE) tmp.dmg
+	$(RMFILE) "$(DIST_DIR)"/rw.*
+	$(RMFILE) "$(MACOS_INTEL_RELEASE)"
+	$(RMFILE) "$(MACOS_APPLE_SILICON_RELEASE)"
 
-# Copy files
+# Crea la carpeta temporal para hacer el trabajo y las carpetas obligatorias para crear una app de macOS
-	cp release/*.icns "$(releaseFolder)/$(appName).app/Contents/Resources"
+	$(MKDIR) "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Frameworks"
-	cp release/Info.plist "$(releaseFolder)/$(appName).app/Contents"
+	$(MKDIR) "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/MacOS"
-	cp LICENSE "$(releaseFolder)"
+	$(MKDIR) "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Resources"
-	cp README.md "$(releaseFolder)"
 
-# Create links
+# Copia carpetas y ficheros
-	ln -s /Applications "$(releaseFolder)"/Applications
+	cp resources.pack "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Resources"
+	cp gamecontrollerdb.txt "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Resources"
+	cp -R release/macos/frameworks/SDL3.xcframework/macos-arm64_x86_64/SDL3.framework "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Frameworks"
+	cp release/icons/*.icns "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Resources"
+	cp release/macos/Info.plist "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents"
+	cp LICENSE "$(RELEASE_FOLDER)"
+	cp README.md "$(RELEASE_FOLDER)"
 
-# Build INTEL
+# Actualiza versión en Info.plist
-	clang++ $(source) -D MACOS_BUNDLE -std=$(cpp_standard) -Wall -Os -framework SDL2 -F ./Frameworks -framework OpenGL -Wno-deprecated  -ffunction-sections -fdata-sections -o "$(releaseFolder)/$(appName).app/Contents/MacOS/$(executable)" -rpath @executable_path/../Frameworks/ -target x86_64-apple-macos10.12
+	@echo "Actualizando Info.plist con versión $(VERSION)..."
+	@RAW_VERSION=$$(echo "$(VERSION)" | sed 's/^v//'); \
+	sed -i '' '/<key>CFBundleShortVersionString<\/key>/{n;s|<string>.*</string>|<string>'"$$RAW_VERSION"'</string>|;}' "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Info.plist"; \
+	sed -i '' '/<key>CFBundleVersion<\/key>/{n;s|<string>.*</string>|<string>'"$$RAW_VERSION"'</string>|;}' "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Info.plist"
 
-# Build INTEL DMG
+# Copia el ejecutable Intel al bundle
-	hdiutil create tmp.dmg -ov -volname "$(appName)" -fs HFS+ -srcfolder "$(releaseFolder)" 
+	cp "$(TARGET_FILE)" "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/MacOS/$(TARGET_NAME)"
-	hdiutil convert tmp.dmg -format UDZO -o "$(macosIntelRelease)"
-	rm -f tmp.dmg
 
-# Build APPLE SILICON	
+# Firma la aplicación
-	clang++ $(source) -D MACOS_BUNDLE -std=$(cpp_standard) -Wall -Os -framework SDL2 -F ./Frameworks -framework OpenGL -Wno-deprecated  -ffunction-sections -fdata-sections -o "$(releaseFolder)/$(appName).app/Contents/MacOS/$(executable)" -rpath @executable_path/../Frameworks/ -target arm64-apple-macos11
+	codesign --deep --force --sign - --timestamp=none "$(RELEASE_FOLDER)/$(APP_NAME).app"
 
-# Build APPLE SILICON DMG
+# Empaqueta el .dmg de la versión Intel con create-dmg
-	hdiutil create tmp.dmg -ov -volname "$(appName)" -fs HFS+ -srcfolder "$(releaseFolder)" 
+	@echo "Creando DMG Intel con iconos de 96x96..."
-	hdiutil convert tmp.dmg -format UDZO -o "$(macosAppleSiliconRelease)"
+	create-dmg \
-	rm -f tmp.dmg
+	  --volname "$(APP_NAME)" \
+	  --window-pos 200 120 \
+	  --window-size 720 300 \
+	  --icon-size 96 \
+	  --text-size 12 \
+	  --icon "$(APP_NAME).app" 278 102 \
+	  --icon "LICENSE" 441 102 \
+	  --icon "README.md" 604 102 \
+	  --app-drop-link 115 102 \
+	  --hide-extension "$(APP_NAME).app" \
+	  "$(MACOS_INTEL_RELEASE)" \
+	  "$(RELEASE_FOLDER)" || true
+	@echo "Release Intel creado: $(MACOS_INTEL_RELEASE)"
 
-# Remove data
+# Compila la versión para procesadores Apple Silicon con cmake
-	rm -rdf Frameworks
+	@cmake -S . -B build/arm -DCMAKE_BUILD_TYPE=Release -DCMAKE_OSX_ARCHITECTURES=arm64 -DCMAKE_OSX_DEPLOYMENT_TARGET=11.0 -DMACOS_BUNDLE=ON
-	rm -rdf "$(releaseFolder)"
+	@cmake --build build/arm
+	cp "$(TARGET_FILE)" "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/MacOS/$(TARGET_NAME)"
 
-linux:
+# Firma la aplicación
-	g++ $(source) -std=$(cpp_standard) -Wall -Os -lSDL2 -lGL -ffunction-sections -fdata-sections -Wl,--gc-sections -o "$(executable)"
+	codesign --deep --force --sign - --timestamp=none "$(RELEASE_FOLDER)/$(APP_NAME).app"
-	strip -s -R .comment -R .gnu.version "$(executable)" --strip-unneeded
 
-linux_debug:
+# Empaqueta el .dmg de la versión Apple Silicon con create-dmg
-	g++ $(source) -D DEBUG -std=$(cpp_standard) -Wall -Os -lSDL2 -lGL -ffunction-sections -fdata-sections -Wl,--gc-sections -o "$(executable)_debug"
+	@echo "Creando DMG Apple Silicon con iconos de 96x96..."
-	strip -s -R .comment -R .gnu.version "$(executable)_debug" --strip-unneeded
+	create-dmg \
+	  --volname "$(APP_NAME)" \
+	  --window-pos 200 120 \
+	  --window-size 720 300 \
+	  --icon-size 96 \
+	  --text-size 12 \
+	  --icon "$(APP_NAME).app" 278 102 \
+	  --icon "LICENSE" 441 102 \
+	  --icon "README.md" 604 102 \
+	  --app-drop-link 115 102 \
+	  --hide-extension "$(APP_NAME).app" \
+	  "$(MACOS_APPLE_SILICON_RELEASE)" \
+	  "$(RELEASE_FOLDER)" || true
+	@echo "Release Apple Silicon creado: $(MACOS_APPLE_SILICON_RELEASE)"
 
+# Elimina las carpetas temporales
+	$(RMDIR) "$(RELEASE_FOLDER)"
+	$(RMDIR) build/intel
+	$(RMDIR) build/arm
+	$(RMFILE) "$(DIST_DIR)"/rw.*
+
+# ==============================================================================
+# COMPILACIÓN PARA LINUX (RELEASE)
+# ==============================================================================
 linux_release:
-# Remove data
+	@echo "Creando release para Linux - Version: $(VERSION)"
-	rm -rdf "$(releaseFolder)"
 
-# Create folders
+# Compila con cmake (genera shaders, resources.pack y ejecutable)
-	mkdir -p "$(releaseFolder)"
+	@cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
+	@cmake --build build
 
-# Copy data
+# Elimina carpeta temporal previa y la recrea (crea dist/ si no existe)
-	cp -R data "$(releaseFolder)"
+	$(RMDIR) "$(RELEASE_FOLDER)"
-	cp LICENSE "$(releaseFolder)"
+	$(MKDIR) "$(RELEASE_FOLDER)"
-	cp README.md "$(releaseFolder)"
 
-# Delete data
+# Copia ficheros
-	rm -f "$(releaseFolder)/data/room/map.world"
+	cp resources.pack "$(RELEASE_FOLDER)"
-	rm -f "$(releaseFolder)/data/room/standard.tsx"
+	cp LICENSE "$(RELEASE_FOLDER)"
+	cp README.md "$(RELEASE_FOLDER)"
+	cp gamecontrollerdb.txt "$(RELEASE_FOLDER)"
+	cp "$(TARGET_FILE)" "$(RELEASE_FILE)"
+	strip -s -R .comment -R .gnu.version "$(RELEASE_FILE)" --strip-unneeded
 
-# Build
+# Empaqueta ficheros
-	g++ $(source) -std=$(cpp_standard) -Wall -Os -lSDL2 -lGL -ffunction-sections -fdata-sections -Wl,--gc-sections -o "$(releaseFolder)/$(executable)"
+	$(RMFILE) "$(LINUX_RELEASE)"
-	strip -s -R .comment -R .gnu.version "$(releaseFolder)/$(executable)" --strip-unneeded
+	tar -czvf "$(LINUX_RELEASE)" -C "$(RELEASE_FOLDER)" .
+	@echo "Release creado: $(LINUX_RELEASE)"
 
-# Pack files
+# Elimina la carpeta temporal
-	rm -f "$(linuxRelease)"
+	$(RMDIR) "$(RELEASE_FOLDER)"
-	cd "$(releaseFolder)" &&	tar -czvf "../$(linuxRelease)" *
 
-# Remove data
+# ==============================================================================
-	rm -rdf "$(releaseFolder)"
+# REGLAS ESPECIALES
+# ==============================================================================
+# Regla para mostrar la versión actual
+show_version:
+	@echo "Version actual: $(VERSION)"
+
+# Regla de ayuda
+help:
+	@echo "Makefile para JailDoctor's Dilemma"
+	@echo "Comandos disponibles:"
+	@echo ""
+	@echo "  Compilacion:"
+	@echo "    make                 - Compilar con cmake (Release)"
+	@echo "    make debug           - Compilar con cmake (Debug)"
+	@echo ""
+	@echo "  Release:"
+	@echo "    make release         - Crear release (detecta SO automaticamente)"
+	@echo "    make windows_release - Crear release para Windows"
+	@echo "    make linux_release   - Crear release para Linux"
+	@echo "    make macos_release   - Crear release para macOS"
+	@echo ""
+	@echo "  Herramientas:"
+	@echo "    make compile_shaders - Compilar shaders SPIR-V"
+	@echo "    make pack_tool       - Compilar herramienta de empaquetado"
+	@echo "    make resources.pack  - Generar pack de recursos desde data/"
+	@echo ""
+	@echo "  Otros:"
+	@echo "    make show_version    - Mostrar version actual ($(VERSION))"
+	@echo "    make help            - Mostrar esta ayuda"
+
+.PHONY: all debug release windows_release macos_release linux_release compile_shaders pack_tool resources.pack show_version help

README.md

@@ -1,15 +1,19 @@
+<div align="center">
+  <img src="https://php.sustancia.synology.me/images/jdd/jaildoctors_dilemma_cover_web.png" width="600" alt="JailDoctor's Dilemma Cover">
+</div>
+
 # JailDoctor's Dilemma
 
 JailDoc és un Jailer. Als Jailers els agrada començar projectes. A ningú li agrada acabar-los. Els Jailers viuen a la Jail. A la Jail s'hi va a començar projectes. A la Jail s'hi va a ensenyar els projectes. A la Jail s'hi va a aprendre com començar nous projectes. A la Jail s'hi va a ajudar els companys a començar nous projectes.
 
-![JailDoctor's Dilemma - Pantalla de títol](https://php.sustancia.synology.me/images/jdd/jdd_title.png)
-
 JailDoc és un Jailer destacat entre els Jailers. Té més projectes començats que ningú i és qui més ajuda als altres a iniciar els seus.
 
 Però un dia, va passar una cosa inesperada. Algú va acabar un projecte. Algú va alliberar el *Puzzle Jail Facker*. Un autèntic desaprensiu.
 
 Això va fer que JailDoc prenguera una decisió: acabaria i lliuraria un dels seus projectes. Però, quin? *JailBattle*? *Sigmasuá*? *Calculín Doom*? Quin dilema! Finalment, es va arromangar i va decidir acabar i lliurar **tots** els seus projectes inacabats. Ho aconseguirà?
 
+<br clear="left">
+
 ---
 
 ## Jugabilitat
@@ -26,19 +30,25 @@ Quan hages recuperat la major part de les peces, dirigeix-te a la Jail per mostr
 
 El joc permet tant l'ús del teclat com d'un comandament. Les tecles per a jugar són les següents:
 
-- **Cursors**: Per moure's a l'esquerra o dreta i per saltar. Es poden modificar les tecles en el fitxer de configuració, triant entre aquestes opcions:
+| Tecla | Acció |
-    - O, P per moure's i Q per saltar.
+|-------|-------|
-    - A, D per moure's i W per saltar.
+| **←, →** | Moure's a l'esquerra o dreta |
+| **↑** | Saltar |
+| **Enter** | Eixir dels projectes |
+| **ESC** | Cancelar / Eixir del joc |
+| **F1** | Disminuir la mida de la finestra |
+| **F2** | Augmentar la mida de la finestra |
+| **F3** | Alternar pantalla completa |
+| **F4** | Activar/desactivar els shaders |
+| **F5** | Següent paleta de colors |
+| **F6** | Paleta de colors anterior |
+| **F7** | Activar/desactivar l'escalat exacte |
+| **F8** | Activar/desactivar la música |
+| **F9** | Activar/desactivar el marge de colors |
+| **F10** | Activar/desactivar VSync |
+| **F11** | Pausar el joc |
 
-- **Tecla M**: Activa o desactiva la música.
+**Nota:** Les tecles de moviment (←, →, ↑) es poden redefinir des del menú del joc.
-- **Tecla P**: Pausa el joc.
-- **Tecla ESC**: Ix del joc si estàs jugant. Tanca el programa en qualsevol altra circumstància.
-- **Tecla F1**: Disminueix la mida de la finestra.
-- **Tecla F2**: Augmenta la mida de la finestra.
-- **Tecla F3**: Alterna entre el mode de pantalla completa i el mode finestra.
-- **Tecla F4**: Activa o desactiva els shaders
-- **Tecla F5**: Canvia la paleta de colors del joc.
-- **Tecla B**: Activa o desactiva el marge de colors en mode finestra.
 
 ![JailDoctor's Dilemma - Gameplay](https://php.sustancia.synology.me/images/jdd/jdd_game2.png)
 
@@ -50,9 +60,9 @@ El programa guarda automàticament la configuració del mode de vídeo i les est
 
 - **Windows**: `C:\Users\<nom_d'usuari>\AppData\Roaming\jailgames\jaildoctors_dilemma`
 - **MacOS**: `~/Library/Application Support/jailgames/jaildoctors_dilemma`
-- **Linux**: `~/.jailgames/jaildoctors_dilemma`
+- **Linux**: `~/.config/jailgames/jaildoctors_dilemma`
 
-Dins de la carpeta es troba el fitxer de configuració `config.txt`, on es pot modificar la configuració per connectar-se al servei en línia, i els fitxers `stats.csv` i `stats_buffer.csv`, que contenen informació sobre les estadístiques del joc.
+Dins de la carpeta es troba el fitxer de configuració `config.yaml`, on es pot modificar la configuració per connectar-se al servei en línia, i els fitxers `stats.csv` i `stats_buffer.csv`, que contenen informació sobre les estadístiques del joc.
 
 ---
 

config/assets.yaml

@@ -0,0 +1,372 @@
+# JailDoctor's Dilemma - Asset Configuration
+# Variables: ${PREFIX}, ${SYSTEM_FOLDER}
+
+assets:
+  # FONTS
+  fonts:
+    BITMAP:
+      - ${PREFIX}/data/font/smb2.gif
+      - ${PREFIX}/data/font/aseprite.gif
+      - ${PREFIX}/data/font/gauntlet.gif
+      - ${PREFIX}/data/font/subatomic.gif
+      - ${PREFIX}/data/font/8bithud.gif
+    FONT:
+      - ${PREFIX}/data/font/smb2.fnt
+      - ${PREFIX}/data/font/aseprite.fnt
+      - ${PREFIX}/data/font/gauntlet.fnt
+      - ${PREFIX}/data/font/subatomic.fnt
+      - ${PREFIX}/data/font/8bithud.fnt
+
+  # PALETTES
+  palettes:
+    PALETTE:
+      - ${PREFIX}/data/palette/zx-spectrum.pal
+      - ${PREFIX}/data/palette/zx-spectrum-adjusted.pal
+      - ${PREFIX}/data/palette/zxarne-5.2.pal
+      - ${PREFIX}/data/palette/black-and-white.pal
+      - ${PREFIX}/data/palette/green-phosphor.pal
+      - ${PREFIX}/data/palette/orange-screen.pal
+      - ${PREFIX}/data/palette/ruzx-spectrum.pal
+      - ${PREFIX}/data/palette/ruzx-spectrum-revision-2.pal
+      - ${PREFIX}/data/palette/pico-8.pal
+      - ${PREFIX}/data/palette/sweetie.pal
+      - ${PREFIX}/data/palette/island-joy.pal
+      - ${PREFIX}/data/palette/lost-century.pal
+      - ${PREFIX}/data/palette/na.pal
+      - ${PREFIX}/data/palette/steam-lords.pal
+      - ${PREFIX}/data/palette/winds-seed-pc98.pal
+      - ${PREFIX}/data/palette/psychic-fibre.pal
+      - ${PREFIX}/data/palette/shido-cyberneon.pal
+      - ${PREFIX}/data/palette/darkseed.pal
+      - ${PREFIX}/data/palette/antiquity.pal
+      - ${PREFIX}/data/palette/bubblegum.pal
+      - ${PREFIX}/data/palette/vanilla-milkshake.pal
+      - ${PREFIX}/data/palette/aged-terracotta.pal
+      - ${PREFIX}/data/palette/h16da.pal
+
+  # LOCALE
+  locale:
+    DATA:
+      - ${PREFIX}/data/locale/en.yaml
+      - ${PREFIX}/data/locale/ca.yaml
+
+  # INPUT
+  input:
+    DATA:
+      - ${PREFIX}/gamecontrollerdb.txt
+
+  # SYSTEM
+  system:
+    DATA:
+      - path: ${SYSTEM_FOLDER}/config.yaml
+        required: false
+        absolute: true
+      - path: ${SYSTEM_FOLDER}/debug.yaml
+        required: false
+        absolute: true
+      - path: ${SYSTEM_FOLDER}/editor.yaml
+        required: false
+        absolute: true
+      - path: ${SYSTEM_FOLDER}/stats_buffer.csv
+        required: false
+        absolute: true
+      - path: ${SYSTEM_FOLDER}/stats.csv
+        required: false
+        absolute: true
+      - path: ${SYSTEM_FOLDER}/cheevos.bin
+        required: false
+        absolute: true
+      - path: ${SYSTEM_FOLDER}/shaders/postfx.yaml
+        required: false
+        absolute: true
+      - path: ${SYSTEM_FOLDER}/shaders/crtpi.yaml
+        required: false
+        absolute: true
+
+  # CONSOLE
+  console:
+    DATA:
+      - ${PREFIX}/data/console/commands.yaml
+
+  # ROOMS
+  rooms:
+    ROOM:
+      - ${PREFIX}/data/room/01.yaml
+      - ${PREFIX}/data/room/02.yaml
+      - ${PREFIX}/data/room/03.yaml
+      - ${PREFIX}/data/room/04.yaml
+      - ${PREFIX}/data/room/05.yaml
+      - ${PREFIX}/data/room/06.yaml
+      - ${PREFIX}/data/room/07.yaml
+      - ${PREFIX}/data/room/08.yaml
+      - ${PREFIX}/data/room/09.yaml
+      - ${PREFIX}/data/room/10.yaml
+      - ${PREFIX}/data/room/11.yaml
+      - ${PREFIX}/data/room/12.yaml
+      - ${PREFIX}/data/room/13.yaml
+      - ${PREFIX}/data/room/14.yaml
+      - ${PREFIX}/data/room/15.yaml
+      - ${PREFIX}/data/room/16.yaml
+      - ${PREFIX}/data/room/17.yaml
+      - ${PREFIX}/data/room/18.yaml
+      - ${PREFIX}/data/room/19.yaml
+      - ${PREFIX}/data/room/20.yaml
+      - ${PREFIX}/data/room/21.yaml
+      - ${PREFIX}/data/room/22.yaml
+      - ${PREFIX}/data/room/23.yaml
+      - ${PREFIX}/data/room/24.yaml
+      - ${PREFIX}/data/room/25.yaml
+      - ${PREFIX}/data/room/26.yaml
+      - ${PREFIX}/data/room/27.yaml
+      - ${PREFIX}/data/room/28.yaml
+      - ${PREFIX}/data/room/29.yaml
+      - ${PREFIX}/data/room/30.yaml
+      - ${PREFIX}/data/room/31.yaml
+      - ${PREFIX}/data/room/32.yaml
+      - ${PREFIX}/data/room/33.yaml
+      - ${PREFIX}/data/room/34.yaml
+      - ${PREFIX}/data/room/35.yaml
+      - ${PREFIX}/data/room/36.yaml
+      - ${PREFIX}/data/room/37.yaml
+      - ${PREFIX}/data/room/38.yaml
+      - ${PREFIX}/data/room/39.yaml
+      - ${PREFIX}/data/room/40.yaml
+      - ${PREFIX}/data/room/41.yaml
+      - ${PREFIX}/data/room/42.yaml
+      - ${PREFIX}/data/room/43.yaml
+      - ${PREFIX}/data/room/44.yaml
+      - ${PREFIX}/data/room/45.yaml
+      - ${PREFIX}/data/room/46.yaml
+      - ${PREFIX}/data/room/47.yaml
+      - ${PREFIX}/data/room/48.yaml
+      - ${PREFIX}/data/room/49.yaml
+      - ${PREFIX}/data/room/50.yaml
+      - ${PREFIX}/data/room/51.yaml
+      - ${PREFIX}/data/room/52.yaml
+      - ${PREFIX}/data/room/53.yaml
+      - ${PREFIX}/data/room/54.yaml
+      - ${PREFIX}/data/room/55.yaml
+      - ${PREFIX}/data/room/56.yaml
+      - ${PREFIX}/data/room/57.yaml
+      - ${PREFIX}/data/room/58.yaml
+      - ${PREFIX}/data/room/59.yaml
+      - ${PREFIX}/data/room/60.yaml
+
+  # TILESETS
+  tilesets:
+    BITMAP:
+      - ${PREFIX}/data/tilesets/standard.gif
+
+  # ENEMIES
+  enemies:
+    ANIMATION:
+      - ${PREFIX}/data/enemies/abad_bell.yaml
+      - ${PREFIX}/data/enemies/abad.yaml
+      - ${PREFIX}/data/enemies/amstrad_cs.yaml
+      - ${PREFIX}/data/enemies/flying_arounder.yaml
+      - ${PREFIX}/data/enemies/stopped_arounder.yaml
+      - ${PREFIX}/data/enemies/walking_arounder.yaml
+      - ${PREFIX}/data/enemies/arounders_door.yaml
+      - ${PREFIX}/data/enemies/arounders_machine.yaml
+      - ${PREFIX}/data/enemies/bat.yaml
+      - ${PREFIX}/data/enemies/batman_bell.yaml
+      - ${PREFIX}/data/enemies/batman_fire.yaml
+      - ${PREFIX}/data/enemies/batman.yaml
+      - ${PREFIX}/data/enemies/bell.yaml
+      - ${PREFIX}/data/enemies/bin.yaml
+      - ${PREFIX}/data/enemies/bird.yaml
+      - ${PREFIX}/data/enemies/breakout.yaml
+      - ${PREFIX}/data/enemies/bry.yaml
+      - ${PREFIX}/data/enemies/chip.yaml
+      - ${PREFIX}/data/enemies/code.yaml
+      - ${PREFIX}/data/enemies/congo.yaml
+      - ${PREFIX}/data/enemies/crosshair.yaml
+      - ${PREFIX}/data/enemies/demon.yaml
+      - ${PREFIX}/data/enemies/dimallas.yaml
+      - ${PREFIX}/data/enemies/floppy.yaml
+      - ${PREFIX}/data/enemies/dong.yaml
+      - ${PREFIX}/data/enemies/guitar.yaml
+      - ${PREFIX}/data/enemies/heavy.yaml
+      - ${PREFIX}/data/enemies/jailer1.yaml
+      - ${PREFIX}/data/enemies/jailer2.yaml
+      - ${PREFIX}/data/enemies/jailer3.yaml
+      - ${PREFIX}/data/enemies/jailbattle_alien.yaml
+      - ${PREFIX}/data/enemies/jailbattle_human.yaml
+      - ${PREFIX}/data/enemies/jeannine.yaml
+      - ${PREFIX}/data/enemies/lamp.yaml
+      - ${PREFIX}/data/enemies/lord_abad.yaml
+      - ${PREFIX}/data/enemies/matatunos.yaml
+      - ${PREFIX}/data/enemies/mummy.yaml
+      - ${PREFIX}/data/enemies/paco.yaml
+      - ${PREFIX}/data/enemies/elsa.yaml
+      - ${PREFIX}/data/enemies/qvoid.yaml
+      - ${PREFIX}/data/enemies/robot.yaml
+      - ${PREFIX}/data/enemies/sam.yaml
+      - ${PREFIX}/data/enemies/shock.yaml
+      - ${PREFIX}/data/enemies/sigmasua.yaml
+      - ${PREFIX}/data/enemies/spark.yaml
+      - ${PREFIX}/data/enemies/special/aerojailer.yaml
+      - ${PREFIX}/data/enemies/special/arounder.yaml
+      - ${PREFIX}/data/enemies/special/pepe_rosita_job.yaml
+      - ${PREFIX}/data/enemies/special/shooting_star.yaml
+      - ${PREFIX}/data/enemies/spider.yaml
+      - ${PREFIX}/data/enemies/tree_thing.yaml
+      - ${PREFIX}/data/enemies/tuno.yaml
+      - ${PREFIX}/data/enemies/tv_panel.yaml
+      - ${PREFIX}/data/enemies/tv.yaml
+      - ${PREFIX}/data/enemies/upv_student.yaml
+      - ${PREFIX}/data/enemies/wave.yaml
+      - ${PREFIX}/data/enemies/z80.yaml
+    BITMAP:
+      - ${PREFIX}/data/enemies/abad_bell.gif
+      - ${PREFIX}/data/enemies/abad.gif
+      - ${PREFIX}/data/enemies/amstrad_cs.gif
+      - ${PREFIX}/data/enemies/flying_arounder.gif
+      - ${PREFIX}/data/enemies/stopped_arounder.gif
+      - ${PREFIX}/data/enemies/walking_arounder.gif
+      - ${PREFIX}/data/enemies/arounders_door.gif
+      - ${PREFIX}/data/enemies/arounders_machine.gif
+      - ${PREFIX}/data/enemies/bat.gif
+      - ${PREFIX}/data/enemies/batman_bell.gif
+      - ${PREFIX}/data/enemies/batman_fire.gif
+      - ${PREFIX}/data/enemies/batman.gif
+      - ${PREFIX}/data/enemies/bell.gif
+      - ${PREFIX}/data/enemies/bin.gif
+      - ${PREFIX}/data/enemies/bird.gif
+      - ${PREFIX}/data/enemies/breakout.gif
+      - ${PREFIX}/data/enemies/bry.gif
+      - ${PREFIX}/data/enemies/chip.gif
+      - ${PREFIX}/data/enemies/code.gif
+      - ${PREFIX}/data/enemies/congo.gif
+      - ${PREFIX}/data/enemies/crosshair.gif
+      - ${PREFIX}/data/enemies/demon.gif
+      - ${PREFIX}/data/enemies/dimallas.gif
+      - ${PREFIX}/data/enemies/floppy.gif
+      - ${PREFIX}/data/enemies/dong.gif
+      - ${PREFIX}/data/enemies/guitar.gif
+      - ${PREFIX}/data/enemies/heavy.gif
+      - ${PREFIX}/data/enemies/jailer1.gif
+      - ${PREFIX}/data/enemies/jailer2.gif
+      - ${PREFIX}/data/enemies/jailer3.gif
+      - ${PREFIX}/data/enemies/jailbattle_alien.gif
+      - ${PREFIX}/data/enemies/jailbattle_human.gif
+      - ${PREFIX}/data/enemies/jeannine.gif
+      - ${PREFIX}/data/enemies/lamp.gif
+      - ${PREFIX}/data/enemies/lord_abad.gif
+      - ${PREFIX}/data/enemies/matatunos.gif
+      - ${PREFIX}/data/enemies/mummy.gif
+      - ${PREFIX}/data/enemies/paco.gif
+      - ${PREFIX}/data/enemies/elsa.gif
+      - ${PREFIX}/data/enemies/qvoid.gif
+      - ${PREFIX}/data/enemies/robot.gif
+      - ${PREFIX}/data/enemies/sam.gif
+      - ${PREFIX}/data/enemies/shock.gif
+      - ${PREFIX}/data/enemies/sigmasua.gif
+      - ${PREFIX}/data/enemies/spark.gif
+      - ${PREFIX}/data/enemies/special/aerojailer.gif
+      - ${PREFIX}/data/enemies/special/arounder.gif
+      - ${PREFIX}/data/enemies/special/pepe_rosita_job.gif
+      - ${PREFIX}/data/enemies/special/shooting_star.gif
+      - ${PREFIX}/data/enemies/spider.gif
+      - ${PREFIX}/data/enemies/tree_thing.gif
+      - ${PREFIX}/data/enemies/tuno.gif
+      - ${PREFIX}/data/enemies/tv_panel.gif
+      - ${PREFIX}/data/enemies/tv.gif
+      - ${PREFIX}/data/enemies/upv_student.gif
+      - ${PREFIX}/data/enemies/wave.gif
+      - ${PREFIX}/data/enemies/z80.gif
+
+  # PLAYER
+  player:
+    BITMAP:
+      - ${PREFIX}/data/player/player.gif
+      - ${PREFIX}/data/player/player2.gif
+      - ${PREFIX}/data/player/player_game_over.gif
+    ANIMATION:
+      - ${PREFIX}/data/player/player.yaml
+      - ${PREFIX}/data/player/player2.yaml
+      - ${PREFIX}/data/player/player_game_over.yaml
+
+  # ITEMS
+  items:
+    BITMAP:
+      - ${PREFIX}/data/items/items.gif
+
+  # MUSIC
+  music:
+    MUSIC:
+      - ${PREFIX}/data/music/title.ogg
+      - ${PREFIX}/data/music/game.ogg
+      - ${PREFIX}/data/music/loading_data1.ogg
+      - ${PREFIX}/data/music/loading_data2.ogg
+      - ${PREFIX}/data/music/loading_header.ogg
+      - ${PREFIX}/data/music/loading_screen_color.ogg
+      - ${PREFIX}/data/music/loading_screen_data.ogg
+      - ${PREFIX}/data/music/ending1.ogg
+      - ${PREFIX}/data/music/ending2.ogg
+      - ${PREFIX}/data/music/game_over.ogg
+
+  # SOUNDS
+  sounds:
+    SOUND:
+      - ${PREFIX}/data/sound/item.wav
+      - ${PREFIX}/data/sound/death.wav
+      - ${PREFIX}/data/sound/notify.wav
+      - ${PREFIX}/data/sound/jump1.wav
+      - ${PREFIX}/data/sound/jump2.wav
+      - ${PREFIX}/data/sound/jump3.wav
+      - ${PREFIX}/data/sound/jump4.wav
+      - ${PREFIX}/data/sound/jump5.wav
+      - ${PREFIX}/data/sound/jump6.wav
+      - ${PREFIX}/data/sound/jump7.wav
+      - ${PREFIX}/data/sound/jump8.wav
+      - ${PREFIX}/data/sound/jump9.wav
+      - ${PREFIX}/data/sound/jump10.wav
+      - ${PREFIX}/data/sound/jump11.wav
+      - ${PREFIX}/data/sound/jump12.wav
+      - ${PREFIX}/data/sound/jump13.wav
+      - ${PREFIX}/data/sound/jump14.wav
+      - ${PREFIX}/data/sound/jump15.wav
+      - ${PREFIX}/data/sound/jump16.wav
+      - ${PREFIX}/data/sound/jump17.wav
+      - ${PREFIX}/data/sound/jump18.wav
+      - ${PREFIX}/data/sound/jump19.wav
+      - ${PREFIX}/data/sound/jump20.wav
+      - ${PREFIX}/data/sound/jump21.wav
+      - ${PREFIX}/data/sound/jump22.wav
+      - ${PREFIX}/data/sound/jump23.wav
+      - ${PREFIX}/data/sound/jump24.wav
+
+  # LOGO
+  logo:
+    BITMAP:
+      - ${PREFIX}/data/logo/jailgames.gif
+      - ${PREFIX}/data/logo/since_1998.gif
+
+  # LOADING
+  loading:
+    BITMAP:
+      - ${PREFIX}/data/loading/loading_screen_bn.gif
+      - ${PREFIX}/data/loading/loading_screen_color.gif
+      - ${PREFIX}/data/loading/program_jaildoc.gif
+
+  # TITLE
+  title:
+    BITMAP:
+      - ${PREFIX}/data/title/title_logo.gif
+
+  # ENDING
+  ending:
+    BITMAP:
+      - ${PREFIX}/data/ending/ending1.gif
+      - ${PREFIX}/data/ending/ending2.gif
+      - ${PREFIX}/data/ending/ending3.gif
+      - ${PREFIX}/data/ending/ending4.gif
+      - ${PREFIX}/data/ending/ending5.gif
+
+  # CREDITS
+  credits:
+    BITMAP:
+      - ${PREFIX}/data/credits/shine.gif
+    ANIMATION:
+      - ${PREFIX}/data/credits/shine.yaml

data/console/commands.yaml

@@ -0,0 +1,286 @@
+# JailDoctor's Dilemma - Console Commands
+# Metadata for the in-game console command system.
+# Execution logic stays in C++; this file defines metadata only.
+#
+# Fields:
+#   keyword          - Command name (uppercase)
+#   handler          - C++ handler function identifier
+#   description      - Short description for help output
+#   usage            - Full usage string for terminal help
+#   instant          - (optional) Skip typewriter effect (default: false)
+#   hidden           - (optional) Hide from TAB completion (default: false)
+#   debug_only       - (optional) Only available in debug builds (default: false)
+#   help_hidden      - (optional) Don't show in help output (default: false)
+#   dynamic_completions - (optional) Completions generated at runtime (default: false)
+#   completions      - (optional) Static TAB completion tree
+#   debug_extras     - (optional) Overrides applied in debug builds
+#   scope            - (optional) Visibility scope: global, game, editor, debug (default: global)
+#                      Can be a string or a list. Categories can set a default scope for all commands.
+
+categories:
+  - name: VIDEO
+    scope: game
+    commands:
+      - keyword: SS
+        handler: cmd_ss
+        description: Supersampling
+        usage: "SS [ON|OFF|SIZE|UPSCALE [NEAREST|LINEAR]|DOWNSCALE [BILINEAR|LANCZOS2|LANCZOS3]]"
+        completions:
+          SS: [ON, OFF, SIZE, UPSCALE, DOWNSCALE]
+          SS UPSCALE: [NEAREST, LINEAR]
+          SS DOWNSCALE: [BILINEAR, LANCZOS2, LANCZOS3]
+
+      - keyword: SHADER
+        handler: cmd_shader
+        description: "Toggle/select shader (F4)"
+        usage: "SHADER [ON|OFF|NEXT|POSTFX|CRTPI|PRESET [NEXT|PREV|<name>]]"
+        completions:
+          SHADER: [ON, OFF, NEXT, POSTFX, CRTPI, PRESET]
+        dynamic_completions: true
+
+      - keyword: BORDER
+        handler: cmd_border
+        description: "Decorative border (B)"
+        usage: "BORDER [ON|OFF]"
+        completions:
+          BORDER: [ON, OFF]
+
+      - keyword: FULLSCREEN
+        handler: cmd_fullscreen
+        description: "Fullscreen mode (F3)"
+        usage: "FULLSCREEN [ON|OFF]"
+        completions:
+          FULLSCREEN: [ON, OFF]
+
+      - keyword: ZOOM
+        handler: cmd_zoom
+        description: "Window zoom (F1/F2)"
+        usage: "ZOOM [UP|DOWN|<1-N>]"
+        completions:
+          ZOOM: [UP, DOWN]
+
+      - keyword: INTSCALE
+        handler: cmd_intscale
+        description: "Integer scaling (F7)"
+        usage: "INTSCALE [ON|OFF]"
+        completions:
+          INTSCALE: [ON, OFF]
+
+      - keyword: VSYNC
+        handler: cmd_vsync
+        description: "Vertical sync"
+        usage: "VSYNC [ON|OFF]"
+        completions:
+          VSYNC: [ON, OFF]
+
+      - keyword: DRIVER
+        handler: cmd_driver
+        description: "GPU driver (restart to apply)"
+        usage: "DRIVER [LIST|AUTO|NONE|<name>]"
+        completions:
+          DRIVER: [LIST, AUTO, NONE]
+
+      - keyword: PALETTE
+        handler: cmd_palette
+        description: "Color palette (F5/F6)"
+        usage: "PALETTE [NEXT|PREV|SORT [ORIGINAL|LUMINANCE|SPECTRUM]|DEFAULT|<name>]"
+        completions:
+          PALETTE SORT: [ORIGINAL, LUMINANCE, SPECTRUM]
+        dynamic_completions: true
+
+  - name: AUDIO
+    scope: game
+    commands:
+      - keyword: AUDIO
+        handler: cmd_audio
+        description: Audio master
+        usage: "AUDIO [ON|OFF|VOL <0-100>]"
+        completions:
+          AUDIO: [ON, OFF, VOL]
+
+      - keyword: MUSIC
+        handler: cmd_music
+        description: Music volume
+        usage: "MUSIC [ON|OFF|VOL <0-100>]"
+        completions:
+          MUSIC: [ON, OFF, VOL]
+
+      - keyword: SOUND
+        handler: cmd_sound
+        description: Sound volume
+        usage: "SOUND [ON|OFF|VOL <0-100>]"
+        completions:
+          SOUND: [ON, OFF, VOL]
+
+  - name: GAME
+    scope: game
+    commands:
+      - keyword: PLAYER
+        handler: cmd_player
+        description: "Player skin and color"
+        usage: "PLAYER SKIN <name> | PLAYER COLOR <0-15>|DEFAULT"
+        completions:
+          PLAYER: [SKIN, COLOR]
+          PLAYER SKIN: [DEFAULT, ABAD, BATMAN, CHIP, CONGO, JEANNINE, MUMMY, UPV_STUDENT]
+          PLAYER COLOR: [DEFAULT]
+
+      - keyword: RESTART
+        handler: cmd_restart
+        description: Restart from the beginning
+        usage: RESTART
+        instant: true
+
+      - keyword: KIOSK
+        handler: cmd_kiosk
+        description: Enable kiosk mode
+        usage: "KIOSK [ON]"
+        completions:
+          KIOSK: [ON]
+
+      - keyword: EXIT
+        handler: cmd_exit
+        description: Quit application
+        usage: EXIT
+        instant: true
+        scope: global
+
+      - keyword: QUIT
+        handler: cmd_quit
+        description: Quit application
+        usage: QUIT
+        instant: true
+        help_hidden: true
+        scope: global
+
+  - name: INFO
+    scope: global
+    commands:
+      - keyword: SHOW
+        handler: cmd_show
+        description: Show info overlay
+        usage: "SHOW [INFO]"
+        completions:
+          SHOW: [INFO]
+        debug_extras:
+          description: "Show overlay/test notification"
+          usage: "SHOW [INFO|NOTIFICATION|CHEEVO]"
+          completions:
+            SHOW: [INFO, NOTIFICATION, CHEEVO]
+
+      - keyword: HIDE
+        handler: cmd_hide
+        description: Hide info overlay
+        usage: "HIDE [INFO]"
+        completions:
+          HIDE: [INFO]
+
+      - keyword: SIZE
+        handler: cmd_size
+        description: Window size in pixels
+        usage: SIZE
+
+      - keyword: HELP
+        handler: cmd_help
+        description: "Show this help"
+        usage: "HELP [<command>]"
+        dynamic_completions: true
+
+      - keyword: "?"
+        handler: cmd_help
+        help_hidden: true
+
+  - name: DEBUG
+    debug_only: true
+    scope: debug
+    commands:
+      - keyword: DEBUG
+        handler: cmd_debug
+        description: "Debug mode and start options (F12)"
+        usage: "DEBUG [MODE [ON|OFF]|START [HERE|ROOM|POS|SCENE <name>]]"
+        completions:
+          DEBUG: [MODE, START]
+          DEBUG MODE: [ON, OFF]
+          DEBUG START: [HERE, ROOM, POS, SCENE]
+          DEBUG START SCENE: [LOGO, LOADING, TITLE, CREDITS, GAME, ENDING, ENDING2]
+
+      - keyword: ITEMS
+        handler: cmd_items
+        description: "Set item count (GAME only)"
+        usage: "ITEMS <0-200>"
+
+      - keyword: ROOM
+        handler: cmd_room
+        description: "Change to room number (GAME only)"
+        usage: "ROOM <1-60>|NEXT|PREV|LEFT|RIGHT|UP|DOWN"
+        scope: [debug, editor]
+        completions:
+          ROOM: [NEXT, PREV, LEFT, RIGHT, UP, DOWN, NEW, DELETE]
+          ROOM NEW: [LEFT, RIGHT, UP, DOWN]
+
+      - keyword: SCENE
+        handler: cmd_scene
+        description: Change scene
+        usage: "SCENE [LOGO|LOADING|TITLE|CREDITS|GAME|ENDING|ENDING2|RESTART]"
+        completions:
+          SCENE: [LOGO, LOADING, TITLE, CREDITS, GAME, ENDING, ENDING2, RESTART]
+
+      - keyword: EDIT
+        handler: cmd_edit
+        description: "Map editor mode (GAME only)"
+        usage: "EDIT [ON|OFF|REVERT|SHOW|HIDE|MAPBG|MAPCONN] [...]"
+        scope: [debug, editor]
+        dynamic_completions: true
+        completions:
+          EDIT: [ON, OFF, REVERT, SHOW, HIDE, MAPBG, MAPCONN]
+          EDIT SHOW: [INFO, GRID]
+          EDIT HIDE: [INFO, GRID]
+
+  - name: EDITOR
+    debug_only: true
+    scope: editor
+    commands:
+      - keyword: ENEMY
+        handler: cmd_enemy
+        description: "Add, delete or duplicate enemy"
+        usage: "ENEMY <ADD|DELETE|DUPLICATE>"
+        completions:
+          ENEMY: [ADD, DELETE, DUPLICATE]
+
+      - keyword: ITEM
+        handler: cmd_item
+        description: "Add, delete or duplicate item"
+        usage: "ITEM <ADD|DELETE|DUPLICATE>"
+        completions:
+          ITEM: [ADD, DELETE, DUPLICATE]
+
+      - keyword: SET
+        handler: cmd_set
+        description: "Set property (enemy, item or room)"
+        usage: "SET <property> <value>"
+        dynamic_completions: true
+        completions:
+          SET FLIP: [ON, OFF]
+          SET MIRROR: [ON, OFF]
+          SET CONVEYOR: [LEFT, NONE, RIGHT]
+
+  - name: CHEATS
+    scope: [game, editor]
+    commands:
+      - keyword: CHEAT
+        handler: cmd_cheat
+        description: "Game cheats (GAME only)"
+        usage: "CHEAT [INFINITE LIVES|INVINCIBILITY|OPEN THE JAIL|CLOSE THE JAIL]"
+        hidden: true
+        help_hidden: true
+        completions:
+          CHEAT: [INFINITE, INVINCIBILITY, OPEN, CLOSE]
+          CHEAT INFINITE: [LIVES]
+          CHEAT INFINITE LIVES: [ON, OFF]
+          CHEAT INVINCIBILITY: [ON, OFF]
+          CHEAT OPEN: [THE]
+          CHEAT OPEN THE: [JAIL]
+          CHEAT CLOSE: [THE]
+          CHEAT CLOSE THE: [JAIL]
+        debug_extras:
+          hidden: false
+          help_hidden: false

data/credits/shine.ani

@@ -1,9 +0,0 @@
-frame_width=8
-frame_height=8
-
-[animation]
-name=default
-speed=6
-loop=-1
-frames=0,1,2,3,4,5,6,7
-[/animation]

data/credits/shine.yaml

@@ -0,0 +1,10 @@
+# shine animation
+tileSetFile: shine.gif
+frameWidth: 8
+frameHeight: 8
+
+animations:
+  - name: default
+    speed: 0.1
+    loop: -1
+    frames: [0, 1, 2, 3, 4, 5, 6, 7]

data/enemies/abad.ani

@@ -1,9 +0,0 @@
-frame_width=8
-frame_height=16
-
-[animation]
-name=default
-speed=8
-loop=0
-frames=0,1,2
-[/animation]

data/enemies/abad.yaml

@@ -0,0 +1,10 @@
+# abad animation
+tileSetFile: abad.gif
+frameWidth: 8
+frameHeight: 16
+
+animations:
+  - name: default
+    speed: 0.1333
+    loop: 0
+    frames: [0, 1, 2]

data/enemies/abad_bell.ani

@@ -1,9 +0,0 @@
-frame_width=16
-frame_height=16
-
-[animation]
-name=default
-speed=4
-loop=0
-frames=0,1,2,3,4,5,6,7,8,9
-[/animation]

data/enemies/abad_bell.yaml

@@ -0,0 +1,10 @@
+# abad_bell animation
+tileSetFile: abad_bell.gif
+frameWidth: 16
+frameHeight: 16
+
+animations:
+  - name: default
+    speed: 0.0667
+    loop: 0
+    frames: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]

data/enemies/amstrad_cs.ani

@@ -1,9 +0,0 @@
-frame_width=8
-frame_height=8
-
-[animation]
-name=default
-speed=4
-loop=0
-frames=0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147,148,149,150,151,152,153,154,155,156,157,158,159,160,161,162,163,164,165,166,167,168,169,170,171,172,173,174,175,176,177,178,179,180,181,182,183,184,185,186,187,188,189,190,191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,239,240,241,242,243,244,245,246,247,248,249,250,251,252,253,254,255
-[/animation]

data/enemies/amstrad_cs.yaml

@@ -0,0 +1,10 @@
+# amstrad_cs animation
+tileSetFile: amstrad_cs.gif
+frameWidth: 8
+frameHeight: 8
+
+animations:
+  - name: default
+    speed: 0.0667
+    loop: 0
+    frames: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255]

data/enemies/arounders_door.ani

@@ -1,9 +0,0 @@
-frame_width=16
-frame_height=16
-
-[animation]
-name=default
-speed=8
-loop=0
-frames=0,1,2,3,3,3,3,3,3,3,3,3,3,3,3,2,1,0,0,0
-[/animation]

data/enemies/arounders_door.yaml

@@ -0,0 +1,10 @@
+# arounders_door animation
+tileSetFile: arounders_door.gif
+frameWidth: 16
+frameHeight: 16
+
+animations:
+  - name: default
+    speed: 0.1333
+    loop: 0
+    frames: [0, 1, 2, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 2, 1, 0, 0, 0]

data/enemies/arounders_machine.ani

@@ -1,9 +0,0 @@
-frame_width=16
-frame_height=16
-
-[animation]
-name=default
-speed=4
-loop=0
-frames=0,1,2,3
-[/animation]

data/enemies/arounders_machine.yaml

@@ -0,0 +1,10 @@
+# arounders_machine animation
+tileSetFile: arounders_machine.gif
+frameWidth: 16
+frameHeight: 16
+
+animations:
+  - name: default
+    speed: 0.0667
+    loop: 0
+    frames: [0, 1, 2, 3]

data/enemies/bat.ani

@@ -1,9 +0,0 @@
-frame_width=9
-frame_height=7
-
-[animation]
-name=default
-speed=3
-loop=0
-frames=0,1
-[/animation]

data/enemies/bat.yaml

@@ -0,0 +1,10 @@
+# bat animation
+tileSetFile: bat.gif
+frameWidth: 9
+frameHeight: 7
+
+animations:
+  - name: default
+    speed: 0.05
+    loop: 0
+    frames: [0, 1]

data/enemies/batman.ani

@@ -1,9 +0,0 @@
-frame_width=8
-frame_height=16
-
-[animation]
-name=default
-speed=8
-loop=0
-frames=0,1,2,3
-[/animation]

data/enemies/batman.yaml

@@ -0,0 +1,10 @@
+# batman animation
+tileSetFile: batman.gif
+frameWidth: 8
+frameHeight: 16
+
+animations:
+  - name: default
+    speed: 0.1333
+    loop: 0
+    frames: [0, 1, 2, 3]

data/enemies/batman_bell.ani

@@ -1,9 +0,0 @@
-frame_width=16
-frame_height=16
-
-[animation]
-name=default
-speed=6
-loop=0
-frames=0,1,2,3,4,5
-[/animation]

data/enemies/batman_bell.yaml

@@ -0,0 +1,10 @@
+# batman_bell animation
+tileSetFile: batman_bell.gif
+frameWidth: 16
+frameHeight: 16
+
+animations:
+  - name: default
+    speed: 0.1
+    loop: 0
+    frames: [0, 1, 2, 3, 4, 5]

data/enemies/batman_fire.ani

@@ -1,9 +0,0 @@
-frame_width=16
-frame_height=16
-
-[animation]
-name=default
-speed=4
-loop=0
-frames=0,1,2,3
-[/animation]

data/enemies/batman_fire.yaml

@@ -0,0 +1,10 @@
+# batman_fire animation
+tileSetFile: batman_fire.gif
+frameWidth: 16
+frameHeight: 16
+
+animations:
+  - name: default
+    speed: 0.0667
+    loop: 0
+    frames: [0, 1, 2, 3]

data/enemies/bell.ani

@@ -1,9 +0,0 @@
-frame_width=16
-frame_height=16
-
-[animation]
-name=default
-speed=6
-loop=0
-frames=0,1,2,3,4,5,6,7,8,9,10,11
-[/animation]

data/enemies/bell.yaml

@@ -0,0 +1,10 @@
+# bell animation
+tileSetFile: bell.gif
+frameWidth: 16
+frameHeight: 16
+
+animations:
+  - name: default
+    speed: 0.1
+    loop: 0
+    frames: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]

data/enemies/bin.ani

@@ -1,9 +0,0 @@
-frame_width=16
-frame_height=8
-
-[animation]
-name=default
-speed=10
-loop=0
-frames=0,1,2,3,4
-[/animation]

data/enemies/bin.yaml

@@ -0,0 +1,10 @@
+# bin animation
+tileSetFile: bin.gif
+frameWidth: 16
+frameHeight: 8
+
+animations:
+  - name: default
+    speed: 0.1667
+    loop: 0
+    frames: [0, 1, 2, 3, 4]

data/enemies/bird.ani

@@ -1,9 +0,0 @@
-frame_width=16
-frame_height=16
-
-[animation]
-name=default
-speed=8
-loop=0
-frames=0,1,2,3
-[/animation]

data/enemies/bird.yaml

@@ -0,0 +1,10 @@
+# bird animation
+tileSetFile: bird.gif
+frameWidth: 16
+frameHeight: 16
+
+animations:
+  - name: default
+    speed: 0.1333
+    loop: 0
+    frames: [0, 1, 2, 3]

data/enemies/breakout.ani

@@ -1,9 +0,0 @@
-frame_width=24
-frame_height=32
-
-[animation]
-name=default
-speed=6
-loop=0
-frames=0,1,2,3,4,5,6,7,6,5,4,3,2,1
-[/animation]

data/enemies/breakout.yaml

@@ -0,0 +1,10 @@
+# breakout animation
+tileSetFile: breakout.gif
+frameWidth: 24
+frameHeight: 32
+
+animations:
+  - name: default
+    speed: 0.1
+    loop: 0
+    frames: [0, 1, 2, 3, 4, 5, 6, 7, 6, 5, 4, 3, 2, 1]

data/enemies/bry.ani

@@ -1,9 +0,0 @@
-frame_width=10
-frame_height=16
-
-[animation]
-name=default
-speed=6
-loop=0
-frames=0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,0,1,2,3,4,5,4,5,4,5,4,5,4,5,4,5,4,5,4,5,4,5,4,5,4,5,4,5
-[/animation]

data/enemies/bry.yaml

@@ -0,0 +1,10 @@
+# bry animation
+tileSetFile: bry.gif
+frameWidth: 10
+frameHeight: 16
+
+animations:
+  - name: default
+    speed: 0.1
+    loop: 0
+    frames: [0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 4, 5, 4, 5, 4, 5, 4, 5, 4, 5, 4, 5, 4, 5, 4, 5, 4, 5, 4, 5, 4, 5, 4, 5]

data/enemies/chip.ani

@@ -1,9 +0,0 @@
-frame_width=8
-frame_height=16
-
-[animation]
-name=default
-speed=8
-loop=0
-frames=0,1,2,3
-[/animation]

data/enemies/chip.yaml

@@ -0,0 +1,10 @@
+# chip animation
+tileSetFile: chip.gif
+frameWidth: 8
+frameHeight: 16
+
+animations:
+  - name: default
+    speed: 0.1333
+    loop: 0
+    frames: [0, 1, 2, 3]

data/enemies/code.ani

@@ -1,9 +0,0 @@
-frame_width=16
-frame_height=16
-
-[animation]
-name=default
-speed=6
-loop=0
-frames=0,1,2,3
-[/animation]

data/enemies/code.yaml

@@ -0,0 +1,10 @@
+# code animation
+tileSetFile: code.gif
+frameWidth: 16
+frameHeight: 16
+
+animations:
+  - name: default
+    speed: 0.1
+    loop: 0
+    frames: [0, 1, 2, 3]

data/enemies/congo.ani

@@ -1,9 +0,0 @@
-frame_width=8
-frame_height=16
-
-[animation]
-name=default
-speed=6
-loop=0
-frames=0,1,2,3
-[/animation]