Ton premier jeu en Python
Apprends à coder un jeu "Retro" avec Pyxel de A à Z. Pas besoin d'être un expert, on commence doucement !
01 Installation & Setup
On va utiliser Visual Studio Code pour écrire notre code. Suis bien ces étapes :
-
1Crée un dossier nommé
mon_jeusur ton bureau. -
2Ouvre VS Code, puis va dans Fichier > Ouvrir le dossier et choisis ton dossier.
-
3Crée un nouveau fichier appelé
main.py. -
4Ouvre le terminal (Menu Terminal > Nouveau Terminal) et tape :
pip install pyxel
Comment s'appelle l'outil intégré pour dessiner des sprites dans Pyxel ?
pyxel edit dans ton terminal.
02 Le Squelette du Jeu
Un jeu Pyxel a toujours la même structure. Il y a deux fonctions essentielles :
update(): S'exécute 30 fois par seconde (pour la logique, les points, les touches).draw(): S'exécute aussi 30 fois par seconde (uniquement pour dessiner).
def update():
# Si on appuie sur la touche Q, le jeu se ferme
if pyxel.btnp(pyxel.KEY_Q):
pyxel.quit()
def draw():
# On vide l'écran avec du noir (couleur 0)
pyxel.cls(0)
# On écrit du texte en blanc (couleur 7)
pyxel.text(55, 60, "HELLO PIXELS!", 7)
# Initialise une fenêtre de 160x120 pixels
pyxel.init(160, 120, title="Mon Super Jeu")
# Lance le jeu !
pyxel.run(update, draw)
-
A
import pyxel: On demande à Python d'utiliser les outils Pyxel. -
B
pyxel.init(160, 120): On crée l'écran. 160 c'est la largeur, 120 la hauteur. -
C
pyxel.cls(0): Signifie **CL**ear **S**creen. On efface tout ce qu'il y avait avant pour redessiner l'image suivante.
Change le texte "HELLO PIXELS!" par ton prénom et change la couleur 7 par 8. Que se passe-t-il ?
03 Créer du mouvement
Pour bouger un personnage, on doit utiliser des variables pour stocker sa position $(x, y)$.
# Position de départ au centre
x = 80
y = 60
def update():
global x, y
if pyxel.btn(pyxel.KEY_RIGHT): x += 2
if pyxel.btn(pyxel.KEY_LEFT): x -= 2
if pyxel.btn(pyxel.KEY_UP): y -= 2
if pyxel.btn(pyxel.KEY_DOWN): y += 2
def draw():
pyxel.cls(0)
# Dessine un carré plein (Vaisseau) en (x,y)
pyxel.rect(x, y, 8, 8, 11)
pyxel.init(160, 120)
pyxel.run(update, draw)
Dans update, on vérifie si une touche est pressée :
x += 2: On ajoute 2 à la position horizontale vers la droite.global x, y: Indique à Python que les variables $x$ et $y$ appartiennent à tout le programme.pyxel.rect(x, y, 8, 8, 11): Dessine un rectangle de 8 pixels de large et 8 de haut en couleur 11 (vert).
🚀 Challenge : Peux-tu faire en sorte que le vaisseau bouge plus vite ?
x += 5 au lieu de x += 2.
04 Ajouter un ennemi (Collision)
Un jeu est drôle s'il y a un obstacle ! On va ajouter un carré rouge qui bouge tout seul.
ex, ey = 0, 0
score = 0
def update():
global x, y, ey, score
# ... (mouvement joueur)
ey += 1 # L'ennemi descend tout seul
if ey > 120: ey = 0
# TEST DE COLLISION
if abs(x - ex) < 8 and abs(y - ey) < 8:
score += 1
ey = 0 # Réinitialise l'ennemi
Le secret d'un bon jeu réside dans la précision des collisions :
abs(x - ex) < 8: On calcule la distance entre le joueur $(x)$ et l'ennemi $(ex)$. Si elle est inférieure à la largeur de l'objet (8 pixels), ils se touchent !- L'astuce : En réinitialisant
ey = 0juste après la collision, on donne l'impression que l'ennemi a été "éliminé" ou collecté.
Comment afficher le score sur l'écran ?
draw(), ajoute : pyxel.text(5, 5, f"SCORE: {score}", 7)
05 Les Tirs & Les Listes
Pour gérer plusieurs projectiles, on utilise une Liste. C'est comme un sac où on stocke chaque tir.
def update():
global x, y
# Créer un tir quand on appuie sur ESPACE
if pyxel.btnp(pyxel.KEY_SPACE):
tirs.append([x + 4, y])
# Faire avancer chaque tir
for t in tirs:
t[1] -= 4 # Monte vers le haut
if t[1] < 0: tirs.remove(t)
Une liste [] permet de stocker des éléments dynamiquement :
.append([x, y]): On ajoute un nouveau tir (un petit tableau de 2 coordonnées) à notre sac.for t in tirs: On parcourt chaque tir pour le mettre à jour..remove(t): Très important ! Si on ne supprime pas les tirs sortis de l'écran, le jeu va ramer.
06 Plusieurs Ennemis & Aléatoire
Rendons le jeu imprévisible avec le module random de Python.
ennemis = []
def update():
# On ajoute un ennemi au hasard (tous les ~2 secondes)
if pyxel.frame_count % 60 == 0:
ennemis.append([random.randint(0, 150), 0])
for e in ennemis:
e[1] += 2
if e[1] > 120: ennemis.remove(e)
Le module random permet de gérer la chance :
random.randint(min, max): Génère un nombre entier entre min et max. Ici, on place l'ennemi n'importe où sur la largeur.pyxel.frame_count: Compte le nombre d'images depuis le début. Comme il y a 30 FPS, un modulo de 60 arrive toutes les 2 secondes.
07 Utiliser des Sprites (Graphismes)
Remplacer les carrés par de vrais dessins ! Pyxel utilise une grille de $8 \times 8$ pixels pour ses banques d'images.
pyxel.cls(0)
# blt(x, y, img, u, v, w, h, colkey)
# Affiche le sprite de (0,0) dans la banque 0
pyxel.blt(x, y, 0, 0, 0, 8, 8, 0)
# Dessiner chaque ennemi (sprite en 8,0)
for e in ennemis:
pyxel.blt(e[0], e[1], 0, 8, 0, 8, 8, 0)
La fonction blt() est la plus importante pour les graphismes :
- x, y : Position sur l'écran.
- img : Numéro de la banque d'image (0 à 2).
- u, v : Coordonnées du sprite dans l'éditeur (ex: 0, 0 pour le premier coin).
- w, h : Largeur et Hauteur (souvent 8, 8).
- colkey : Couleur à rendre transparente (souvent 0 pour le noir).
pyxel.load("ton_fichier.pyxres") après le init.
PRO Mission : Créer un Pac-Man
Maintenant que tu as les bases, tente de réaliser un Pac-Man complet en 10 étapes progressives !