Class Level

java.lang.Object

Level

public class Level
extends java.lang.Object

The Level class is responsible for managing all of the objects in your game. The GameEngine creates a new Level object for each level, and then calls that Level object's update() method repeatedly until it returns either "ADVANCE" (to go to the next level), or "QUIT" (to end the entire game).

This class should contain and use at least the following private fields:

• private Random randGen;
• private Hero hero;
• private Water[] water;
• private ArrayList<Pant> pants;
• private ArrayList<Fireball> fireballs;
• private ArrayList<Fire> fires;

Constructor Summary

Constructors

Constructor and Description
Level(java.util.Random randGen, java.lang.String level) This constructor initializes a new Level object, so that the GameEngine can begin calling its update() method to advance the game's play.

Method Summary

Modifier and Type	Method and Description
void	createRandomLevel() This method creates a random level consisting of a single Hero centered in the middle of the screen, along with 6 randomly positioned Fires, and 20 randomly positioned Pants.
java.lang.String	getHUDMessage() This method returns a string of text that will be displayed in the upper left hand corner of the game window.
void	loadLevel(java.lang.String level) This method initializes the current game according to the Object location descriptions within the level parameter.
static void	main(java.lang.String[] args) This method creates and runs a new GameEngine with its first Level.
java.lang.String	update(int time) The GameEngine calls this method repeatedly to update all of the objects within your game, and to enforce all of the rules of your game.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Level

public Level(java.util.Random randGen,
             java.lang.String level)

This constructor initializes a new Level object, so that the GameEngine can begin calling its update() method to advance the game's play. In the process of this initialization, all of the objects in the current level should be instantiated and initialized to their beginning states.

Parameters:

randGen - is the only Random number generator that should be used throughout this level, by the Level itself and all of the Objects within.

level - is a string that either contains the word "RANDOM", or the contents of a level file that should be loaded and played.

Method Detail

update

public java.lang.String update(int time)

The GameEngine calls this method repeatedly to update all of the objects within your game, and to enforce all of the rules of your game.

Parameters:

time - is the time in milliseconds that have elapsed since the last time this method was called. This can be used to control the speed that objects are moving within your game.

Returns:

When this method returns "QUIT" the game will end after a short 3 second pause and a message indicating that the player has lost. When this method returns "ADVANCE", a short pause and win message will be followed by the creation of a new level which replaces this one. When this method returns anything else (including "CONTINUE"), the GameEngine will simply continue to call this update() method as usual.

getHUDMessage

public java.lang.String getHUDMessage()

This method returns a string of text that will be displayed in the upper left hand corner of the game window. Ultimately this text should convey the number of unburned pants and fires remaining in the level. However, this may also be useful for temporarily displaying messages that help you to debug your game.

Returns:

a string of text to be displayed in the upper-left hand corner of the screen by the GameEngine.

createRandomLevel

public void createRandomLevel()

This method creates a random level consisting of a single Hero centered in the middle of the screen, along with 6 randomly positioned Fires, and 20 randomly positioned Pants.

loadLevel

public void loadLevel(java.lang.String level)

This method initializes the current game according to the Object location descriptions within the level parameter.

Parameters:

level - is a string containing the contents of a custom level file that is read in by the GameEngine. The contents of this file are then passed to Level through its Constructor, and then passed from there to here when a custom level is loaded. You can see the text within these level files by dragging them onto the code editing view in Eclipse, or by printing out the contents of this level parameter. Try looking through a few of the provided level files to see how they are formatted. The first line is always the "ControlType: #" where # is either 1, 2, or 3. Subsequent lines describe an object TYPE, along with an X and Y position, formatted as: "TYPE @ X, Y". This method should instantiate and initialize a new object of the correct type and at the correct position for each such line in the level String.

main

public static void main(java.lang.String[] args)

This method creates and runs a new GameEngine with its first Level. Any command line arguments passed into this program are treated as a list of custom level filenames that should be played in a particular order.

Parameters:

args - is the sequence of custom level files to play through.