Tema - GwentStone

• Responsabili: Florian-Luis Micu, Andreea-Rebecca State, Andrei Oțetea
• Deadline hard: 24 noiembrie, ora 23:59
• Data publicării: 7 noiembrie, ora 23:15
• Ultima modificare a cerinței: 18 noiembrie (clarificare rând și coloană pentru input)
• Ultima modificare a scheletului: 13 noiembrie (adăugare a coordonatelor “x” si “y” pentru “getCardAtPosition”)

• Familiarizarea cu Java și conceptele de bază ale POO.
• Fundamentarea practică a constructorilor și a agregării/moștenirii.
• Dezvoltarea unor abilități de bază de organizare și design orientat obiect.
• Scrierea unui cod cât mai generic, ce va permite ulterior adăugarea de noi funcționalități.
• Respectarea unui stil de codare și de comentare.
• Dezvoltarea aptitudinilor de depanare a problemelor în cod.

Tocmai v-ați făcut primul vostru start-up. Fiind foarte pasionați de jocuri și de genul fantasy, ideea voastră de 1M de dolari este crearea unui joc de cărți pe calculator. Norocul vă surâde pentru că studioul CD Projekt Red pare că nu mai este în vogă în materie de jocuri așa că le puteți fura jocul de cărți, mai exact Gwent. Deoarece doriți ca jocul vostru să nu fie o copie care va fi ușor uitată, ați adăugat mecanisme noi care vor fi asemănătoare cu alte jocuri de cărți populare. Drept urmare, jocul vostru preia cele mai bune lucruri din Hearthstone și din Gwent, fiind mult mai ușor de implementat, dar și de jucat. De asemenea, ca în orice joc de calitate, o să ne asigurăm că avem și o poveste pe cinste pentru personajele noastre create.

Dorim ca jocul nostru să poată fi jucat de doi jucători în sistem amical. Cu toate acestea, pentru că încă suntem în etapa de dezvoltare a jocului în cadrul studioului nostru OOP-Everything, vom folosi un AI care va simula cei doi jucători. AI-ul vă va da comenzile de joc în input, împreună cu server-ul care vă va trimite și comenzi de debugging. Comenzile de debugging sunt făcute pentru a verifica statutul jocului în diverse etape, astfel vom putea depana mai ușor problemele care pot apărea în cadrul implementării. De asemenea, server-ul vă solicită și date pe care le va folosi pentru a crea statistici, cum ar fi numărul de câștiguri ale unui jucător și numărul total de jocuri terminate de cei doi jucători. La output dorim să printăm orice informație ne cere server-ul sau orice eroare întâmpinăm în cadrul unei acțiuni invalide.

Jocul vostru va fi jucat de către doi jucatori. Fiecare jucător are mai multe pachete de cărți numite deck-uri, iar fiecare dintre aceștia va trebui să își aleagă un pachet cu care va intra în joc. La începutul jocului, fiecărui jucător îi este asignat un erou care îl va reprezenta și se aruncă o monedă pentru a se stabili care jucător va începe. Jocul este “turn-based”, deci fiecare jucător va avea câte o tură pe care o încheie explicit. Dupa ce fiecare jucător își încheie tura, va începe o nouă rundă. La începutul rundei fiecare jucător primește “mana” care reprezintă valuta jocului apoi se trage o carte din deck și se introduce în mâna jucătorului. Cărțile din mâna unui jucător pot fi plasate pe masă pentru a fi folosite, dar pentru asta e nevoie de mana, deoarece fiecare carte “costă” mana pentru a putea fi plasata pe masa de joc. Masa de joc este un loc în care se plasează cărțile pentru a putea interacționa între ele. Fiecare jucător are 2 rânduri pe care poate pune o carte, cărțile fiind astfel făcute să poată fi plasate doar pe anumite rânduri. Cărțile care pot fi în mâna unui jucator sunt de doua tipuri: normale și environment. Cele normale pot fi plasate pe masă, cele environment afectează toate cărțile de pe un anumit rând. Eroii jucătorilor sunt prezenți pe masă de la începutul jocului într-un loc special și aceștia au abilități speciale care pot afecta rândurile cu cărți ale jucătorilor. De asemenea, cărțile normale de pe masă pot ataca eroii, astfel dacă un erou ajunge sa nu mai aibă viață se va termina jocul. Fiecare jucator are o metrică proprie în care se reține câte jocuri a câștigat și de câte ori a jucat un joc.

