Skip to main content

Guide d'utilisation rapide du package lplateforme pour la création d'un jeu de plateforme

Introduction

Le package lplateforme permet de créer facilement des jeux de plateforme en Python. Il fournit des outils pour gérer les objets, les plateformes, les collisions et les événements dans un environnement graphique interactif.

Installation

Avant de commencer, assurez-vous que le package lplateforme est installé. Si ce n'est pas le cas, installez-le via pip :

pip install lplateforme

Initialisation du jeu

Le jeu commence par l'importation du package et la définition des fonctions d'événements interactifs.

from lplateforme.plateforme import *

Création et gestion des plateformes

Les plateformes sont définies en utilisant la classe BoxContainer, qui stocke les différents éléments du niveau.

plateformes = BoxContainer()
# Ajout des plateformes fixes tout autour de l'écran (1260x490) pour empêcher le joueur de tomber
plateformes.ajouter_bords(1260, 420)
# Ajout des plateformes fixes
plateformes.ajouter(Box(140, 70, 350, 278))

On peut également ajouter des plateformes mobiles :

# Ajout des plateformes mobiles
# Plateforme horizontale qui se déplace et rebondit sur les autres plateformes
plateformes.ajouter(MovableBox(800, 70, 210, 70, "assets/platbois3.png", ['stop', "bounce"], 1, 1, obstacles=plateformes))

Ajout d'objets interactifs

Les objets interactifs sont définis en tant que EventBox :

plateformes.ajouter(EventBox(15, 385, 0, 0, "cle", "assets/cle.png", saisir_cle))
plateformes.ajouter(EventBox(400, 370, 0, 0, "coffre", "assets/coffre_ferme.png", ouvrir_coffre))

Création des événements

Les fonctions d'événements permettent de définir le comportement des objets lors des interactions avec le joueur. Ces fonctions doivent être placées en début de programme. Exemple :

Ramasser un objet et le placer dans l'inventaire du joueur

def saisir_cle(player, objet):
    if player.name == "player":
        # Transférer l'objet de la plateforme à l'inventaire du joueur
        player.obstacles.transferer(objet, player.inventaire)
        # Rendre l'objet inventaire visible
        player.inventaire.visible = True

Ouvrir un coffre avec une clé

def ouvrir_coffre(player, objet):
    # Vérifier si le joueur possède une clé
    if player.name == "player":
        cle = player.inventaire.find("cle")
        if cle is not None:
            # Retirer la clé de l'inventaire du joueur
            player.inventaire.retirer(cle)
            # changer l'image du coffre par une image de coffre ouvert
            objet.image = loadImage("assets/coffre_ouvert_plein.png")
            objet.y -= 20

Création du joueur

Le joueur est créé à l'aide de la classe Player en lui attribuant une image et des plateformes pour ses interactions :

p = Player(70, 0, 20, 65, "assets/marche0.png", plateformes)

remplacement de l'image du joueur par une animation

animation = ImageAnimee()
animation.add_images("marche","assets/marche0.png",6)
animation.add_images("idle","assets/idle0.png",6)

p = Player(70, 0, 20, 65, animation, plateformes)

Boucle principale du jeu

La boucle du jeu est structurée en trois parties : setup, compute, et draw.

Initialisation du décor

def setup():
    createCanvas(1260, 490)
    background(loadImage("assets/img.png"))

Mise à jour des mouvements

def compute():
    p.scan_keys()
    p.move()
    plateformes.move()

Affichage des éléments

def draw():
    plateformes.draw()
    objets.draw()
    p.draw()
    title(str(mouseXY()))

Lancement du jeu

Le jeu est lancé en exécutant :

run(globals())

Conclusion

Ce guide vous a montré comment créer un jeu de plateforme simple avec lplateforme. Vous pouvez enrichir votre jeu en ajoutant plus d'événements, d'objets interactifs et de mécaniques de gameplay.

Passe en revu des classes et fonctions du package

Classes

