Workshops - Noé Tatoud

Ressources utiles

Kaplay

Composants par défaut

Kaplay fournit des composants prêts à l’emploi que tu peux ajouter à tes objets pour leur donner des capacités.

👉 Un objet = un tableau de composants.

NomDescription
spritePermet à l’objet d’afficher une image (texture) et de jouer des animations
areaPermet à l’objet d’avoir une zone de collision
bodySoumet l’objet à la gravité et le rend “solide”
posDonne une position à l’objet dans le jeu
textPermet d’afficher du texte à l’écran
scalePermet de changer la taille de l’objet

Tu peux combiner plusieurs composants sur un même objet pour lui donner plusieurs capacités.


Tester si deux éléments sont en contact (collisions)

Pour savoir si deux objets se touchent, Kaplay utilise le système de collisions.

Pour détecter un contact entre deux objets, les deux doivent avoir area().

👉 Un objet peut détecter une collision sans être solide.

Exemple de test de collision entre le héros et un coffre

for (const collision of hero.getCollisions()) {
        const c = collision.target;
        if (c.is("chest")) {
            if (c.opened) {
                c.play("close");
                c.opened = false;
            }
            else {
                c.play("open");
                c.opened = true;
            }
            interacted = true;
        }
    }

Écouteurs d’événements (events)

Les événements servent à dire au jeu : 👉 “Quand quelque chose arrive, fais ça.”

Événements du clavier

NomDescriptionUtilisation
onKeyDownRéagir quand une touche du clavier est enfoncéeonKeyDown("<touche>", callback)
onKeyReleaseRéagir quand une touche du clavier est relâchéeonKeyRelease("<touche>", callback)

Exemples de touches possibles :

  • "left", "right", "up", "down"
  • "space"
  • "a", "z", "e", etc.

JavaScript

Fonction de callback

En JavaScript, une fonction de callback est une fonction que l’on donne à une autre fonction, pour qu’elle soit appelée quand quelque chose se produit.

Par exemple :

  • quand une touche du clavier est appuyée
  • quand la souris clique
  • quand un événement arrive dans le jeu

Elle s’écrit souvent comme ceci :

(parametres) => {
  // instructions
}

👉 Une fonction de callback, c’est simplement : “ce que le programme doit faire quand quelque chose se passe”.

Exemple

onClick(() => {
  // ce code est exécuté quand on clique avec la souris
  debug.log("Click !");
});

Tu n’as pas besoin de tout comprendre tout de suite. Avec la pratique, ces idées vont devenir naturelles.

On this page