Projet de POO

Réalisation d’un jeu vidéo 2D : UBGarden.

Principes du jeu

Un hérisson est perdu et désespéré. Votre mission, si vous l’acceptez, est d’aller le secourir. Pour cela, vous devrez traverser plusieurs jardins, plus fantastiques les uns que les autres.

Chaque jardin est représenté par une carte (rectangulaire) composée de cellules. Des portes vous permettront de passer de jardin en jardin. Certaines portes seront fermées à clé et nécessiteront d’avoir une clé pour les ouvrir. Attention, des frelons vivent dans ces jardins et vous êtes allergique aux piqures. Le jardinier et les frelons peuvent se déplacer de cellule en cellule, dans un espace géométrique discret. Les arbres sont des éléments de décor infranchissables. Seuls les frelons peuvent traverser les bosquets de fleurs, le jardinier ne peut pas s’y aventurer. Chaque déplacement du jardinier consomme de l’énergie, en fonction du type de sol sur lequel il marche. Ce coût de déplacement est multiplié par diseaseLevel, initialisé à 1. Les frelons peuvent voler autant qu’ils veulent sans jamais se fatiguer. Le jardinier récupère vite et gagne un point d’énergie au bout de energyRecoverDuration secondes sans bouger, dans la limite de son niveau d’énergie initial gardenerEnergy. Le niveau d’énergie actuel du jardinier est affiché dans la barre d’état.

En cas de piqure d’un frelon, vous perdez 20 points d’énergie. Les frelons ne survivent pas aux piqures qu’ils vous infligent. Heureusement, vous pouvez ramasser des bombes insecticides qui tuent les frelons. Chaque bombe peut tuer un frelon. Le nombre de bombes insecticides restant est affiché dans la barre d’état. Lorsque le jardinier n’a plus d’énergie et se fait piquer, la partie est perdue. Les frelons n’aiment pas les courants d’air et ne peuvent pas passer sur les portes.

Le jardinier ramasse automatiquement les bonus qui se trouvent sur des cellules d’herbe quand il marche dessus. Les frelons n’interagissent pas avec les bonus sauf les bombes insecticides qui les tuent lorsqu’ils marchent dessus. Si le jardinier ramasse un trognon de pomme pourrie, il devient malade pendant diseaseDuration quelques secondes et son degré de fatigue diseaseLevel augmente de 1. Le degré de fatigue actuel du jardinier (diseaseLevel) est affiché dans la barre d’état. Si le jardinier ramasse des pommes, il gagne un surplus d’énergie de energyBoost et guérit instantanément (la valeur par défaut diseaseLevel vaut 1).

Image	Description	Effet
	Herbe	Le jardinier consomme 1 * diseaseLevel points d’énergie par déplacement
	Terre	Le jardinier consomme 2 * diseaseLevel points d’énergie par déplacement
	Carottes	Le jardinier consomme 3 * diseaseLevel points d’énergie par déplacement
	Pomme empoisonnée	Augmente diseaseLevel de 1 pendant une durée de diseaseDuration secondes
	Pomme	Réinitialise diseaseLevel à 1 et augmente la quantité d’énergie du jardinier de energyBoost
	Bosquet de fleurs	Infranchissable pour le jardinier, franchissable pour les frelons
	Bombe insecticide	Permet de tuer un frelon, le jardinier peut la ramasser. La bombe disparait au bout de 10 secondes.
	Nid de frelons	Génère un nouveau frelon et une bombe insecticide toutes les 10 secondes. La bombe est placée sur une case d’herbe vide (sans bonus)
	Frelon	Frelon pas sympa. Le frelon meurt s’il passe sur la bombe d’insecticide.
	Jardinier	Jardinier super cool
	Hérisson	Hérisson apeuré
	Porte fermée
	Porte ouverte
	Clé	Permets d’ouvrir une porte fermée lorsque le jardinier marche dessus. Le jardinier ne peut marcher sur une porte fermée que s’il possède une clé.

Prise en main

