Setting up Cell2D in NetBeans IDE
- Download Cell2D.
- Extract the Cell2D ZIP file. Inside is a folder called Cell2D-<version>, where <version> is Cell2D's version number.
- Open NetBeans IDE.
Creating a library for Cell2D
- Go to Tools > Libraries.
- Select New Library. Name the new library "Cell2D."
- 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, and jorbis-0.0.17-1.jar. Then, add Cell2D-<version>/natives/jinput.jar, and finally add Cell2D-<version>/Cell2D.jar.
- In Cell2D's Sources tab, select Add JAR/Folder and add the folder Cell2D-<version>/src/.
- In Cell2D's Javadoc tab, select Add ZIP/Folder and add the folder Cell2D-<version>/javadoc/.
Configuring a project to use Cell2D
- In the Projects tab, right-click or control-click on the project that you want to use Cell2D with. Select Properties.
- In the list on the left of the Project Properties window, select Libraries.
- In the Compile tab, select Add Library. Select Cell2D from the list of libraries.
Running a Cell2D project
- 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.
- Now you need to copy the native libraries into your new folder.
- 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.
- If you want your game to run on Windows (32-bit), copy the files in Cell2D-<version>/natives/windows32/.
- If you want your game to run on Windows (64-bit), copy the files in Cell2D-<version>/natives/windows64/.
- If you want your game to run on Mac OS X, copy the files in Cell2D-<version>/natives/macosx/.
- If you want your game to run on Linux (32-bit), copy the files in Cell2D-<version>/natives/linux32/.
- If you want your game to run on Linux (64-bit), copy the files in Cell2D-<version>/natives/linux64/.
- 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.
- When distributing your game, make sure to include the native library folder.