Masa de joc este locul unde cărțile vor interacționa direct între ele. Ea poate fi reprezentată ca o matrice de 4×5, fiecare jucător având 2 rânduri asignate lui. Cărțile se plasează pe câte un rând conform restricțiilor impuse mai jos, fiind introduse pe rând de la stânga la dreapta, mai exact adăugăm mereu o carte la dreapta ultimei cărți adăugate până se umple rândul. Dacă o carte este omorâtă, atunci toate cărțile din dreapta ei vor fi mutate cu o poziție la stânga (fenomen cunoscut ca shiftare la stânga). De asemenea, pe un rând pot exista maxim 5 cărți.

Rândurile 0 și 1 sunt asignate jucătorului 2, iar rândurile 2 și 3 sunt asignate jucătorului 1, conform imaginii de mai jos. Rândurile din față vor fi reprezentate de rândurile 1 și 2, iar rândurile din spate vor fi 0 si 3 (jucătorii vor fi așezați față în față). Totodată, eroii jucătorilor vor avea un loc special în care vor fi așezați de la începutul jocului.

Există mai multe tipuri de cărți pe care un jucător le poate deține, mai exact un jucător poate avea o carte de tipul minion sau o carte de tipul environment. De asemenea, fiecare jucător va avea o carte specială de tipul erou care îl va reprezenta în joc.

Aceste cărți au la bază atribute precum: mana (intreg), health (intreg), attackDamage (intreg), description (String), colors (String/Enum) si name (String). Mana este costul pe care îl va avea o carte pentru a putea fi folosită în timpul jocului, health reprezintă viața unei cărți, attackDamage reprezintă punctele de atac cu care o carte poate ataca altă carte, description este o descriere scurta a cărții, colors reprezintă culorile care alcătuiesc design-ul grafic al cărții și name este numele cărții. Aceste atribute le veți primi la input, fiecare carte având un set de valori specifice care vor fi randomizate. Drept urmare, două cărți cu același nume pot avea proprietăți diferite.

Din acest tipar fac parte cărțile următoare: Sentinel, Berserker, Goliath și Warden.

Pe lângă aceste cărți, mai există și cărți care posedă abilități speciale. Aceste cărți sunt: Miraj, The Ripper, Disciple și The Cursed One. Abilitățile speciale ale acestor cărți vor fi targetate către alte cărți pentru a activa următoarele efecte:

Weak Knees: -2 atac pentru un minion din tabăra adversă.

Skyjack: face swap între viața lui și viața unui minion din tabăra adversă.

Shapeshift: face swap între viața unui minion din tabăra adversă și atacul aceluiași minion

God's Plan: +2 viață pentru un minion din tabăra lui.

Aceste cărți au la bază atribute precum: mana, description, colors și name. Ele reprezintă efecte care pot fi aplicate terenului de joc, în povestea noastră fiind efecte naturale ale unei lumi din povești. Fiecare efect ia în considerare toate cărțile de pe rândul targetat. Cărțile de tip environment sunt următoarele:

Scade cu 1 viața tuturor minionilor de pe rând.

Toate cărțile de pe rând stau o tură.

Se fură minionul adversarului cu cea mai mare viață de pe rând și se pune pe rândul “oglindit” aferent jucătorului.

Există 4 eroi pe care un jucator îi poate avea. Fiecare erou are următoarele atribute: mana, description, colors și name. Fiecare erou are parametrul health fixat la 30. Dacă eroul ajunge în timpul jocului să fie atacat și să aibe viața 0, jocul se va opri și va câștiga atacatorul. Eroul fiecărui jucător este specificat în input la începutul jocului. Totodată, ei au abilități speciale care sunt declanșate pe un rând:

Sub-Zero: îngheață cartea cu cel mai mare atac de pe rând.

Low Blow: distruge cartea cu cea mai mare viață de pe rând.

Earth Born: +1 viață pentru toate cărțile de pe rând.

Blood Thirst: +1 atac pentru toate cărțile de pe rând.

Fiecare jucător are mai multe pachete cu care poate începe jocul, prima lui sarcină fiind să aleagă pachetul cu care dorește să joace. Veți primi la input numărul de pachete de cărți, numărul de cărți din fiecare pachet, o listă cu pachetele de cărți și jucătorul pentru care se aplică acești parametri.

