Objektstrukturer - Sokoban-oppgave

Oppgaven handler om en Sokoban-klasse som holder representasjon, logikk og funksjonalitet for å la to spillere spille ”Sokoban” gjennom konsollen.

Oppgaven handler om spillet Sokoban. Spillet går ut på at et brett inneholder mål, bokser, vegger og en spiller. Spilleren skal forsøke å flytte alle boksene til et mål. Spilleren vinner spillet når alle boksene står på et mål.

Oppgaven omfatter tre klasser, Cell, Sokoban og SokobanProgram. Cell-klassen representer hvert enkelt felt på brettet og dekkes av del 1. Sokoban-klassen kapsler inn brettet og har metoder for å utføre trekk og sjekke om spillet er avsluttet. Dette presenteres i del 2. Begge disse dele har har JExercise-tester. SokobanProgram-klassen lages i del 3 og håndterer tekstbasert interaksjon og bruker Sokoban-klassen. Her skal spilleren taste inn ønsket trekk etter tur helt til man har vunnet eller gir opp. 

Del 1 - Representasjon av felter

Denne klassen er en hjelpeklasse for å holde styr på verdien til hvert enkelt felt på brettet.

Tilstanden til en Cell er et tegn, e.g. ’#’ for vegg eller ’+’ for spiller, samt posisjon på brettet, angitt som x- og y- koordinater.

Cell-klassen må ha følgende metoder:

• void RemoveBox() - fjerner en boks fra feltet.
• void RemovePlayer() –fjerner spilleren fra feltet.
• void AddPlayer() – setter spilleren på feltet.
• boolean isTarget() – returnerer hvorvidt feltet er et mål eller ikke.
• boolean isFree()  - returnerer hvorvidt det er mulig å flytte en boks eller spilleren til feltet.
• boolean containsPlayer() -  returnerer om spilleren står på feltet.
• boolean containsBox()  - returnerer om en boks står på feltet.
• String toString() – skriver tegnet på feltet til en streng.

Merk at man i alle metoder må sikre at det spillet er i gyldig tilstand før man og etter man utfører en operasjon.

Implementer støtte for tilstand og metoder beskrevet over slik at JExercise-testkoden fullfører feilfritt. Testkoden finner du her: 

Del 2 – Logikk og representasjon av brett

Tilstanden i Sokoban-klassen må holde rede på flere ting. Man må håndtere hvordan brettet ser ut til enhver tid. Videre må man holde styr på hvor målene på brettet befinner seg. Spillerens posisjon må også lagres.

Det finnes mange ulike brett av forskjellig størrelse. Tilstanden bør derfor lagre størrelsen på brettet, både høyde og bredde. Brettet utgjør et koordinatsystem med følgende innhold:

Sokoban-klassen må ha følgende metoder:

• Sokoban(String[]) – konstruktøren skal ta inn en array med strenger som utgjør brettet. Strengene må leses for å angi starttilstanden til brettet.
• boolean canMove(int) – denne metoden tar inn en retning og angir om spilleren kan bevege seg i denne retningen eller ikke.
• void doMove(int) – denne metoden tar inn en retning og flytter spilleren og en eventuell boks i den angitte retningen på brettet.
• boolean hasWon() – denne metoden returnerer hvorvidt spilleren har vunnet eller ikke; med andre ord om alle målene har bokser på.
• String toString() – denne metoden returnerer brettet som en streng, hvor hver linje er adskilt med ”\n”.

Implementer støtte for tilstand og metoder beskrevet over slik at JExercise-testkoden fullfører feilfritt. Testkoden finner du her: 

Del 3 - Fullt fungerende spill, med tekstlig interaksjon

Lag SokobanProgram klasse som lar deg spille spillet gjennom konsollen. Programmet må:

• skrive ut brettet.
• be om og lese inn retningen spilleren skal bevege seg med en Scanner. Vanlig spillkutyme er at ’w’, ’s’, ’a’ og ’d’ representerer henholdsvis bevegelse fremover (nord), bakover (sør), venstre (vest) og høyre (øst). Hvis spilleren forsøker et ulovlig trekk, e.g. gå inn i en vegg eller skyve en boks på en annen boks, skal det skrives ut en beskjed om at trekket er ulovlig.
• utføre trekket.
• gjenta dette helt til spilleren har vunnet eller valgt å avslutte. Hvis spilleren vinner må dette skrives ut til konsollen.