📄 Cheat sheet — La map des positions (le monde est un Hash)

Ton monde n'a pas de décor : il a une table. Une case = une adresse, une adresse = un sprite — et un mur, c'est une case déjà prise.

La map en 4 mots

Mot	Ce que c'est	Exemple
case	une adresse x,y	"3,4"
map	toutes les cases, un Hash	carte = {}
tic	une mise à jour	60 par seconde
mur	une case occupée	carte["5,5"] = "mur"

Une case = une adresse

def case_de(x, y)
  "#{x},#{y}"     # x d'abord, la virgule, y ensuite
end

case_de(3, 4)     # => "3,4"

Toute la case tient dans une chaîne : c'est la clé de ton Hash. 4,3 est une autre case.

Loger un sprite : on copie, on ne détruit pas

def pose(carte, x, y, nom)
  carte.merge("#{x},#{y}" => nom)   # nouveau Hash, original intact
end

pose({}, 1, 2, "joueur")   # => { "1,2" => "joueur" }

merge copie, = détruit. Depuis la leçon 6, la règle n'a pas bougé — appliquée au monde entier.

Occupée ou vide : key? vs valeur

carte = { "3,4" => "joueur" }

carte.key?("3,4")   # => true   l'ADRESSE existe
carte.key?("0,0")   # => false  personne n'y loge
carte["0,0"]        # => nil    le vide n'a pas de nom

key? te dit si la case est prise quelle que soit la valeur. C'est la question que le jeu pose soixante fois par seconde.

Qui rencontre qui

def rencontre(carte, x, y)
  carte["#{x},#{y}"]     # le nom… ou nil
end

rencontre(carte, 3, 4)   # => "joueur"
rencontre(carte, 0, 0)   # => nil

Un nil qui revient : rien sur la route. Un nom qui revient : dégât, pièce, dialogue — tout le gameplay part de ce retour.

60 mises à jour par seconde

def tic(secondes)
  secondes * 60      # une seconde de jeu = soixante relectures de la table
end

tic(1)               # => 60

À chaque tic : on relit la map, on déplace, on recompare. Le jeu ne bouge pas : il recalcule.

Face à un mur, l'avancée est impossible

def avance(carte, x, y, dx, dy)
  cible = "#{x + dx},#{y + dy}"
  carte.key?(cible) ? [x, y] : [x + dx, y + dy]
end

avance({}, 2, 2, 1, 0)                 # => [3, 2]  case libre : j'avance
avance({ "3,2" => "mur" }, 2, 2, 1, 0) # => [2, 2]  case prise : je reste

Pas de physique, pas de collision "du moteur" : une adresse déjà prise, un key?, un choix.

À ne plus jamais dire

• "le sprite heurte un mur" → la case d'arrivée est déjà dans la map — et tu renvoies l'ancienne position
• "il me faut un moteur de collision" → ton Hash fait ce travail depuis la leçon 3.

---

SlopCourse — du slop au code propre.