"playerOneDecks": {
        "nrCardsInDeck": 3,
        "nrDecks": 2,
        "decks": [
          [
            {
              "mana": 1,
              "attackDamage": 1,
              "health": 7,
              "description": "Standard card: A warrior who is never afraid of battle, no matter the costs",
              "colors": [
                "Red",
                "Purple"
              ],
              "name": "Goliath"
            },
            {
              "mana": 1,
              "attackDamage": 0,
              "health": 1,
              "description": "Premium card: Nobody suspects an outcast, not even the Gods.",
              "colors": [
                "Black",
                "White",
                "Red"
              ],
              "name": "The Cursed One"
            },
            {
              "mana": 1,
              "description": "Premium card: Your mind is ours. Your body is ours. Stop begging.",
              "colors": [
                "Green",
                "Black"
              ],
              "name": "Heart Hound"
            }
          ],
          [
            {
              "mana": 1,
              "description": "Standard card: The dragon was unleashed, run for your lives.",
              "colors": [
                "Red",
                "Yellow"
              ],
              "name": "Firestorm"
            },
            {
              "mana": 1,
              "attackDamage": 2,
              "health": 2,
              "description": "Premium card: Fear him. Your last breath is now.",
              "colors": [
                "Red",
                "Blue",
                "Pink"
              ],
              "name": "Berserker"
            },
            {
              "mana": 1,
              "attackDamage": 0,
              "health": 1,
              "description": "Standard card: Thrown from the highest cliff, revenge will be his glory.",
              "colors": [
                "Pink",
                "Purple"
              ],
              "name": "The Cursed One"
            }
          ]
        ]
      }
    },
    {
      "playerTwoDecks": {
        "nrCardsInDeck": 3,
        "nrDecks": 2,
        "decks": [
          [
            {
              "mana": 1,
              "description": "Standard card: Corruption is easy, you always wanted it, now I help you embrace it.",
              "colors": [
                "Red",
                "White",
                "Grey"
              ],
              "name": "Heart Hound"
            },
            {
              "mana": 1,
              "attackDamage": 3,
              "health": 2,
              "description": "Premium card: Fear him. Your last breath is now.",
              "colors": [
                "Purple",
                "Yellow"
              ],
              "name": "Berserker"
            },
            {
              "mana": 1,
              "attackDamage": 0,
              "health": 3,
              "description": "Standard card: Thrown from the highest cliff, revenge will be his glory.",
              "colors": [
                "Black",
                "White",
                "Red"
              ],
              "name": "The Cursed One"
            }
          ],
          [
            {
              "mana": 1,
              "attackDamage": 1,
              "health": 2,
              "description": "Standard card: Trained by the best, nothing will catch him off-guard.",
              "colors": [
                "Black",
                "Grey",
                "Blue"
              ],
              "name": "Sentinel"
            },
            {
              "mana": 1,
              "description": "Standard card: The dragon was unleashed, run for your lives.",
              "colors": [
                "Red",
                "Yellow"
              ],
              "name": "Firestorm"
            },
            {
              "mana": 1,
              "attackDamage": 6,
              "health": 4,
              "description": "Standard card: Death incarnate. No better time to die than now.",
              "colors": [
                "Orange",
                "Red",
                "Black"
              ],
              "name": "The Ripper"
            }
          ]
        ]
      }
    }

Fiecare jucător își alege un deck, acesta fiind specificat de AI în input. Deck-ul ales de fiecare jucător va fi amestecat la începutul jocului, deoarece dorim ca jocul sa nu fie previzibil. Pentru a ne asigura că rezultatele vor fi deterministe, server-ul va trimite la input și un seed folosit ca parametru pentru procesul de amestecare.

Server-ul alege câte un erou aleator pentru fiecare jucător, aceștia fiind specificați la input.

Se alege un jucător care să înceapă prima rundă, fiind specificat la input.

"startGame": {
        "playerOneDeckIdx": 1,
        "playerTwoDeckIdx": 0,
        "shuffleSeed": 882661,
        "playerOneHero": {
          "mana": 2,
          "description": "Standard card: Absolute order, a soldier must devote his life to his General.",
          "colors": [
            "Red",
            "Black",
            "Purple"
          ],
          "name": "General Kocioraw"
        },
        "playerTwoHero": {
          "mana": 2,
          "description": "Premium card: Glory to all we see, glory to all he is, glory to everyone who will try to escape him.",
          "colors": [
            "Black",
            "Red",
            "Grey"
          ],
          "name": "Lord Royce"
        },
        "startingPlayer": 1
      }

La începutul fiecărei runde, ambii jucători primesc prima carte disponibilă din pachetul de cărți ales. Cartea primită de fiecare jucător va fi adăugată în “mâna” acestuia. Cartea primită este adăugată la sfârșitul listei de cărți din mână.

De asemenea, ambii jucători primesc mana la începutul fiecărei runde. Mana pe care o primesc jucătorii în prima rundă este 1, urmând ca aceasta sa fie incrementată pana la 10. In momentul în care se ajunge la 10 mana, aceasta nu va mai fi incrementată.

