From b0491739ac29c556418cd1429dcb573debb02628 Mon Sep 17 00:00:00 2001
From: GabrieleRadice <265572328+GabrieleRadice@users.noreply.github.com>
Date: Fri, 19 Jun 2026 22:43:47 +0200
Subject: [PATCH] Add: Added Missing Javadoc For Player.java.

---
 .../it/polimi/ingsw/gc14/Model/Player.java    | 31 +++++++++++++++++--
 1 file changed, 28 insertions(+), 3 deletions(-)

diff --git a/src/main/java/it/polimi/ingsw/gc14/Model/Player.java b/src/main/java/it/polimi/ingsw/gc14/Model/Player.java
index 8c6d4b7..c98f160 100644
--- a/src/main/java/it/polimi/ingsw/gc14/Model/Player.java
+++ b/src/main/java/it/polimi/ingsw/gc14/Model/Player.java
@@ -79,12 +79,40 @@ public class Player implements Serializable {
             case GATHERER -> gatherers.size();
         };
     }
+
+    /**
+     * The current {@link BuildingCard Building Cards} in the player's deck.
+     */
     private final ArrayList<BuildingCard> buildingCards;
+
+    /**
+     * The current {@link Artist Artist} cards in the player's deck.
+     */
     private final ArrayList<Artist> artists;
+
+    /**
+     * The current {@link Builder Builder} cards in the player's deck.
+     */
     private final ArrayList<Builder> builders;
+
+    /**
+     * The current {@link Inventor Inventor} cards in the player's deck.
+     */
     private final ArrayList<Inventor> inventors;
+
+    /**
+     * The current {@link Gatherer Gatherer} cards in the player's deck.
+     */
     private final ArrayList<Gatherer> gatherers;
+
+    /**
+     * The current {@link Shaman Shaman} cards in the player's deck.
+     */
     private final ArrayList<Shaman> shamans;
+
+    /**
+     * The current {@link Hunter Hunter} cards in the player's deck.
+     */
     private final ArrayList<Hunter> hunters;
 
     /** @return this player's building cards. */
@@ -129,8 +157,6 @@ public class Player implements Serializable {
         return prestigeValue;
     }
 
-
-
     /**
      * Adds {@code value} amount of Food to the Player.
      * @param value The amount of Food to be added. Should be non-negative.
@@ -216,7 +242,6 @@ public class Player implements Serializable {
         this.totem = null;
     }
 
-
     /**
      * Checks equality between this {@code Player} and another object.
      * Two players are equal if and only if they share the same {@code userName}.