====== Création d'un jeu de plateforme complet ======

===== Pré-requis =====

Avant de commencer ce tutoriel, il est recommandé de consulter le guide sur ce qu'est **[[creer:accueil|l'environnement de travail]]** de l'espace créatif, notamment sur :
  * **[[:creer_un_projet|La création d'un projet]]**
  * **[[creer:editeur:page2|La création d'un programme]]**
  * **[[:fonction_sous_programme|Appeler une fonction d'un sous-programme]]**
  * **[[:importer_des_fichiers|Importer des fichiers dans la médiathèque]]**

On va tout d'abord créer un nouveau projet, puis on crée un programme intitulé ''%%niv1%%''.
Après avoir créé le projet, on importe les fichiers de **{{ :exemples:images_tuto_plateforme_a_decompresser_.zip |cet archive d'images}}** dans la médiathèque (à extraire au préalable avant d'importer).

<WRAP center round download 100%>**{{ :exemples:images_tuto_plateforme_a_decompresser_.zip }}**</WRAP>

{{ :exemples:explorer_jhgezeyuux.png?nolink |}}

Avant toute chose, on va taper les lignes de code ci-dessous : 

<code declick>
programme_actuel = 'niv1'
programme_suivant = 'niv1'
</code>

Elle nous permettent de définir quel niveau (re)jouer si l'on perd, et quel niveau atteindre si on gagne

===== 1) Intégration du décor =====

Le décor est l'image qui est intégrée en arrière-plan de ton jeu.
<code declick>
ville = new Décor()  // Intégration du décor
</code>

La commande ''%%définirImageFond()%%'' permet d’insérer l'image de fond qui se trouve dans la médiathèque.
<code declick>
ville.définirImageFond("imageVille.png")
</code>


===== 2) Intégration de la plateforme =====

La plateforme est la zone dans laquelle le personnage pourra se déplacer. Pour créer une plateforme on utilise la commande ''%%new Plateforme()%%''.

La plateforme s'appelle ''%%plateformeNiv1 %%''.

<code declick>
plateformeNiv1 = new Plateforme() // Création de la plateforme
</code>

La commande ''%%construire()%%'' permet de lancer la construction de la plateforme.
<code declick>
plateformeNiv1.construire() // Construction de la plateforme
</code>

La commande ''%%ajouterLigne()%%'' ressemble à la commande ''%%poserLigne()%%'' comme dans le parcours de Bob et Max : 

<code declick>
// Création des blocs de la plateforme, 1 pour un bloc mur et 0 pour le vide
plateformeNiv1.ajouterLigne(1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1)
plateformeNiv1.ajouterLigne(1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1)
plateformeNiv1.ajouterLigne(1,0,3,0,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1)
plateformeNiv1.ajouterLigne(1,1,1,1,1,0,0,1,1,1,1,1,1,1,0,0,1,0,0,0,0,0,1,0,0,1)
plateformeNiv1.ajouterLigne(1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,1,0,0,1)
plateformeNiv1.ajouterLigne(1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,0,0,1,1,1,1)
plateformeNiv1.ajouterLigne(1,0,0,1,1,1,1,1,1,1,0,0,1,1,1,1,1,0,0,0,0,0,0,0,0,1)
plateformeNiv1.ajouterLigne(1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1)
plateformeNiv1.ajouterLigne(1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,1,1,1,1,1,1,1)
plateformeNiv1.ajouterLigne(1,1,1,0,0,0,1,0,0,1,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1)
plateformeNiv1.ajouterLigne(1,1,1,0,0,0,1,0,0,1,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1)
plateformeNiv1.ajouterLigne(1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1)
</code>

Le chiffre 1 permet de poser un mur et le chiffre 0 pour le vide (pour rappel clique [[objets:macon|ici]]).
===== 3) Intégrer des éléments dans la plateforme =====

Pour intégrer n'importe quel objet sur la plateforme, on utilise la commande ''%%new Item()%%''.

Grâce à cette commande tu pourras intégrer dans ton jeu l'objet désiré (épée, pièce, potion, bonbons …).

Nous allons intégrer une porte de sortie
<code declick>
porteSortieNiv1 = new Item("imagePorteSortie.png") // Intégration de la porte de sortie
</code>

Pour donner une position à la porte de sortie, nous utilisons la commande ''%%définirPosition()%%''.

<code declick>
porteSortieNiv1.définirPosition(950,400) // Positionnement de la porte de sortie
</code>

Nous allons aussi intégrer et positionner une pièce.

<code declick>
pièce = new Item("imagePièce.png")  // Intégration d'une pièce de monnaie
pièce.définirPosition(315,80) // Positionnement de la pièce de monnaie
</code>

Et pour finir on intègre et positionne une potion verte (potion de vie) et une potion rouge (potion de poison).

<code declick>
// Intégration des potions rouge et verte
potionVerte = new Item("imagePotionVerte.png")  // Intégration de la potion verte (potion de vie)
potionVerte.définirPosition(290,400) // Positionnement de la potion rouge

potionRouge = new Item("imagePotionRouge.png")  // Intégration de la potion rouge (potion de poison)
potionRouge.définirPosition(615,400) // Positionnement de la potion rouge
</code>
===== 4) Intégration de l'ennemi  =====

Pour intégrer l'ennemi qui s'appelle ogre dans la plateforme, nous allons utiliser la commande ''%%new Animation()%%''.

<code declick>
ogre = new Animation("imageOgre.png") // Intégration de l"ennemi
</code>

Une fois l'ennemi intégré, nous allons lui donner une position dans la plateforme avec la commande ''%%définirPosition()%%''.

<code declick>
ogre.définirPosition(685,160) // Positionnement de l'ennemi
</code>

===== 5) Déplacement de l'ennemi =====

Maintenant que l'ogre est intégré et positionné dans la plateforme, nous allons lui donner de la vie !

Nous allons créer une séquence d'animation qui le fera se déplacer de gauche à droite et vice-versa, cette séquence définit le mouvement de l'ogre.

<code declick>
// Création du mouvement de l'ennemi
déplacementOgre = new Séquence()
déplacementOgre.ajouterCommande("ogre.définirAngle(0)")
déplacementOgre.ajouterCommande("ogre.avancer(75)")
déplacementOgre.ajouterDélai(3000) 
déplacementOgre.ajouterCommande("ogre.reculer(75)")
déplacementOgre.ajouterDélai(3000) 
déplacementOgre.recommencer(true)
déplacementOgre.démarrer() 
</code>

===== 6) Intégration du Personnage =====

Pour intégrer notre personnage joe on utilise  la commande ''%%new Personnage()%%''.

<code declick>
joe = new Personnage() // Intégration du personnage
joe.ajouterImage("imageJoe.png") // Ajout de l'image personnalisée au personnage
</code>
Pour que joe puisse interagir avec la plateforme on utilise la commande ''%%ajouterPlateforme()%%''.

<code declick>
joe.ajouterPlateforme(plateformeNiv1) // Le personnage peut se déplacer dans la plateforme
</code>

Ensuite on définit la position de joe dans la plateforme.

<code declick>
joe.définirPosition(80,65) // Positionnement du personnage
</code>

Pour ajuster la vitesse du saut du personnage on utilise la commande ''%%définirVitesseSaut()%%''.
<code declick>
joe.définirVitesseSaut(125)  // Décision de la vitesse de saut du personnage
</code>

On souhaite que joe atterisse au sol au début de la partie.

Pour se faire, il y a la commande ''%%peutTomber()%%''.

<code declick>
joe.peutTomber()  // joe est affecté par la gravité plateformeNiv1
</code>

===== 7) Pour que joe attrape des objets  =====