La finalul turei unui jucător, cărțile acestuia care au fost marcate ca fiind “frozen” sunt demarcate, întrucât acestea au stat o tura.

Totodată, se verifică dacă ambii jucători și-au sfârșit turele în cadrul rundei curente. Dacă această condiție este adevarată, se trece la următoarea rundă si se aplică pașii descriși mai sus.

Marcarea sfârșitului unei ture va fi precizată explicit de AI în input pentru jucătorul curent.

{
    "command": "endPlayerTurn"
}

Cărțile din mână pot fi plasate pe masă, cu condiția ca acestea să nu fie cărți de tipul environment și ca acestea să nu aibă costul de mana mai mare decât mana jucătorului.

Cărțile trebuie plasate pe masă, pe rândul aferent jucătorului, dar și al tipului de carte (conform secțiunilor de mai sus).

AI-ul vă va preciza în input indexul cărții din mână pe care dorește să o plaseze pe masa.

Cazurile invalide trebuie testate la acest pas în această ordine:

1. Se verifică dacă cartea nu este de tipul environment, altfel se printeză: ”Cannot place environment card on table.”
2. Se verifică dacă cartea are costul mai mic decât mana jucătorului, altfel se printează: ”Not enough mana to place card on table.”
3. Se verifică dacă rândul pe care trebuie plasata cartea nu este plin, altfel se printează: ”Cannot place card on table since row is full.”

{
    "command": "placeCard",
    "handIdx": 1
}

{
    "command": "placeCard",
    "handIdx": 0,
    "error": "Cannot place environment card on table."
}

Fiecare carte plasată pe masă poate ataca altă carte care se află pe masa. În acest pas, se dorește ca viața minion-ului adversar țintit să scadă cu atâtea puncte câte puncte are cartea atacatorului în câmpul attackDamage. Daca viața cărții atacate ajunge să fie ⇐ 0, aceasta este eliminată de pe masă. O carte poate ataca o altă carte o singură dată per tură. După ce cartea și-a folosit atacul, aceasta nu va mai putea ataca altă carte sau erou decât tura următoare.

AI-ul va specifica în input coordonatele de pe masă a cărții atacate și a cărții atacatorului.

Cazurile invalide care trebuie testate în acest pas sunt:

1. Se verifică dacă cartea atacată este o carte a inamicului, altfel se printează: ”Attacked card does not belong to the enemy.”.
2. Se verifică dacă cartea atacatorului nu a atacat/folosit abilitatea specială deja tura aceasta, altfel se printează: ”Attacker card has already attacked this turn.”.
3. Se verifică dacă cartea atacatorului nu este “frozen”, altfel se printează: ”Attacker card is frozen.”.
4. Se verifică dacă există o carte Tank pe rândurile adversarului.
   1. Se verifică mai departe dacă aceasta a fost selectată pentru atac, altfel se printează: ”Attacked card is not of type 'Tank’.”.

{
    "command": "cardUsesAttack",
    "cardAttacker": {
         "x": 1,
         "y": 0
     },
     "cardAttacked": {
         "x": 3,
         "y": 0
     }
}

{
    "command": "cardUsesAttack",
    "cardAttacker": {
      "x": 3,
      "y": 1
    },
    "cardAttacked": {
      "x": 3,
      "y": 1
    },
    "error": "Attacked card does not belong to the enemy."
}

Fiecare carte plasată pe masă își poate folosi abilitatea pe altă carte care se află pe masă. Fiecare abilitate specială va avea un efect diferit asupra celui atacat, abilitățile fiind descrise și asociate cu anumiți minioni conform secțiunilor de mai sus.

AI-ul va specifica în input coordonatele de pe masă a cărții atacate și a cărții atacatorului.

Cazurile invalide trebuie testate la acest pas în această ordine:

1. Se verifică dacă cartea atacatorului nu este “frozen”, altfel se printează: ”Attacker card is frozen.”.
2. Se verifică dacă cartea atacatorului nu a atacat/folosit abilitatea specială deja tura aceasta, altfel se printează: ”Attacker card has already attacked this turn.”.
3. Se verifică dacă atacatorul este Disciple.
   1. Se verifică dacă cartea atacată este o carte aliată, altfel se printează: ”Attacked card does not belong to the current player.”.
4. Se verifică dacă atacatorul este The Ripper, Miraj sau The Cursed One
   1. Se verifică dacă cartea atacată este o carte a inamicului, altfel se printează: ”Attacked card does not belong to the enemy.”.
   2. Se verifică dacă există o carte Tank pe rândurile adversarului.
      1. Se verifică mai departe dacă aceasta a fost selectată pentru atac, altfel se printează: ”Attacked card is not of type 'Tank’.”.