Box

Classe de base pour les plateformes fixes. Elle hérite de la classe Rect de pygame et ajoute une méthode draw pour afficher l'image de la plateforme. paramètres:

  • x, y : coordonnées du coin supérieur gauche de la plateforme
  • w, h : largeur et hauteur de la plateforme
  • image : chemin de l'image de la plateforme (optionnel). On peut aussi utiliser une ImageAnimee.
  • collision_behavior : comportement de collision de la plateforme (optionnel). Par défaut, la plateforme est solide et empêche le joueur de passer à travers. ["stop"]. On peut utiliser "stopx" pour arrêter suivant l'axe x et stopy pour arrêter suivant l'axe y.On peut aussi utiliser "bounce" pour rebondir sur la plateforme.

MovableBox

Classe pour les plateformes mobiles. Elle hérite de la classe Box et ajoute des méthodes pour gérer le mouvement de la plateforme. paramètres:

  • x, y : coordonnées du coin supérieur gauche de la plateforme
  • w, h : largeur et hauteur de la plateforme
  • image : chemin de l'image de la plateforme (optionnel). On peut aussi utiliser une ImageAnimee.
  • collision_behavior : comportement de collision de la plateforme (optionnel). Par défaut, la plateforme est solide et empêche le joueur de passer à travers. ["stop"]. On peut utiliser "stopx" pour arrêter suivant l'axe x et stopy pour arrêter suivant l'axe y.On peut aussi utiliser "bounce" pour rebondir sur la plateforme.
  • velocity_x : vitesse de déplacement suivant l'axe x
  • velocity_y : vitesse de déplacement suivant l'axe y
  • obstacles : liste des plateformes fixes pour gérer les collisions

EventBox

Classe pour les objets interactifs. Elle hérite de la classe Box et ajoute une méthode event pour déclencher un événement lorsqu'un joueur entre en collision avec l'objet. paramètres:

  • x, y : coordonnées du coin supérieur gauche de l'objet
  • w, h : largeur et hauteur de l'objet
  • name : nom de l'objet
  • image : chemin de l'image de l'objet (optionnel). On peut aussi utiliser une ImageAnimee.
  • event : fonction d'événement à déclencher

MovableGravityBox

Classe pour les plateformes mobiles avec gravité. Elle hérite de la classe MovableBox et ajoute un attribut gravity pour gérer la gravité de la plateforme.

Metadata

Release files for lplateforme 0.1.5.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lplateforme 0.1.5.8
File Size Uploaded Provenance Actions
lplateforme-0.1.5.8.tar.gz 15.7 kB Without provenance Details for lplateforme-0.1.5.8.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for lplateforme 0.1.5.8
File Interpreter ABI Platform Actions
lplateforme-0.1.5.8-py3-none-any.whl Python 3 none any Details for lplateforme-0.1.5.8-py3-none-any.whl

Total release size: 30.4 kB

Release files / lplateforme-0.1.5.8.tar.gz

Download URL lplateforme-0.1.5.8.tar.gz
Size 15.7 kB
Tags Source
SHA-256 checksum
How to use checksums
00b60ed9f45e07b495a4b5cacd14c5ae94cfbfd9a6dc8a140eb8eacd35f48308
BLAKE2b-256 checksum
How to use checksums
2dfaeadd02d6649dcb882d5013da758661221a62a3ecd9641e098dd5c71931c0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.1.1 CPython/3.13.1 Windows/11

Release files / lplateforme-0.1.5.8-py3-none-any.whl

Download URL lplateforme-0.1.5.8-py3-none-any.whl
Size 14.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fb976530017c7bf0f84525b49c644750d972c7d74307f178f09dac5612596cf4
BLAKE2b-256 checksum
How to use checksums
d0a264bc276f4ea555c4adafcf4ff9b12792e651616bccdbe759d00ef0bccd17
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.1.1 CPython/3.13.1 Windows/11

Security for lplateforme 0.1.5.8

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page