Setting up Cell2D in NetBeans IDE

  1. Download Cell2D.

  2. Extract the Cell2D ZIP file. Inside is a folder called Cell2D-<version>, where <version> is Cell2D's version number.

  3. Open NetBeans IDE.

Creating a library for Cell2D

  1. Go to Tools > Libraries.

  2. Select New Library. Name the new library "Cell2D."

  3. In Cell2D's Classpath tab, select Add JAR/Folder. Navigate to the folder Cell2D-<version>/lib/ and add all of the JARs in there: lwjgl.jar, lwjgl_util.jar, jorbis-0.0.17-1.jar, and TiledReader.jar. Then, add Cell2D-<version>/natives/jinput.jar, and finally add Cell2D-<version>/Cell2D.jar.

  4. In Cell2D's Sources tab, select Add JAR/Folder and add the folder Cell2D-<version>/src/.

  5. In Cell2D's Javadoc tab, select Add ZIP/Folder and add the folder Cell2D-<version>/javadoc/.

Configuring a project to use Cell2D

  1. In the Projects tab, right-click or control-click on the project that you want to use Cell2D with. Select Properties.

  2. In the list on the left of the Project Properties window, select Libraries.

  3. In the Compile tab, select Add Library. Select Cell2D from the list of libraries.

Running a Cell2D project

  1. Make a new folder, preferably in the folder of your NetBeans project. This folder will contain the native libraries that Cell2D, and thus your game, needs in order to run.

  2. Now you need to copy the native libraries into your new folder.

    1. No matter what, copy Cell2D-<version>/natives/jinput.jar. Despite being a JAR file, jinput.jar only works if it's included in the native library path, at least from my experience.

    2. If you want your game to run on Windows (32-bit), copy the files in Cell2D-<version>/natives/windows32/.

    3. If you want your game to run on Windows (64-bit), copy the files in Cell2D-<version>/natives/windows64/.

    4. If you want your game to run on Mac OS X, copy the files in Cell2D-<version>/natives/macosx/.

    5. If you want your game to run on Linux (32-bit), copy the files in Cell2D-<version>/natives/linux32/.

    6. If you want your game to run on Linux (64-bit), copy the files in Cell2D-<version>/natives/linux64/.

  3. In your project's main() method, before you call CellGame.startGame(), call CellGame.loadNatives("<path>"), where <path> is the path from your project's folder to the native library folder.

  4. When distributing your game, make sure to include the native library folder.