{
    "command": "cardUsesAbility",
    "cardAttacker": {
        "x": 2,
        "y": 0
     },
     "cardAttacked": {
        "x": 1,
        "y": 0
     }
}

{
    "command": "cardUsesAbility",
    "cardAttacker": {
      "x": 3,
      "y": 0
    },
    "cardAttacked": {
      "x": 3,
      "y": 0
    },
    "error": "Attacker card is frozen."
}

Fiecare carte plasată pe masă poate ataca eroul inamicului. În acest pas, se dorește ca viața eroului să scadă cu atâtea puncte câte are atacatorul atributul attackDamage. La finalul comenzii se verifică dacă eroul inamicului a murit, în acest caz jocul fiind câștigat de jucătorul curent.

AI-ul va specifica în input coordonatele de pe masă a cărții atacatorului.

Cazurile invalide trebuie testate la acest pas în această ordine:

1. Se verifică dacă cartea atacatorului nu este “frozen”, altfel se printează: ”Attacker card is frozen.”
2. Se verifică dacă cartea atacatorului nu a atacat/folosit abilitatea specială deja tura aceasta, altfel se printează: ”Attacker card has already attacked this turn.”
3. Se verifică dacă există o carte Tank pe rândurile adversarului.
   1. Se verifică mai departe dacă aceasta a fost selectată pentru atac, altfel se printează: ”Attacked card is not of type 'Tank’.”

{
    "command": "useAttackHero",
    "cardAttacker": {
        "x": 3,
        "y": 0
     }
}

  {
    "command": "useAttackHero",
    "cardAttacker": {
      "x": 2,
      "y": 0
    },
    "error": "Attacked card is not of type 'Tank'."
  }

{
   "gameEnded": "Player one killed the enemy hero."
}

Fiecare erou poate ataca un rând de pe masă. Abilitățile eroilor sunt descrise în secțiunile de mai sus, aceștia având posibilitatea să atace doar minioni ai adversarului sau minioni aliați în funcție de abilitate.

AI-ul vă specifică în input rândul ales pentru abilitate.

Cazurile invalide trebuie testate la acest pas în această ordine:

1. Se verifică dacă jucătorul are destulă mana ca să folosească eroul, altfel se printează: ”Not enough mana to use hero's ability.”
2. Se verifică dacă eroul nu a atacat deja tura aceasta, altfel se printează: ”Hero has already attacked this turn.”
3. Se verifică dacă eroul este Lord Royce sau Empress Thorina.
   1. Se verifică mai departe dacă rândul selectat pentru abilitate este un rând al adversarului, altfel se printează: “Selected row does not belong to the enemy.”
4. Se verifică dacă eroul este General Kocioraw sau King Mudface.
   1. Se verifică mai departe dacă rândul selectat pentru abilitate este un rând al jucătorului curent, altfel se printează: “Selected row does not belong to the current player.”

{
    "command": "useHeroAbility",
    "affectedRow": 3
}

{
    "command": "useHeroAbility",
    "affectedRow": 3,
    "error": "Selected row does not belong to the enemy."
}

Cărțile de tip environment sunt ținute în mâna jucătorilor, acestea putând fi aplicate asupra unui rând al mesei. Abilitatea unei cărți de environment este fixată pentru fiecare carte de acest tip și este descrisă în secțiunile de mai sus.

AI-ul va specifica în input rândul ales pentru efectul cărții de environment și indexul cărții din mână.

Cazurile invalide trebuie testate la acest pas în această ordine:

1. Se verifică dacă indexul ales corespunde unei cărți de tipul environment în lista de cărți din mână, altfel se printează: “Chosen card is not of type environment.”.
2. Se verifică dacă jucătorul are destulă mana ca să folosească cartea de environment, altfel se printează: “Not enough mana to use environment card.”.
3. Se verifică dacă randul afectat este al inamicului, altfel se printează: ”Chosen row does not belong to the enemy.”.
4. Pentru cartea Heart Hound, se verifică dacă rândul oglindă al cărții targetate nu este deja full pentru jucătorului curent, altfel se printează: ”Cannot steal enemy card since the player's row is full.”.

{
   "command": "useEnvironmentCard",
   "handIdx": 0,
   "affectedRow": 0
}

{
   "command": "useEnvironmentCard",
   "handIdx": 1,
   "affectedRow": 2,
   "error": "Chosen row does not belong to the enemy."
}

