Skip to content

Home

Jump to bottom
Erika Redmark edited this page Jul 21, 2014 · 27 revisions

The readme in the 'master' branch gives an overview of this project. The wiki is intended as a help documentation for getting started just playing the game (without the whole checkout and setup project in Eclipse part), as well as eventually game play mechanics and level editor usage.

As the game is a work in progress, so is this wiki.

Running the Game

Preconditions

You must have Java 7 or higher installed.

Getting Started: The immediate way

A .jar is provided (monkey_shines-0.1-SNAPSHOT-jar-with-dependencies.jar) in the root folder of the project. This is only up to date in the master branch. This allows one to quickly run the game and level editor without downloading the code and compiling it or setting it up in Eclipse.

  1. Download the monkey_shines-0.1-SNAPSHOT-jar-with-dependencies.jar file

1a. If you want to just play the game (no level editor) you can just double click the .jar file and open it up. Otherwise, continue to step 2.

  1. Open a terminal/command window and navigate to the directory that you downloaded the .jar file to.

  2. For the game, run `java -cp monkey_shines-0.1-SNAPSHOT-jar-with-dependencies.jar org.erikaredmark.monkeyshines.MonkeyShines'. As stated by 1a, you can also just double click to do this.

  3. For the level editor, run java -cp monkey_shines-0.1-SNAPSHOT-jar-with-dependencies.jar org.erikaredmark.monkeyshines.editor.LevelEditor

Optional: You may want to also download the 'extra/debug_worlds' contents on the master branch, as well as 'src/resources/worlds/Spooked' for the first level of the original game. The debug world is an ongoing world that just contains some 'stuff' that is designed to test game mechanics, but the 'Spooked' level is a good entry point to playing the game, as it was also the original demo level.

Getting Started: The fairly quick way

You can compile the .jar yourself. You will need to download and set up Maven to do so

  1. Checkout the master branch
  2. Navigate to the folder containing the pom.xml (this should be in the "Monkey Shines" folder)
  3. run mvn install.
  4. Check for a generated folder called target in that directory. In it should contain two jar files. Choose the one that says 'with-dependencies'
  5. Perform steps 2 - 4 from 'Getting Started: The immediate way' to run the program.

Playing the Game

[See the relevant wiki page for more information on actual gameplay](Playing the Game)

Clone this wiki locally