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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.