codingtheworld777 / project-----shape-up

A school project about a card game.

Project-----SHAPE UP

See my repository at: Huu Khai NGUYEN's Project-----SHAPE UP

See API's document of this project at SHAPE UP-API's document

--[FR-Description]--

1) Introduction

• Dans le cadre d'un cours de branche sur la programmation orienté-objet en Java (LO02) dirigé par Guillaume DOYEN à l'Université de Technologie de Troyes, j'ai réalisé en binôme avec Pierre-Louis DAMBRAINE un jeu appelé SHAPE UP.
• Les règles sont trouvables ici: SHAPE UP-règles. Vous trouverez aussi le sujet du projet dans ce fichier PDF

2) Mode d'emploi

a) Paramétrer le jeu:

• Après avoir démarré le jeu, une fenêtre de paramètre va afficher qui permet le joueur de paramétrer le jeu:
  • Choisir la variante de tapis du jeu
  • Choisir le nombre de joueurs
  • Activer le joueur virtuel et choisir son niveau

Clique sur le bouton "Valider" pour afficher l'interface graphique du jeu.

b) Jouer le jeu:

• Le joueur peut réaliser 2 actions principales: Déplacer ou Placer une carte. Vous trouverez au dessous une illustration du jeu qui vous permet de visualiser facilement le fonctionnement du jeu:

  • Pour placer une carte, tout d'abord double-clique sur le bouton du bas dans la zone "Piocher une carte" dans le coin inférieur droit de l'écran pour afficher une carte piochée. Quand le joueur clique sur le bouton du bas dans le zone "Piocher une carte", les positions qu'il peut placer la carte deviendront vertes (sauf la première fois que vous tirez la carte). Le joueur peut ensuite placer la carte sélectionnée dans la position indiquée en vert.
  • Pour déplacer une carte, le joueur doit cliquer une carte sur la table du jeu, si cette carte est deplacable, les positions dans lesquelles la carte peut être déplacée deviendront vertes. Sinon, rien ne changera.

• Le joueur peut finir son tour si et seulement s'il a déjà placé une carte. A partir le moment où le joueur placé une carte, il peut arrêter son tour. (peut-être l'arrêter sans déplacer une carte). Quand le joueur a terminé le tour avec succès, le panel de ce joueur deviendra rouge et le Panel du joueur suivant deviendra verte pour annoncer le tour du joueur suivant, et le point de chaque joueur sera mis à jour.

• Si le jeu a fini, clique sur le bouton "Tour suivant" pour passer sur le nouveau tour.

Petit note: Comme nous ne savons pas quelle action le joueur choisissira en premier (il peut choisir de déplacer premièrement une carte ou de piocher et de placer une carte avant d'en déplacer), donc comme le joueur change continuellement son choix. Pour cette raison, le jeu peut prendre 1 à 2 secondes à traiter, il peut donc ne pas être en mesure de mettre à jour l'interface graphique immédiatement. Nous avons 2 situations qui pourraient se produire ici:

• Lorsque vous cliquez sur le bouton de sélection mais qu'il y a des endroits où la carte ne devient pas verte, veuillez cliquer sur ce bouton au moins une fois pour mettre à jour l'interface graphique.
• Lorsque vous ne parvenez pas à placer une carte après en avoir déplacée (bien que les emplacements deviennent verts), cliquez sur votre bouton "Finir mon tour" si vous êtes actuellement à votre tour.

Pour plus informations, voir @Vue/VueText.java .

👉 Télecharger shapeUP.jar et profiter le jeu.

Remarque:

📛 Vous pouvez jouer le jeu sur l'interface graphique au même temps que sur la console. Pour le faire, vous devez avoir l'IDE qui peut compiler et exécuter un Java programme (Eclipse, NetBeans,...). Après avoir installé et paramétré Java environnement, vous devez cloner les codes sources en utilisant cette commande de git:

	$ git clone https://github.com/codingTheWorld777/Project-----SHAPE-UP.git

📛 Démarrer le programme et dans la dernière option, choisissez "Oui". ATTENTION, cette option c'est juste pour tester le programme!!
📛 Si vous activez le jeu sur la console: Si vous voulez jouer sur l'interface graphique dans ce cas, après avoir pioché et placé une carte, si vous voulez finir votre tour en cliquant sur le bouton Finir mon tour, vous devez attendre de 3-4 secondes et puis le cliquer pour passer sur le tour du joueur suivant.

🤘 Ouvrez votre IDE et profitez le jeu! 😎

Screenshots

[EN-Description]

--[EN-Description]--

1) Introduction

• As part of a branch course of Oriented-Object Programming in java (LO02) directed by Guillaume DOYEN at the University of Technology of Troyes, I realized in pairs with my friend Pierre-Louis DAMBRAINE a game called SHAPE UP.
• The rules of game can be found here: SHAPE UP-rules. You will also find the subject of the project in this PDF file

2) User manual

a) Parameter the game

b) Play game on GUI

• The player can perform 2 main actions: Move or Place a card. Above is an illustration of the game that allows you to easily see how the game works:

  • To place a card, first double-click the bottom button in the "Draw Card" area in the lower right corner of the screen to display a drawn card. When the player clicks the bottom button in the “Draw a card” area, the positions that the player can place the card will turn green (except the first time you draw the card). The player can then place the selected card in the position indicated in green.
  • To move a card, the player must click a card on the game table, if this card is movable, the positions in which the card can be moved will turn green. Otherwise, nothing will change.

• The player can end his turn if and only if he has already placed a card. From the moment the player places a card, he can stop his turn. (maybe stop it without moving a card). When the player has successfully completed his turn, that player's panel will turn red and the next player's panel will turn green to announce the next player's turn, and each player's point will be updated.

If the game is over, click on the "Next round" button to move on to the new round.

Small note: As we do not know which action the player will choose first (he can choose to move a card first or to draw and place a card first), so as the player continually changes his choice. Because of this, the game may take 1-2 seconds to process, so it may not be able to update the GUI immediately. We have 2 situations that could occur here:

• When you click the select button in the "Draw Card" area but there are maybe some places where the possible position(s) does not turn green, please click this button at least once to update the GUI.
• When you are unable to place a card after moving one (although the spaces turn green), click your "End my turn" button if you are currently on your turn.

👉 Download shapeUP.jar and enjoy the game

Remark:

📛 You can play this game in the GUI at the same time in the console. To do it, firstly you need an IDE that can compile and run a Java program. After installing the IDE and its environment, to play this game, you need to clone the source codes from my repository into one of your folder's directory:

	$ git clone https://github.com/codingTheWorld777/Project-----SHAPE-UP.git

📛 Start the program and in the last option, choose "Yes". BE CAREFUL, this option is just to test the program !!
📛 If you activate the game on the console: If you want to play on the graphical interface in this case, after drawing and placing a card, if you want to end your turn by clicking on the ** End my turn ** button, you have to wait 3-4 seconds and then click it to move on to the next player's turn.

For more informations, see @Vue/VueText .

🤘 Open your IDE and enjoy the game! 😎