Projet LO02 A19 Jest
Y. Langeron G. Doyen
Projet LO02
Jest
Il vous est propose dans ce projet de concevoir avec UML et developper en Java une version electronique du jeu de cartes Jest .
1. Regles du jeu
Les regles du jeu vous sont donnees en annexe. Elles servent de document de reference pour lexpression des besoins du logiciel developpe.
Au-dela, on considere aussi les besoins suivants :
Lapplication devra permettre de jouer a plusieurs joueurs qui seront des joueurs physiques
auxquels sajoutent des joueurs virtuels. Dans le cas dun joueur virtuel, le jeu devra lui attribuer une strategie de jeu simple mais coherente qui lui permettra de determiner action mener jouer a chaque instant.
Lensemble de lapplication sera integre dans une interface graphique. On pourra utiliser des images telles que celles donnees en annexe.
Avant la conception et le developpement de linterface graphique, une interface rudimentaire en ligne de commande permettra de tester le moteur du jeu. Cette interface devra etre conservee lors de levaluation fonctionnelle et la remise des fichiers.
On integrera une notion dextension qui correspondent a des nouvelles cartes, quil vous faudra concevoir et implementer. En debut de partie, il sera demande au joueur sil souhaite integrer ces cartes dextension ou pas a la partie qui va debuter.
On integrera enfin une notion de variantes dans les regles du jeu. En debut de partie, le choix dune variante sera propose au joueur et cest la variante choisie qui imposera les regles dune partie. Il est demande de concevoir et implementer deux variantes en plus des regles de base.
Larchitecture retenue devra veiller au respect des regles de la conception orientee objet. Larchitecture devra ainsi etre (1) modulaire en identifiant des composants independants lies entre eux par des relations (2) extensible en permettant le changement de regles expose ci- avant ou lajout de cartes avec de nouvelles fonctions.
2. Phases et jalons
Le projet sera decoupe en trois phases qui conduiront a des soutenances effectuees durant une seance de TP dediee. Les trois phases sont du projet sont :
1. la modelisation UML initiale ;
2. le developpement du moteur du jeu, utilisable en lignes de commandes ;
3. le developpement de linterface graphique et la remise du code source documente.
Pour chaque phase et jalon associe, les consignes a suivre vous sont donnees ci-apres.
2.1. Phase 1 : modelisation UML
La modelisation UML proposee sera exposee sous la forme dune presentation qui devra suivre la structure suivante :
1. Introduction : presentation du projet tel que vous lavez compris (pas de copier/coller de lenonce) et annonce du plan du document
2. Diagramme de cas d utilisation : identifier l ensemble des cas d utilisation du systeme, leurs relations et les expliquer.
1/3
Projet LO02 A19 Jest Y. Langeron G. Doyen
3. Diagramme de classes : decrire et expliquer chaque element de conception du diagramme. Par ailleurs, vous indiquerez letude que vous aurez faite sur (1) le patron de conception Strategy, utilise en autres, pour les joueurs virtuels, et (2) le patron Visitor, utilise pour le comptage des scores. Vous preciserez la maniere dont vous lintegrez dans votre modelisation. Vous noterez quil est inutile de modeliser les interfaces de commande du jeu
(en lignes de commandes ou graphique) ; on ne representera que le cur de lapplication.
4. Diagramme de sequence : Proposer un diagramme de sequence pour le deroulement dun
tour de jeu.
5. Conclusion : Identifier les aspects surs de la modelisation et ceux dont vous pensez que le
developpement pourrait induire une modification.
2.2. Phase 2 : cur de lapplication et interface en lignes de commandes
Cette phase, validee par une seconde soutenance orale, consistera a faire une premiere demonstration du developpement. A cette etape, le moteur du jeu devra etre fonctionnel et utilisable en lignes de commandes. Mais aucune mise en forme particuliere nest demandee (mise en packages, documentation, mise au propre du code, ). De meme, aucun support de presentation ne devra etre prepare pour cette seconde soutenance.
2.3. Phase 3 : projet complet et documentation
Cette derniere phase consistera a mettre en uvre la version finale du projet ainsi que toute la documentation qui laccompagne. Dun point de vue du travail de developpement, il consistera a integrer une interface graphique au cur de lapplication developpe precedemment. Attention, le jeu devra rester jouable a la fois en ligne de commandes et par le biais de linterface graphique, au sein dune meme partie. Pour ce faire, vous devrez mettre en uvre le patron de conception MVC, vu en cours en considerant que lapplication possede deux vues concurrentes.
Une soutenance orale permettra de valider les aspects fonctionnels de lapplication et une remise des fichiers du projet permettra devaluer le code, son organisation, sa structure et sa documentation.
Evaluation fonctionnelle
Elle sera effectuee par le biais dune soutenance qui aura lieu durant votre derniere seance de TP. Elle seffectue par binome et dure 15 minutes durant lesquelles vous presenterez : Letat fonctionnel de votre application par le biais dune demonstration. Une fois la demonstration passee, tout developpement supplementaire (correction de bugs, ajout de fonctionnalites, ) est inutile car letat fonctionnel de votre projet sera evalue a ce moment. Suite a cela, quelques questions relatives au code que vous avez produit vous seront posees.
Remarque : Pour cette evaluation fonctionnelle, il ne vous est pas demande de mettre au propre le code presente (respect des conventions decriture, commentaire Javadoc, suppression des blocs de codes inutiles mis en commentaires, ). Par contre, cela devra etre fait pour la remise des fichiers.
Remise des fichiers du projet
Les fichiers du projet a remettre seront deposes sur Moodle, dans un espace dedie a cet effet, et places dans une archive ZIP dont le nom du fichier doit suivre la convention de nommage suivante :
Larchive devra comporter les dossiers suivants :
src : contiendra lensemble des sources du projet ;
2/3
Projet LO02 A19 Jest Y. Langeron G. Doyen
dist: contiendra un fichier nomme projet.jar qui contiendra une archive JAR executable du projet. Cest ce fichier qui sera execute pour tester si besoin votre projet apres la soutenance ;
classes : contiendra lensemble des classes compilees du projet ;
doc : contiendra la javadoc du projet, le diagramme de classes final et letat fonctionnel de
l application..
Enfin, les consignes a observer pour la mise en forme du code developpe dans le cadre du projet sont les suivantes :
Lensemble du code doit etre documente par le biais de commentaires javadoc. Il ne faudra pas se contenter des balises standard mais decrire precisement la fonction de chaque element de code (classe, methode, ) en respectant les conventions de documentation pour la production logicielle telles que vues durant le semestre.
Le code devra etre propre et suivre les conventions decriture specifiees par Oracle (nommage, indentation, blocs, casse, ). Aucun code obsolete, place dans un commentaire, ne devra figurer dans les fichiers sources.
Le diagramme de classes final. On detaillera ici et justifiera les changements entre la version initiale du diagramme de classes et la version finale, effectivement implementee dans le code. Pour ce faire, on presentera les deux diagrammes.
L etat actuel de l application : Cette partie donnera de maniere precise l etat de l application en regard du present cahier des charges. On y indiquera clairement ce qui a ete implante et ce quil ne lest pas, ce qui fonctionne et ce qui reste bugge.
3. Consignes generales
3.1. Calendrier
3.2. Respect des droits dauteurs
Le present projet consiste en la modelisation et le developpement logiciel dun jeu dont les conditions dutilisation sont specifiees ici : http://www.goodlittlegames.co.uk/about-faq.html. LUniversite de Technologie de Troyes nutilise cette uvre que dans seul un cadre denseignement et a des fins exclusivement pedagogiques. En effectuant ce travail au sein dune unite denseignement, letudiant sengage a respecter les droits dauteurs et dexploitation lies a tout support de stockage et de diffusion numerique du code produit dans le cadre de son projet et a respecter le cadre exclusivement pedagogique associe a cette production. Toute autre forme dexploitation et de diffusion par un etudiant releve de sa seule responsabilite individuelle.
3.3. Autres consignes
Pour lensemble des livrables du projet, aucun retard ne sera accepte et aucune raison ne pourra le justifier.
Vos intervenants de TP sont vos interlocuteurs exclusifs pour toute question relative au projet.
Semaine
Evenement
2 (16/09)
Distribution des projets et constitution des binomes
6, 7 et 9 (14/10, 21/10 et 4/11)
Soutenance Jalon 1
12 et 13 (25/11 et 2/12)
Soutenance Jalon 2
18 (6/01)
Soutenance
19 (vendredi 17/01 a 23:55)
Remise des fichiers
3/3
Brett J. Gilbert
3 or 4 players 10 minutes
THE CARDS
The game contains 18 cards:
16 suit cards: Each of the 4 suits contains 4 cards: Ace, 2, 3 & 4. The Ace is a special card and can become a 5 in some circumstances.
Joker: The Joker is here to cause trouble for the players: Watch out for him!
Reference card: Shows the hierarchy of the suits and the ways in which the card combinations score.
SETUP
Place the reference card face-up in the middle of the play area. Then shuffle the 16 suit cards and the Jester together face-down. Deal 2 cards face up beside the reference card: these cards are the trophies. Place the remaining cards face down as the draw deck.
AIM OF THE GAME
The player who collects a Jest of cards that is worth the most points at the end of the game is the winner.
HOW TO PLAY
Each game is made up of a sequence of rounds. In each round each player receives 2 cards and makes an offer of these cards to the other players. In turn, players take 1 card from one of the offers on the table and adds this card to their face-down Jest.
At the end of the game, the players compare their Jests. Each of the trophies is awarded to the player whose Jest meets the trophys condition, shown in the orange band. The trophy will change the value of the Jest of the player who receives it for better or worse!
Each round is played in three phases. 1: Deal cards, 2: Make offers, 3: Take cards.
1. Deal cards
In the first round, deal each player 2 cards face-down from the draw deck.
In later rounds, first collect up the cards not taken from the players offers in the previous round (each player will have 1 card remaining in front of them) and place these cards in a face-down stack. Then add to the stack a number of cards from the draw deck equal to the number of players. Shuffle this stack and deal 2 cards to each player.
2. Make offers
All players look at the two cards dealt to them. Each player first chooses 1 card to play face down. When everyone has done this, all players then reveal their other card face up beside the first card. The pair of cards in front of you one face up, one face down is your offer to the other players.
3. Take cards
Compare the face-up cards in each offer. The player whose face-up card has the highest face value takes the first turn. The Joker has a face value of 0. In this phase of the game, an Ace always has a face value of 1.
On your turn you must take 1 card from another players complete offer and add it to your Jest. Keep the cards in your Jest face down, separate from any other cards in play.
When you take a card from an offer, you cant look at the face-down card before choosing.
You may always check the cards in your own offer and Jest.
You may not take a card from an incomplete offer. You must choose an offer that still contains 2 cards.
Next player
The player from whose offer you took a card goes next, unless, later in the round, that player has already had a turn and taken a card. In that case, compare the face-up cards in the offers of the remaining players. The player whose card has the highest face value goes next. Break ties as before, if necessary.
If you are the final player in a round and your own offer is the only one that still contains 2 cards, you must take a card from your offer. This is the only time that taking from your own offer is allowed!
End of the round
At the end of the round, each player will have added 1 card to their Jest, and 1 card from each players offer will remain on the table in front of them.
If there are cards remaining in the draw deck, the game continues. Begin a new round.
If there are no cards left in the draw deck, the game ends. All players must now take the 1 card remaining from their offer in the final round, add it to their Jest, and then reveal their cards.
END OF THE GAME
Before the winner is decided, compare everyones Jests to discover whose Jest meets the condition in the orange band of each trophy. Award both trophies simultaneously. If you win a trophy you must add it to your Jest.
The player who has the highest value Jest after the trophies have been awarded is the winner!
If 2 or more players tie when meeting a Majority condition, award the trophy to the player with the card
of that face value in the strongest suit. If 2 or more players tie when meeting a Best Jest condition, award the trophy to the player whose Jest contains the card with the highest face value (which, if also a tie, should be broken in favour of the card in the strongest suit).
JEST VALUE
The reference card summarizes how the different suits and card combinations affect the value of your Jest.
Suits
Spades } and Clubs ] always increase the value of your Jest by their face value.
Diamonds [ always reduce the value of your Jest by their face value.
Hearts { are worth nothing unless you have the Joker.
Joker & Hearts
If you have the Joker and no Hearts {, the Joker is worth a bonus 4 points.
If you have the Joker and 1, 2 or 3 Hearts {, the Joker is worth nothing and every Heart reduces the value of your Jest by its face value.
If you have the Joker and all 4 Hearts {, the Joker is worth nothing but every Heart increases the value of your Jest by its face value. (In a 4-player game, this score is only possible if the trophy is either the Joker or a Heart {.)
Aces
If you have an Ace which is the only card of that suit in your Jest, the card becomes a 5, with a face value of 5. Otherwise it remains an Ace, with a face value of 1.
Black pairs
If you have a Spade } and a Club ] with the same face value, the pair is worth a bonus 2 points in addition to the face values of the cards.
With thanks to the following playtesters:
Andrew Sheerin, John Turner, David Johnston, Matt Dunstan, Sam Mercer, Adam Harper, Richard Stokes.
Rules v1.0 2013 Brett J. Gilbert
www.goodlittlegames.co.uk
Breaking ties: If 2 or more players have equally valuable face-up cards in their offers, break the tie in favour of the player whose face-up card is in the strongest suit. Spades is the strongest suit, then Clubs, Diamonds and Hearts. The reference card illustrates this hierarchy.
The game is probably best with 3 players, but if playing with 4 players, deal only 1 face-up trophy.
Jest Cards (A4) v1.0 2013 Brett J. Gilbert goodlittlegames.co.uk
Jest Cards (A4) v1.0 2013 Brett J. Gilbert goodlittlegames.co.uk
Reviews
There are no reviews yet.