Grow maze size with level (7x7 -> 17x17, +2 per level)

The maze side length is now a runtime global 'map_size' (MAP_SIZE=7 at
level 1, +2 per level, capped at MAX_MAP_SIZE=17), while the maze array
is allocated with the MAX_MAP_SIZE bound. All modules (maze DFS, fog
rendering, player/enemy bounds, hatch and enemy-spawn placement) now use
map_size at runtime.

- globals: maze[MAX_MAP_SIZE][MAX_MAP_SIZE], map_size global, MAX_MAP_SIZE=17.
- maze.c: DFS on map_size; stack/valid arrays made static (WRAM) and sized
  for the max maze to avoid hardware-stack overflow; hatch min distance
  scales with map_size/2.
- engine.c: sets map_size from level before generate_maze; enemy spawn min
  distance scales with map_size/2.
- render.c: flush the full 32x32 background map (the old rows 2-17
  optimization broke for large mazes where the 5x5 fog window wraps outside
  that range); dynamic bounds; signed/unsigned casts.
- player_logic/enemy_logic: dynamic map_size bounds.

Verified via PyBoy: sizes 7,9,11,13,15,17,17 across levels 1-7, each with
a hatch; rendering and movement intact at 17x17 and at 7x7.
This commit is contained in:
2026-06-24 12:26:48 +02:00
parent 509f162380
commit 5e8709ade0
11 changed files with 112 additions and 90 deletions
+60 -58
View File
@@ -3,49 +3,56 @@
#include <string.h>
#include <rand.h>
// Capacita' massima degli array di appoggio (in WRAM, statici per non saturare
// lo stack hardware del LR35902). Le stanze del DFS sono le celle dispari:
// al massimo (MAX_MAP_SIZE/2)^2 = 8*8 = 64 per un labirinto 17x17.
#define MAX_ROOMS ((MAX_MAP_SIZE / 2) * (MAX_MAP_SIZE / 2))
#define MAX_CELLS (MAX_MAP_SIZE * MAX_MAP_SIZE)
// Array di appoggio statici (in WRAM, non sullo stack hardware).
static uint8_t stack_x[MAX_ROOMS];
static uint8_t stack_y[MAX_ROOMS];
static uint8_t valid_x[MAX_CELLS];
static uint8_t valid_y[MAX_CELLS];
/**
* Generates a randomized maze using a Depth-First Search (DFS) algorithm with backtracking.
*
*
* Sviluppo & Scelte Architetturali:
* 1. Perché DFS? Questo algoritmo è perfetto per labirinti garantendo che ogni cella sia
* raggiungibile partendo dall'inizio (nessuna isola irraggiungibile).
* 2. Il labirinto è una griglia MAP_SIZE x MAP_SIZE in cui le celle dispari (es. 1,1 o 3,3)
* sono le stanze, mentre le celle pari sono i muri divisori. Il DFS scava i muri saltando
* di 2 in 2 e abbattendo il muro in mezzo.
* 3. Abbiamo aggiunto una fase post-DFS che rimuove casualmente qualche muro rimasto (con
* il 15% di probabilità). Questo spezza la struttura "perfetta" del labirinto creando
* dei percorsi ciclici (loop). I loop sono vitali in un gioco con un nemico che ti insegue,
* permettendo al giocatore di aggirare il nemico scappando in cerchio.
* 4. La casella della VITTORIA viene piazzata alla fine. Usiamo la "Distanza di Manhattan"
* (somma della distanza X e Y) dalla partenza (1,1) per assicurarci che il traguardo
* sia la casella più lontana in assoluto.
* 1. Perché DFS? Garantisce che ogni cella sia raggiungibile dalla partenza (nessuna isola).
* 2. Il labirinto è una griglia map_size x map_size (cresce col livello, da MAP_SIZE a
* MAX_MAP_SIZE) in cui le celle dispari (1,1 o 3,3) sono le stanze e le pari sono i muri
* divisori. Il DFS scava i muri saltando di 2 in 2 e abbattendo il muro in mezzo.
* 3. Fase post-DFS: riapre casualmente il 15% dei muri per creare loop (vitali per
* aggirare l'inseguitore).
* 4. La BOTOLA (traguardo) viene piazzata su una cella a sufficiente distanza (Chebyshev
* >= map_size/2) dalla partenza (1,1), in modo che sia sempre lontana ma su qualunque tile.
*/
void generate_maze(void) {
// 1. Inizializziamo l'intera mappa a 0 (che rappresenta un Muro / Spazio Vuoto)
uint8_t sz = map_size;
// 1. Inizializziamo l'intera mappa a 0 (Muro / Spazio Vuoto)
memset(maze, 0, sizeof(maze));
// Stack array per il backtracking. La griglia 7x7 ha al massimo 49 celle dispari (stanze).
uint8_t stack_x[49];
uint8_t stack_y[49];
uint8_t stack_ptr = 0;
// Partiamo sempre dalle coordinate (1, 1) in alto a sinistra
uint8_t cx = 1;
uint8_t cy = 1;
maze[cy][cx] = 1; // 1 = Pavimento calpestabile
while (1) {
// Cerchiamo i vicini non visitati a distanza 2 (saltando il muro divisorio)
uint8_t nx[4];
uint8_t ny[4];
uint8_t count = 0;
// Su
if (cy >= 3 && maze[cy - 2][cx] == 0) {
nx[count] = cx; ny[count] = cy - 2; count++;
}
// Giù
if (cy <= MAP_SIZE - 4 && maze[cy + 2][cx] == 0) {
if (cy <= sz - 4 && maze[cy + 2][cx] == 0) {
nx[count] = cx; ny[count] = cy + 2; count++;
}
// Sinistra
@@ -53,49 +60,48 @@ void generate_maze(void) {
nx[count] = cx - 2; ny[count] = cy; count++;
}
// Destra
if (cx <= MAP_SIZE - 4 && maze[cy][cx + 2] == 0) {
if (cx <= sz - 4 && maze[cy][cx + 2] == 0) {
nx[count] = cx + 2; ny[count] = cy; count++;
}
// Se ci sono vicini validi
if (count > 0) {
// Scegli una direzione a caso tra quelle disponibili
uint8_t dir = rand() % count;
// Salviamo la cella corrente nello stack per poterci tornare
stack_x[stack_ptr] = cx;
stack_y[stack_ptr] = cy;
stack_ptr++;
// Abbattiamo il muro nel mezzo (calcolato facendo la media aritmetica delle coordinate)
// Abbattiamo il muro nel mezzo (media aritmetica delle coordinate)
maze[(cy + ny[dir]) / 2][(cx + nx[dir]) / 2] = 1;
// Spostiamo la posizione corrente sul vicino scelto
cx = nx[dir];
cy = ny[dir];
maze[cy][cx] = 1;
}
// Se non ci sono vicini, torna indietro prendendo l'ultima cella salvata dallo stack
}
// Se non ci sono vicini, torna indietro prendendo l'ultima cella dallo stack
else if (stack_ptr > 0) {
stack_ptr--;
cx = stack_x[stack_ptr];
cy = stack_y[stack_ptr];
}
}
// Se lo stack è vuoto, abbiamo visitato tutte le celle: il labirinto è completo!
else {
break;
}
}
// FASE 2: Riapriamo casualmente dei muri per creare percorsi alternativi e loop (15% chance).
// Questo è cruciale per la giocabilità: permette al giocatore di aggirare l'inseguitore!
for (uint8_t y = 1; y < MAP_SIZE - 1; y++) {
for (uint8_t x = 1; x < MAP_SIZE - 1; x++) {
// FASE 2: Riapriamo casualmente dei muri per creare percorsi alternativi e loop (15%).
// Cruciale per la giocabilità: permette al giocatore di aggirare l'inseguitore!
for (uint8_t y = 1; y < sz - 1; y++) {
for (uint8_t x = 1; x < sz - 1; x++) {
if (maze[y][x] == 0) {
// Se la casella è un muro che connette orizzontalmente o verticalmente due corridoi
// Muro che connette orizzontalmente o verticalmente due corridoi
if ((maze[y][x - 1] == 1 && maze[y][x + 1] == 1) ||
(maze[y - 1][x] == 1 && maze[y + 1][x] == 1)) {
// Genera numero casuale tra 0 e 99. Se < 15, trasforma in pavimento.
if ((rand() % 100) < 15) {
maze[y][x] = 1;
}
@@ -103,27 +109,24 @@ void generate_maze(void) {
}
}
}
// FASE 3: Posizionamento della Botola (Traguardo).
// La botola viene piazzata su una cella calpestabile a "sufficiente distanza"
// dalla casella di partenza del giocatore (1,1), cosi' che il traguardo sia
// sempre lontano ma possa trovarsi su una qualunque tile del labirinto,
// non piu' vincolato al bordo sud. Usiamo la distanza di Chebyshev
// (consistente con il resto dell'engine: fog of war, attivazione nemico).
#define MIN_GOAL_DIST 3
uint8_t valid_x[MAP_SIZE * MAP_SIZE];
uint8_t valid_y[MAP_SIZE * MAP_SIZE];
// La botola viene piazzata su una cella calpestabile a "sufficiente distanza" (Chebyshev
// >= map_size/2) dalla partenza (1,1): sempre lontana, ma su una qualunque tile.
// La soglia scala con la dimensione del labirinto (3 per 7x7, 8 per 17x17).
uint8_t min_goal = sz / 2;
if (min_goal < 3) min_goal = 3;
uint8_t num_valid = 0;
for (uint8_t y = 1; y < MAP_SIZE - 1; y++) {
for (uint8_t x = 1; x < MAP_SIZE - 1; x++) {
for (uint8_t y = 1; y < sz - 1; y++) {
for (uint8_t x = 1; x < sz - 1; x++) {
if (maze[y][x] == 1) {
int8_t dx = (int8_t)x - 1;
int8_t dy = (int8_t)y - 1;
if (dx < 0) dx = -dx;
if (dy < 0) dy = -dy;
int8_t dist = (dx > dy) ? dx : dy;
if (dist >= MIN_GOAL_DIST) {
if (dist >= (int8_t)min_goal) {
valid_x[num_valid] = x;
valid_y[num_valid] = y;
num_valid++;
@@ -140,14 +143,13 @@ void generate_maze(void) {
stairs_lx = target_x;
stairs_ly = target_y;
} else {
// Fallback estremo: nessuna cella a sufficienza distante (teoricamente
// impossibile in un perfect maze 7x7 con partenza 1,1, ma difensivo).
// Sceglie la cella calpestabile piu' lontana in assoluto da (1,1).
uint8_t best_x = MAP_SIZE - 2;
uint8_t best_y = MAP_SIZE - 2;
// Fallback estremo: nessuna cella a sufficienza distante. Sceglie la cella
// calpestabile piu' lontana in assoluto da (1,1).
uint8_t best_x = sz - 2;
uint8_t best_y = sz - 2;
int8_t best_dist = -1;
for (uint8_t y = 1; y < MAP_SIZE - 1; y++) {
for (uint8_t x = 1; x < MAP_SIZE - 1; x++) {
for (uint8_t y = 1; y < sz - 1; y++) {
for (uint8_t x = 1; x < sz - 1; x++) {
if (maze[y][x] == 1) {
int8_t dx = (int8_t)x - 1;
int8_t dy = (int8_t)y - 1;
@@ -166,4 +168,4 @@ void generate_maze(void) {
stairs_lx = best_x;
stairs_ly = best_y;
}
}
}