Setting up Netbeans

If you don't have it already, run and grab the Netbeans IDE (I recommend the “Java” or “All” package).

Since Netbeans brings a subversion client with each package, you don’t need to install any plugins and can immediately continue with…

Accessing Google Code

The sources for Betaville are hosted on Google Code. The page there isn't actively maintained, but is used mostly for the provided Subversion hosting.

Since I’m using a german Netbeans client, I can only guess the correct names of menus, menu items and field names of the English version!

To access the sources from within Netbeans:

  • Team menu → Subversion → Download Version
  • Under Repository-URL, put “http://betaville.googlecode.com/svn” (committers may enter their credentials) and click Next.
  • Click on “Browse…” next to the “Repository Folder(s)” field and select the “trunk” folder in “BetavilleApp”.
  • Check the local path and click “Finish”.

Congratulations! Netbeans now downloads all the sources from the repository. Once this process is completed you now have all of the code necessary to build and run Betaville on your computer. Now to run it…

Running the Application

Ok, now lets make Betaville go! Compared to the Eclipse environment it’s a little bit more complicated.

  1. Once Netbeans has finished downloading all the sourcecode it asks you whether you want to create a new Netbeans project or not. Yes, off course!
  2. You will see the “New project” wizard next. Please select “Category” → “Java” and “Project” → “Java Project with existing sources”.
  3. On the next page, give the project a name, e.g. BetavilleApp and point the project root to the downloaded “BetavilleApp” folder. Ignore the rest of the dialog for now and click “Next >”.
  4. Add the existing folders on the next screen:
    1. “src” folder to “Source-Package folders”
    2. “test” folder to “Test-Package folders”
  5. Click on “next” and on the next screen click on “finish”.
  6. Right click the new BetavilleApp Project → Properties
  7. Go to “Run” configuration an fill the following fields:
    1. Main Class: edu.poly.bxmc.betaville.jme.BetavilleNoCanvas
    2. VM Arguments: ”-Xmx768M -Djava.library.path=lib/jme/lib/jogl/native/macosx/:lib/jme/lib/lwjgl/native/” (without marks)
  8. No big deal so far, isn’t it? Fine! It becomes frustrating NOW! ;-)
  9. Go to “Library” on the left of the properties dialog
  10. Add each .jar file from the /lib folder or any of its subfolders MANUALLY into the library list. In the end I got 36 .jar references there! Please double-check!
  11. Hit “OK” on the dialog and wait for Netbeans refreshing the project and its dependencies. Scroll through the package list, searching for error- or warning-signs. If there aren’t any, you're done! Congratulations!
  12. Right click BetavilleApp, selecting “Run”. Betaville should open now and run against the latest code checked out from the repository. In order to keep your local copy up to date, be sure to run an SVN update from within Netbeans by right clicking the BetavilleApp's sources folder and selecting Subversion → Update