Pe parcursul jocului, server-ul vă poate cere oricând anumiți parametri pentru a verifica implementarea voastră.

Pentru această comandă trebuie să puneți în output toate cărțile care se află în mâna jucătorului dat ca parametru la input.

{
    "command": "getCardsInHand",
    "playerIdx": 2
}

{
    "command": "getCardsInHand",
    "playerIdx": 2,
    "output": [
      {
        "mana": 4,
        "attackDamage": 2,
        "health": 7,
        "description": "Premium card: No matter how many, his body will fight. Save your breath for the Mountain is strong.",
        "colors": [
          "Red",
          "Purple"
        ],
        "name": "Goliath"
      },
      {
        "mana": 4,
        "attackDamage": 4,
        "health": 4,
        "description": "Standard card: When he is near, close your eyes. They betray your mind.",
        "colors": [
          "Red",
          "Black"
        ],
        "name": "Miraj"
      }
    ]
}

Pentru această comandă trebuie să puneți în output toate cărțile care se află în deck-ul jucătorului dat ca parametru la input.

{
    "command": "getPlayerDeck",
    "playerIdx": 2
}

{
    "command": "getPlayerDeck",
    "playerIdx": 2,
    "output": [
      {
        "mana": 3,
        "attackDamage": 3,
        "health": 5,
        "description": "Standard card: He has seen everything, his mind has never been asleep since the making of the realm.",
        "colors": [
          "Brown",
          "Blue"
        ],
        "name": "Warden"
      }
    ]
}

Pentru această comandă trebuie să afișați la output toate cărțile prezente pe masă. Cărțile trebuie printate începând de la rândul 0, coloana 0 până la rândul 3, coloana 4, conform pozei de mai sus.

{
    "command": "getCardsOnTable"
}

{
    "command": "getCardsOnTable",
    "output": [
      {
        "mana": 3,
        "attackDamage": 6,
        "health": 3,
        "description": "Premium card: Ravished by the winds of hell, no soul is to be forgiven.",
        "colors": [
          "Orange",
          "Red",
          "Black"
        ],
        "name": "The Ripper"
      },
      {
        "mana": 5,
        "attackDamage": 4,
        "health": 3,
        "description": "Standard card: When he is near, close your eyes. They betray your mind.",
        "colors": [
          "Yellow",
          "Orange",
          "Red"
        ],
        "name": "Miraj"
      },
      {
        "mana": 4,
        "attackDamage": 6,
        "health": 3,
        "description": "Standard card: Death incarnate. No better time to die than now.",
        "colors": [
          "Orange",
          "Red",
          "Black"
        ],
        "name": "The Ripper"
      },
      {
        "mana": 3,
        "attackDamage": 1,
        "health": 8,
        "description": "Standard card: A warrior who is never afraid of battle, no matter the costs",
        "colors": [
          "Brown",
          "Black",
          "Grey"
        ],
        "name": "Goliath"
      },
      {
        "mana": 3,
        "attackDamage": 5,
        "health": 3,
        "description": "Premium card: Ravished by the winds of hell, no soul is to be forgiven.",
        "colors": [
          "Black",
          "Yellow"
        ],
        "name": "The Ripper"
      },
      {
        "mana": 3,
        "attackDamage": 2,
        "health": 5,
        "description": "Standard card: He has seen everything, his mind has never been asleep since the making of the realm.",
        "colors": [
          "Black",
          "White",
          "Green"
        ],
        "name": "Warden"
      },
      {
        "mana": 4,
        "attackDamage": 4,
        "health": 4,
        "description": "Standard card: When he is near, close your eyes. They betray your mind.",
        "colors": [
          "Red",
          "Black"
        ],
        "name": "Miraj"
      },
      {
        "mana": 2,
        "attackDamage": 3,
        "health": 6,
        "description": "Standard card: He has seen everything, his mind has never been asleep since the making of the realm.",
        "colors": [
          "Brown",
          "Blue"
        ],
        "name": "Warden"
      },
      {
        "mana": 4,
        "attackDamage": 2,
        "health": 7,
        "description": "Premium card: No matter how many, his body will fight. Save your breath for the Mountain is strong.",
        "colors": [
          "Red",
          "Purple"
        ],
        "name": "Goliath"
      },
      {
        "mana": 4,
        "attackDamage": 1,
        "health": 7,
        "description": "Premium card: No matter how many, his body will fight. Save your breath for the Mountain is strong.",
        "colors": [
          "Red",
          "Purple"
        ],
        "name": "Goliath"
      }
    ]
  }