Nous vous fournissons une première ébauche du jeu. Le lancement du jeu fait apparaître une carte minimaliste (MapLevelDefaultStart), chargée statiquement en mémoire, dans laquelle le jardinier peut se déplacer dans toutes les directions, quelle que soit la nature des cellules. Les paramètres du jeu sont définis dans un fichier de propriétés. Les fichiers properties en Java permettent de facilement stocker des couples de clés/valeurs. Les valeurs par défauts sont les suivantes.

Travail à fournir

Archive du jeu de base : UBGarden-student-2024.zip

Premiers pas

Dans cette première version, les frelons sont immobiles. Nous utiliserons pour le moment la carte par défaut.

• Modifiez le code pour afficher tous les éléments ainsi que les frelons et le hérisson. Vous pouvez maintenant utiliser la carte MapLevelDefault à la place de MapLevelDefaultStart.
• Modifiez le code pour que les mouvements du jardinier soient limités par le cadre de la carte et les éléments de décor.
• Faire en sorte que le jardinier perde de l’énergie lorsqu’il touche un frelon.
• Faire en sorte que la partie se termine par une défaite si le jardinier meurt.
• Faire en sorte que la partie se termine par une victoire si le jardinier retrouve le hérisson.
• Mettre à jour le panneau d’affichage avec : niveau de fatigue, nombre de clés et niveau d’énergie
• Faire en sorte que le jardinier dépense de l’énergie quand il se déplace
• Permettre au jardinier de récupérer de l’énergie quand il reste immobile assez longtemps
• Faire en sorte que le jardinier puisse ramasser les bonus

Donnons vie aux frelons

• La ruche produit un nouveau frelon toutes les 10 secondes.
• Faire en sorte que chaque frelon se déplace tout seul de manière aléatoire
• Un frelon doit mourir quand il pique le jardinier
• La vitesse de déplacement d’un frelon est définie par la variable de configuration hornetMoveFrequency qui indique le nombre de fois par seconde qu’un frelon peut bouger.

Gestion des mondes

Dans la version de base, le jeu ne dispose que d’un seul niveau codé en dur dans le code. Nous allons maintenant charger une configuration complète de jeu depuis un fichier. Vous trouverez un répertoire world à la racine du projet avec deux fichiers d’extension .properties représentant un monde avec 2 niveaux (avec ou sans compression des niveaux). Nous utilisons le codage LRE vu en TD avec ou sans compression en fonction du paramètre compression dans le fichier de configuration.

• Permettre le chargement d’une carte depuis un fichier
• Gérez les portes ouvertes, le ramassage des clés et l’ouverture des portes fermées.

Bombes insecticides

• À chaque fois qu’un frelon sort de la ruche, une bombe insecticide apparait sur une case aléatoire (herbe) qui ne contenait pas déjà un bonus.
• Le jardinier peut ramasser des bombes insecticides (le compteur est mis à jour)
• Si le jardinier dispose d’une bombe insecticide quand il rencontre un frelon, il utilise sa bombe pour tuer le frelon et ne se fait pas piquer, mais il perd sa bombe.

Fin de partie

La partie est finie lorsque le jardinier arrive à secourir le hérisson ou lorsqu’il meurt.

La touche [ESCAPE] permet de quitter la partie à tout moment.

class Gardener {
    void take(Apple apple) { ... }
    void take(PoisonedApple poisonedApple) { ... }

    void doMove(Direction direction) {
        Position nextPos = direction.nextPosition(getPosition());
        Decor next = game.world().getGrid().get(nextPos);
        setPosition(nextPos);
        if (next != null)
            take(next);
    }
}

class Gardener {
    // [...]
    void doMove(Direction direction) {
        // ... 
        if (next != null)
            next.takenBy(this);
    }
}

public interface Takeable {
    default void takenBy(Gardener Gardener) {}
}

public abstract class Bonus implements Takeable {}

public class Apple extends Bonus { 
    public void takenBy(Gardener Gardener) {
        Gardener.take(this);
    }
}

public class PoisonedApple extends Bonus { 
    public void takenBy(Gardener Gardener) {
        Gardener.take(this);
    }
 }