← Retour aux activités

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 :

# Commande à taper dans le terminal pour installer Pyxel
pip install pyxel
💡 Le savais-tu ? Pyxel est un moteur de jeu limité à 16 couleurs et une résolution fixe, ce qui permet de se concentrer sur le code plutôt que sur des graphismes complexes !

Comment s'appelle l'outil intégré pour dessiner des sprites dans Pyxel ?

C'est Pyxel Edit ! Tu peux le lancer en tapant 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 :

import pyxel

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 ?

Le texte s'affichera en Rouge (couleur 8). Voici les couleurs principales : 0=Noir, 7=Blanc, 8=Rouge, 11=Vert, 12=Bleu.

03 Créer du mouvement

Pour bouger un personnage, on doit utiliser des variables pour stocker sa position $(x, y)$.

import pyxel

# 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 ?

Il suffit de changer la valeur ajoutée à chaque appui. Par exemple : 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.

# En haut du fichier
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 = 0 juste après la collision, on donne l'impression que l'ennemi a été "éliminé" ou collecté.

Comment afficher le score sur l'écran ?

Dans la fonction 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.

tirs = [] # Liste vide au début

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.

import random

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.

def draw():
    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 :

  1. x, y : Position sur l'écran.
  2. img : Numéro de la banque d'image (0 à 2).
  3. u, v : Coordonnées du sprite dans l'éditeur (ex: 0, 0 pour le premier coin).
  4. w, h : Largeur et Hauteur (souvent 8, 8).
  5. colkey : Couleur à rendre transparente (souvent 0 pour le noir).
🛠️ Important : N'oublie pas de charger tes ressources au début du programme avec 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 !

🚀 Commencer l'activité PAC-MAN