Afin que joe puisse attraper la pièce et les potions que nous avons créé précédemment, on utilise la commande ''%%peutAttraper()%%''.

Lorsque joe touche un objet (pièce, potion rouge, potion verte) alors l'objet disparaît.
<code declick>
joe.peutAttraper(pièce) // joe peut attraper la pièce 
joe.peutAttraper(potionRouge)  // joe peut attraper la potion rouge
joe.peutAttraper(potionVerte)  // joe peut attraper la potion verte
</code>

===== 8) Création d'un sous-programme en cas de victoire ou de défaite =====

On crée tout d'abord un nouveau programme (bouton "+" en bas à gauche de l'écran) qu'on renomme niveau_suivant.
On insère le code suivant : 
<code declick>
declick.effacerEcran()
declick.initialiser()
declick.chargerProgramme(programme_suivant)
</code>

On sauvegarde (ctrl+s).

On crée ensuite un autre programme qu'on renomme redémarrer_partie.
On insère le code suivant :
<code declick>
declick.effacerEcran()
declick.initialiser()
declick.chargerProgramme(programme_actuel)
</code>

On sauvegarde (ctrl+s)

<WRAP center round important 100%>
Ici, le niveau chargé en cas de victoire ou de défaite est le même parce que nous n'avons qu'un niveau, si un niveau "niv2" est créé, il suffira de modifier la variable "programme_suivant" dans niv1.
</WRAP>

===== 09) Détection des collisions =====

La détection des collisions permet de savoir quand un personnage touche un objet ou un ennemi.

''%%SI%%'' joe touche ogre ou la potion rouge ''%%ALORS%%'' on lance le programme ''%%redémarrer_partie%%''.

<code declick>
joe.siCollisionAvec(ogre,"redémarrer_partie") // Si joe touche ogre alors on perd la partie
joe.siCollisionAvec(potionRouge,"redémarrer_partie")  // Si joe touche la potion rouge alors on perd la partie
</code>

''%%SI%%'' joe touche la porte de sortie ''%%ALORS%%'' on lance la commande ''%%niveau_suivant%%''.

<code declick>
joe.siCollisionAvec(porteSortieNiv1,"niveau_suivant") // Si joe touche la porte de sortie alors on gagne la partie
</code>

===== 10) Les déplacements du personnage  =====

Nous avons précédemment créé notre personnage joe 

Nous utilisons la boucle ''%%répéter()%%'' pour définir ses capacités, ici de déplacement

<code declick>
// La boucle suivante permet à joe de se déplacer
répéter()
{
  if(clavier.gauche) // Si le joueur appuie sur la flèche gauche du clavier
  {
    joe.reculer(25) // Alors joe recule
  }
  if(clavier.droite) // Si le joueur appuie sur la flèche droite du clavier
  {
    joe.avancer(25) // Alors le personnage avance 
  }
  if(clavier.haut) // Si le joueur appuie sur la flèche en haut du clavier
  {
    joe.sauter() // Alors joe saute
  }
}
</code>

===== Sources =====
Assets de base créés par **Joël Nguyen**

Image de fond créé par **[[https://www.reddit.com/r/wallpaper/comments/5k6wqq/pixel_art_city_2560x1440oc/|u/r977]]**