Pentru această comandă trebuie să printați la output jucătorul activ (adică jucătorul care nu și-a încheiat încă tura).

{
    "command": "getPlayerTurn"
}

{
    "command": "getPlayerTurn",
    "output": 2
}

Pentru această comandă trebuie să printați la output eroul jucătorului dat ca parametru la input.

{
    "command": "getPlayerHero",
    "playerIdx": 1
}

{
    "command": "getPlayerHero",
    "playerIdx": 1,
    "output": {
      "mana": 2,
      "description": "Premium card: An army is not sufficient, he is ready obliterate, it is time for chaos.",
      "colors": [
        "Red",
        "Black",
        "Purple"
      ],
      "name": "General Kocioraw",
      "health": 30
    }
  }

Pentru această comandă trebuie să printați la output cartea aflată la poziția dată în input.

{
   "command": "getCardAtPosition",
   "x": 3,
   "y": 0
}

{
    "command": "getCardAtPosition",
    "x": 3,
    "y": 0,
    "output": {
      "mana": 2,
      "attackDamage": 0,
      "health": 3,
      "description": "Premium card: Nobody suspects an outcast, not even the Gods.",
      "colors": [
        "Black",
        "White",
        "Red"
      ],
      "name": "The Cursed One"
    }
}

{
    "command": "getCardAtPosition",
    "x": 3,
    "y": 0,
    "output": "No card available at that position."
}

Pentru această comandă trebuie să printați la output mana unui jucător primit la input.

{
    "command": "getPlayerMana",
    "playerIdx": 2
}

{
    "command": "getPlayerMana",
    "playerIdx": 2,
    "output": 3
}

Pentru această comandă trebuie să printați la output toate cărțile de environment prezente în mâna jucătorului dat ca input. Ordinea cărților de environment trebuie să fie identică cu ordinea lor din mâna jucătorului.

{
  "command": "getEnvironmentCardsInHand",
  "playerIdx": 1
}

{
   "command": "getEnvironmentCardsInHand",
   "playerIdx": 1,
   "output": [
     {
       "mana": 2,
       "description": "Premium card: Your mind is ours. Your body is ours. Stop begging.",
       "colors": [
         "Red",
         "White",
         "Grey"
       ],
       "name": "Heart Hound"
     },
     {
       "mana": 2,
       "description": "Premium card: Your mind is ours. Your body is ours. Stop begging.",
       "colors": [
         "Green",
         "Black"
       ],
       "name": "Heart Hound"
     }
   ]
}

Pentru această comandă trebuie să printați la output toate cărțile de pe masă care au flag-ul “frozen” setat. Ordinea printării trebuie să respecte ordinea cărților de pe masă, mai exact se începe de la linia 0, coloana 0 și se termină la linia 3, coloana 4.

{
   "command": "getFrozenCardsOnTable"
}

{
  "command": "getFrozenCardsOnTable",
  "output": [
    {
      "mana": 1,
      "attackDamage": 6,
      "health": 4,
      "description": "Premium card: Ravished by the winds of hell, no soul is to be forgiven.",
      "colors": [
        "Orange",
        "Red",
        "Black"
      ],
      "name": "The Ripper"
    }
  ]
}

Statisticile sunt reprezentate de numărul total de jocuri la care a participat fiecare jucator și numărul total de câștiguri

Pentru această comandă va trebui să afișați la output numărul total de jocuri jucate de ambii jucători.

{
   "command": "getTotalGamesPlayed"
}

{
   "command": "getTotalGamesPlayed",
   "output": 2
}

Pentru această comanda va trebui să afișați la output numărul total de jocuri câștigate de un jucător. Vor exista două comenzi pentru fiecare jucător (“getPlayerOneWins” si “getPlayerTwoWins”).

{
   "command": "getPlayerOneWins"
}

{
   "command": "getPlayerTwoWins",
   "output": 2
}

În rezolvarea temei va fi nevoie de folosirea unor obiecte pentru stocarea și maparea datelor primite în format JSON. Scheletul temei vă oferă mai multe clase utile pentru citirea și rularea temei. Acestea se regăsesc în cadrul scheletului astfel:

• Clasele de input din cadrul pachetului fileio : Acestea se vor folosi pentru parsarea datelor de input. Astfel preluați toate informațiile necesare pentru a crea propriile clase pentru rezolvarea temei.
• Clasa Main care este punctul de intrare pentru logica de rezolvare a temei.

Pentru a întelege mai bine cum funcționează citirea/scrie în fișierele JSON vă recomandăm să citiți Json & Jackson.

