cmsc389T- Project 3: PacMan Solved

 

Before You Start
Make sure you have completed Project 0 and set up your local environment. Your project manager should have set up a repository for you and your team to complete. Make sure you are working with that repository.

Introduction
In this project, you will be working in a team to develop the code for an Automonous PacMan. There are 4 parts to this project:

Code Development
Testing
Code Review
README
Each part has been created to be evenly distributed among your team. This means that we also will be grading most of your project score based on individual contribution.

Part 1
In this part of the project, you will develop code collaboratively with your team. There are 3 features that you will be working on:

FTR-pacman
FTR-ghost
FTR-map
For each feature, a template java file has been provided that you will be filling out with your team.

Each feature can be divided evenly among your group and each member should create their own feature-item branch off of the feature branch. First, create the 3 FTR branches for FTR-pacman, FTR-ghost, and FTR-map. Then, each member of your team can create a feature-item branch off of each of the FTR branches created. (One member should create the 3 main FTR branches and push them to the repository before everyone begins working on their sections). For example, if you are working on the PacMan class and have chosen to work on the getvalidmoves function, you should make a branch from FTR-pacman with the name pacman-getvalidmoves.

By the end of this section, you should have 12 feature item branches and 3 feature branches with your code. You should also have a corresponding kanban board card for each feature-item branch (Totaling to 3 cards per member).

Once this part has been completed, you should be able to see a JFrame appear that allows you to play Automonous PacMan by compiling and running your files:

javac -cp "src/" src/*.java
java -cp "src/" StartMenu

Make sure to run these commands from inside the P1 directory

javac - compiles all of the source files
java - runs the StartMenu java program
-cp - specifies the classpaths
Part 1a: PacMan Class
getvalidmoves()
Type: () -> ArrayList
Description: This method returns all the valid moves that PacMan can make given his current position.
Examples: java //pacman at location (9,11) pacman.get_valid_moves() -> {(9,12), (10,11), (10,12)} 
move()
Type: () -> Bool
Description: This method uses the getvalidmoves method to find the possible locations that PacMan can move, given his current location. The method then chooses to move in one of those directions. You are free to apply an algorithm here if you would like, but the only requirement is that you move in a valid direction. If PacMan is able to move, this function returns true otherwise it returns false.
Examples: java //pacman at location (9,11) pacman.move() -> true pacman.myLoc ∈ {(9,12), (10,11), (10,12)} 
isghostin_range()
Type: () -> Bool
Description: This method checks its surroundings to see if any Ghosts are in attack range. The attack radius of a ghost is 1 which means that a ghost at location   can attack PacMan as long as PacMan is located at  . If any Ghosts are in the attack range, this method returns true otherwise it returns false.
Examples: java //ghost at location (9,11) //pacman at location (9,12) pacman.is_ghost_in_range() -> true 
consume()
Type: () -> JComponent
Description: This method checks to see if there is a 'power-cookie' located in Pacman's current   coordinate. If there is, this method calls the eatCookie method from the Map Class, and returns the cookie component if the cookie a consumed, and null otherwise.
Examples:
//pacman at location (9,12)
//cookie NOT at location (9,12)
pacman.consume() -> null

Part 1b: Ghost Class
In this section, you must create a class for the ghosts that are moving around the map. The class and constructor are given to you in the Ghost.java file. Each team member should choose one of the following functions to complete and create a feature-item branch off of the FTR-ghost feature branch.

getvalidmoves()
Type: () -> ArrayList<Location>
Description: This function returns an arraylist of possible locations that a ghost can move to from its current location. Ghosts cannot move through walls, but they can move through other ghosts or PacMan.
Examples: java //ghost at location (9,11) ghost.get_valid_moves() -> {(9,12), (10,11), (10,12)} 
move()
Type: () -> Bool
Description: This function uses the getvalidmoves function to find the possible locations that a ghost can move to from its current location and chooses to move in one of those directions. You are free to apply an algorithm here if you would like, but the only requirement is that you move in a valid direction. If the ghost is able to move, this function returns true otherwise it returns false.
Examples: java //ghost at location (9,11) ghost.move() -> true ghost.myLoc ∈ {(9,12), (10,11), (10,12)} 
ispacmanin_range()
Type: () -> Bool
Description: This function checks its surroundings to see if PacMan is in attack range. The attack radius of a ghost is 1 which means that a ghost at location   can attack PacMan as long as PacMan is located at  . If PacMan is in the attack range, this function returns true otherwise it returns false.
Examples: java //ghost at location (9,11) //pacman at location (9,12) ghost.is_pacman_in_range() -> true 
attack()
Type: () -> Bool
Description: This function checks to see if PacMan is in the attack range by using the ispacmanin_range method and attacks PacMan if it is in range. This function returns true if the attack was successful and false otherwise.
Examples: java //ghost at location (9,11) //pacman at location (9,12) ghost.attack() -> true 
Map Class
The Map Class uses Java GUI to create the visual represenation of our game. For this project, we have given you most the code for the GUI with the exception of 4 methods which you will have to write. The goal of this section is to develop the interaction between pacman and walls and cookies as well as attacking ghosts.

move(String name, Location loc, Type type)
Type: (String name, Location loc, Type type) -> Bool
Description: The method takes a name, location, and type and put the object specified by the name at the location. If the function is able to successfull move the object it returns true, otherwise it returns false.
Examples: java //pacman at location (2,4) map.move("pacman", new Location (2,4), Map.Type.PACMAN) -> true 
getLoc(Location loc)
Type: (Location loc) -> HashSet<Type>
Description: For the given location argument, returns what is currently at the location (Empty, Pacman, Cookie, Ghost, Wall).
 //pacman at location (2,4)
 map.getLoc(new Location (2,4) -> Map.Type.PACMAN

attack(String name)
Type: (String name) -> Bool
Description: The method controls ghosts attacking pacman. If the ghost was able to successfully attack pacman and update the display to do so return true, otherwise return false.
 //ghost named clyde at location (9,11)
 //pacman at location (9,12)
 Map.attack("clyde") -> true

eatCookie(String Name)
Type: () -> JComponent
Description: The method controls Pacman eating a cookie. When the function is able to successfully update display to eat a cookie it returns the Cookie component that has been eaten, otherwise it returns null.
 //cookie NOT at location (4,6)
 //pacman at location (4,6)
 Map.eatCookie("pacman") -> null

Part 2: Writing Tests
In this section, you will write tests for each of the feature-items you have worked on. For each class, there is a tests file that contains a template for writing JUnit tests in the tests folder. In each feature-item, write a JUnit test that checks to see if the function you wrote is working correctly. To complete this part,

write a JUnit test for each function that you have completed
add and commit each test you wrote to your feature-item branch
Run the test! Make sure that your test passes when the code is correct
Make sure that you can break the code and that the test fails
We aren't necessarily looking for complete coverage with this section, but you are welcome to make your tests as robust as possible. It is important that your test passes when the code is correct and that you can modify your original code (to be incorrect) which will result in the test failing. You will be using these tests in Project 2.

Important Notes

When writing the tests, you may find some of the following commands useful:

//Creating A Map
Mainframe frame = new MainFrame(); //Creates A New Map With Walls and Tokens Initialized
NoFrame frame = new NoFrame(); //Creates A New Map With Walls and Tokens w/o a Display

//Creating Players
Ghost ghost = frame.addGhost(new Location(x, y), "name", Color.red); //Creates a red ghost named "name" at location x,y
PacMan pacman = frame.addPacMan(new Location(x, y)); //Creates PacMan at location x, y

//alternatively if you don't need the PacMan or Ghost objects in your tests
frame.initPlayers(); //Creates all of the players

//Start The Game
frame.startGame();

To compile your tests, run the following lines from the project directory in your command line:

javac -cp "tests/junit-4.10.jar:src/:tests/" src/*.java tests/*.java
java -cp "tests/junit-4.10.jar:src/:tests/" org.junit.runner.JUnitCore your_test_here
ex: java -cp "tests/junit-4.10.jar:src/:tests/" org.junit.runner.JUnitCore TestGhostMove

Part 3: Code Review
For this part of the project, each team member must submit a pull request for each feature-item that they have worked on. To do this,

Push each feature-item branch to your remote repository
Create a pull request for each feature-item to merge them with their respective feature branches
Assign yourself to the pull request
Assign one of your team membes as a reviewer
Link the pull request to your Kanban Card
Each team member must also review another team member's pull requests and

Read through the changes and leave comments or request changes if needed
Approve a pull request on Github Correctly
Complete the pull request by merging changes
To make it easier, you may want to have each team member review only one other team member's pull requests. This would gaurantee that everyone on the team will review the same number of pull requests.

Part 4: Writing a README
For this section you will be creating your own project README with your group. Each member of the group is expected to contribute to the README for the functions they were responsible for. All work for the README must be done on Github. We will be looking at who contributed to the README file for the purpose of grading, and will only consider contributions made to the file.

DO NOT USE GOOGLE DOCS TO CREATE THIS README. We have had to deduct points for this in the past, please do not do this.

Your README MUST have

A title
Your group members names
An image of your code playing PacMan
A section on how to run the code from the command line
include a code block
A list of the functions you wrote with
a description of the implementation for each function
a description of the test you wrote
The descriptions don't have to be long - a sentence or two would suffice.

Feel free to be creative and add any other elements. For example, you could

add a video of your code playing PacMan instead of an image
add small code blocks that supplement your descriptions
add a table of contents for your readme
These aren't required, but could be interesting to explore.