JPentago

JPentago is a java implementation of the original Pentago game.

It uses the Java Monkey Engine to provide a 3D visualization of the game.

2D versions may be implemented in the future, as well as online networked play.

The official JPentago Google Project Site is: http://code.google.com/p/jpentago/

Most design documents/articles will be written on this wiki, but for feature/bugs/task tracking we'll be using the google code site.

Here's a prototype screenshot showing the 3D GUI.

To get started playing the JPentago game, you'll need to be somewhat developer savvy, because you'll be downloading the JPentago code from the JPentago Google Code Project site.

<box 100% left blue round |NOTE: > You can follow the steps below, or use the well documented steps provided by google on the JPentago Source Code page: http://code.google.com/p/jpentago/source </box>

The steps to get started are:

1. Download the source code from the JPentago Subversion code repository site using subversion.
2. Import the downloaded code into Eclipse IDE (File » Import » Existing Project into Workspace)

You can combine these steps by setting up your Eclipse to use the Subclipse Subversion Eclipse plugin. Then you just have to create a new SVN project in eclipse.

1. In Eclipse select File » New Project » SVN » Checkout Projects from SVN » NEXT
2. In the Check out from SVN screen select Create new repository button and hit NEXT
3. For the SVN URL put http://jpentago.googlecode.com/svn/trunk/ and hit NEXT
4. In the Select a Folder screen expand the http://jpentago.googlecode.com/svn/trunk/ folder and select the folder jpentago and click Finish

You should now be setup with the JPentago project in your workspace and you can now keep in synch and commit changes back to the project.

You must be a member of the JPentago google project to comitt changes to the SVN repository.

If you are a member than you use your Google user name and your generated SVN password to submit changes to the JPentago SVN repository.

You use HTTPS SVN access instead of the anonymous HTTP SVN access: https://jpentago.googlecode.com/svn/trunk/

To run the 3D viewer for JPentago from eclipse:

1. Select Run » Run…
2. In the run configurations expand the tree item that says Java Applications
3. Select GameBoardView then select Run

To build JPentago from the command line you must first install Apache ANT and make sure the ant command is on your PATH. Also it's required that you have JDK 5 or greater installed.

1. On the command line cd <Jpentago_location> (IE: cd C:\eclipse\workspace\jpentago)
2. run ant
3. cd dist\bin
4. run jpentago.bat

NOTE: error logs will be output to the same folder you ran the jpentago.bat (IE: C:\eclipse\workspace\jpentago\dist\bin):

• jpentago_log.txt - contains JPentago standard output/error and any other JPentago logging and debugging information.
• debug.txt - contains Java Monkey Engine scene graph logging and debugging information.

• Browse the code