1. Se încarcă datele citite din fișierul de test, în format JSON, în obiecte.
2. Se primesc secvențial acțiuni și se execută pe măsură ce sunt primite, rezultatul lor având efect asupra Repository-ului.
3. După executarea unei acțiuni, se afișează rezultatul ei în fișierul JSON de ieșire.
4. La terminarea tuturor acțiunilor se termină și execuția programului.

• Tema a fost concepută pentru a vă testa cunoștințele dobândite în urma parcurgerii laboratoarelor 1-4, aceasta putând fi rezolvată doar cu noțiunile invățate din acele laboratoare. Cu toate acestea, vă sugerăm să vă folosiți și de noțiunile învățate în laboratorul 5, deoarece acestea vă pot ajuta în crearea/modelarea claselor si ierarhiilor.
• Pentru depanarea diferențelor dintre output-ul vostru si fișierele ref, vă recomandăm acest site.
• Verificați periodic această pagină, deoarece scheletul/cerința pot suferi modificări în urma unor erori din partea noastră.

Punctajul constă din:

• 80p implementare - trecerea testelor
• 10p coding style (vezi checkstyle)
• 5p README clar, concis, explicații axate pe design (flow, interacțiuni)
• 5p folosire git pentru versionarea temei

Depunctările pentru designul și organizarea codului se vor scădea din punctajul testelor. Dacă vor apărea depunctări specifice temei în momentul evaluării, nemenționate pe pagina cu depunctări generale, ele se vor încadra în limitele de maxim 15 pentru design, 5p pentru readme. Dacă tema nu respecta cerințele, sau are zero design OOP atunci se pot face depunctari suplimentare.

Folosirea git pentru versionare va fi verificata din folderul .git pe care trebuie să îl includeți în arhiva temei. Punctajul se va acorda dacă ați făcut minim 3 commit-uri relevante și cu mesaj sugestiv. NU este permis să aveți repository-urile de git publice până la deadline-ul hard.

Bonusuri: La evaluare, putem oferi bonusuri pentru design foarte bun, cod bine documentat dar și pentru diverse elemente suplimentare alese de voi.

Unul din obiectivele temei este învățarea respectării code-style-ului limbajului pe care îl folosiți. Aceste convenții (de exemplu cum numiți fișierele, clasele, variabilele, cum indentați) sunt verificate pentru temă de către tool-ul checkstyle.

Pe pagina de Recomandări cod găsiți câteva exemple de coding style.

Dacă numărul de erori depistate de checkstyle depășește 30, atunci punctele pentru coding-style nu vor fi acordate. Dacă punctajul este negativ, acesta se trunchiază la 0.

Exemple:

• punctaj_total = 100 și nr_erori = 200 ⇒ nota_finala = 90
• punctaj_total = 100 și nr_erori = 29 ⇒ nota_finala = 100
• punctaj_total = 80 și nr_erori = 30 ⇒ nota_finala = 80
• punctaj_total = 80 și nr_erori = 31 ⇒ nota_finala = 70

Arhiva pe care o veţi urca pe VMChecker va trebui să conţină în directorul rădăcină:

• fișierul README
• folder-ul src cu pachetele și cu fișierele .java
• folderul .git

Q: Pot folosi biblioteca “X”?
A: Dacă doriți să folosiți o anumită bibliotecă vă recomandăm să întrebați pe forum, ca apoi să o validăm și să o includem și pe Vmchecker.

Q: Am descoperit edge case-ul “Y”, trebuie să îl tratez?
A: Nu. Toate datele necesare pentru soluționarea temei vă sunt date in cerință. Dacă totuși am omis ceva ne puteți contacta pe forum.

Q: Pot folosi clase de tip “Enum” pentru constante?
A: Da.

Q: Ce JDK recomandați?
A: Momentan, orice JDK de la versiunea 11 până în prezent. Dacă vor apărea probleme cu Vmchecker vă vom anunța ca să schimbați JDK-ul cu unul compatibil.

Q: Pot să fac în orice ordine testele?
A: Da! Testele au fost concepute sa fie cât mai decuplate și să testeze câte o funcționalitate în întregime. Cu toate astea, vă recomandăm să implementați mai întâi testele 01, 02, 03 deoarece reprezintă preambulul fiecărui joc. De asemenea, vă recomandăm să implementați și testele 04 și 05 pentru că unele teste verifică dacă ați tratat edge case-ul unei cărți înghețate și pentru asta e nevoie să puteți să inghețați o carte mai întâi.

• Schelet de cod
• Forum
• Hearthstone short gameplay
• Gwent short gameplay
• Indicații pentru teme
• Recomandări coding style & javadoc