<< Return to Homework Page

Lab 8 : Starbox for Java

Lab Overview

StarBox for Java

The StarBox intergalactic shipping company has a bit of a problem. In the middle of a delivery, one of its shipping tankers accidentally released its cargo into the vacuum of space. Now there are pieces of cargo floating in space. To make matters worse, the cargo spilled into an asteroid field. A retrieval ship now must navigate the asteroid field to collect the cargo pieces without crashing! You can check out an applet version of this scenario below. Click the screen to start a new game and press the UP, DOWN, LEFT, and RIGHT keys to move your space ship (red circle) to collect all of the cargo pieces (green squares) while avoiding the asteroids (gray squares).

The picture above shows an example of the program you're about to create for this assignment. It's a game with a single ship piloted by the user (the red circle), a few asteroids (the light gray squares), and some cargo (the green squares).

This Assignment

Writing all of the code for the Starbox game would be a big task. Luckily, you don't have to write it all. There are 16 students currently in the class and each student is going to write a portion of the code. You will each be assigned a number, 1-16, designating which section of the code you are supposed to write. Each "section" should be about 1 fairly short method, or a couple of methods that are very similar in the code you write for each. The outline of the entire program, with all involved methods, can be found here.

  1. (Katie) General outline (imports, class header, implement listeners, declare global var's, include requried method headers). Also, write code for the "mouseClicked()" method.
    1. Section 1 Test Page
  2. (Holley) Write code for "keyPressed()" and "actionPerformed()"
    1. Respond to keys pressed by the user using "event.getKeyCode()" and comparing that to values like "KeyEvent.VK_UP". In the "actionPerformed()" method, just call "repaint()" to redraw the window each time the timer goes off.
    2. Section 2 Test Page
  3. (Lili) Write code for "updateXCoordinate()" and "updateYCoordinate()" methods
    1. Update the given coordinate using the given speed. Make sure that the resulting coordinate is wrapped back into the 400x400 window area.
    2. Section 3 Test Page
  4. (Anne) Write code for "updateAsteroidCoordinates()" method
    1. Update asteroid coordinate entries base on the asteroid speed entries. Call the "updateXCoordinate()" and "updateYCoordinate()" methods to do this.
    2. Section 4 Test Page
  5. (Jordan) Write code for "getScore()" method and "drawScore()" method
    1. Loop through entries in the "cargoDrawn" array to determine how many entries are set to "false"... meaning that that cargo piece has been collected. The current score is the number of cargo pieces collected so far.
    2. In the "drawScore()" method draw the score in the upper-left corner using the "p.drawString(String text, int x, int y)" method.
    3. Section 5 Test Page
  6. (Marc) Write code for "asteroidCollision()" and "cargoCollision()" methods.
    1. Given the uppper-left corner coordinates for the asteroid/cargo piece and for the ship, determine if those objects have collided. You will need to remember that asteroids and the ship are 20x20 pixels and the cargo pieces are 10x10. (This is really just a problem to determine if 2 square overlap.) Note that the Math.abs() method could be very useful here. This method takes in an integer value and returns the absolute value of that integer, such as Math.abs(2 - 4) returning the value 2.
    2. Section 6 Test Page
  7. (Raphael) Write code for "gameWon()" method
    1. Loop through the given array entries and use the "cargoCollision()" method to see if the ship has collided with any of the cargo pieces. If so, that cargo piece's entry in the "drawn" array should be set to "false". Finally, if all entries in that array have been set to "false", return "true" that the game has been won. Otherwise, return "false" that the game has not been won because there are still cargo pieces remaining unclaimed.
    2. Section 7 Test Page
  8. (Jeremy) Write code for "gameLost()" method
    1. Checks for asteroid collisions with the ship and returns true/false if the game has been lost.
    2. Section 8 Test Page
  9. (Erin) Write code for "isGameOver()" and "drawShip()" methods
    1. Draw the ship as a red circle inside of a 20x20 pixel green square outline. In the isGameOver() method use the "gameWon()" and "gameLost()" methods to determine if the game has already been won or lost. If it has, use the "drawString()" method (called as "p.drawString(String text, int x, int y)") to display an appropriate message. Also, call "timer.stop()" to stop the timer and stop the game.
    2. Section 9 Test Page
  10. (Kenny) Write code for "drawCargo()" and "drawAsteroids()" methods
    1. Loop through all entries in the given x- and y-coordinate arrays to draw the objects at the given locations. Note that cargo pieces will only be drawn if their corresponding entry in the "drawCargo" array is set to true. Cargo pieces should be drawn as 10x10 pixel green squares while asteroids should be drawn as 20x20 pixel gray squares.
    2. Section 10 Test Page
  11. (Saidi) Write code for "randomX(), randomY(), randomSpeedX()", and "randomSpeedY()" methods
    1. Return a random value, created by the random number generator variable gen appropriate for each of the methods. Note that calling gen.nextInt(10) will give you a random number in the range 0-9. The "Speed" methods should return a value in the range from -3 to 2. The "randomX()" and "randomY()" methods should return a value in the range 0 to 400.
    2. Section 11 Test Page
  12. (Kyle) Write code for "assignLocations()" method
    1. Use the "randomX()" and "randomY()" methods to place values in the x- and y-coordinate array entries for the asteroids and the cargo pieces.
    2. Section 12 Test Page
  13. (Ellie) Write code for "assignSpeeds()" method
    1. Use the "randomSpeedX()" and "randomSpeedY()" methods to place values into the x- and y-coordinate speed array entries for the asteroids.
    2. Section 13 Test Page
  14. (Christy) Write code for "paint()" method
    1. Draw in a black background for the 400x400 window.
    2. Call the "updateAsteroidCoordinates()" method to update the asteroids.
    3. Call the "updateXCoordinate()" method and place its returned value in the shipX variable.
    4. Call the "updateYCoordinate()" method to do the same for shipY
    5. Call the "drawAsteroids()", "drawCargo()", "drawShip()", and "drawScore()" methods to draw those parts.
    6. Call the "isGameOver()" method to check if the game should end.
    7. Section 14 Test Page
  15. (Daniel) Write code for "init()" method
    1. Call the "setSize()" method to initialize the size of the applet window to 400x400 pixels.
    2. Initialize the timer variable to a 50 millisecond delay and use the key word "this" to give it a listener.
    3. Call the "addMouseListener()" method and give it the key word "this".
    4. Call the "addKeyListener()" method and give it the key word "this".
    5. Call the "resetWindow()" method to initialize all of the pieces in the game.
    6. No Section 15 Test Page
  16. (Ryan) Write code for "resetWindow()" method
    1. Call the "assignLocations()" method to give the cargo pieces and asteroids initial locations.
    2. Call the "assignSpeeds()" method to give the asteroids initial speeds.
    3. Use the "randomX()" and "randomY()" methods to create inital values to be stored in the shipX and shipY variables.
    4. Initialize shipSpeedX and shipSpeedY to 0.
    5. Initialize the cargoDrawn array so that each cargo piece will initially be drawn.
    6. Call the "repaint()" method to make sure the changes are reflected on the screen.
    7. No Section 16 Test Page