A real-time strategy game where you design airships and then fight with them. The aim is to have pretty chaotic explodey fights and interesting ship design choices.

Report article RSS Feed Modding Setup

Want to make mods for Airships? Here's how to set everything up properly.

Posted by Zarkonnen on Aug 5th, 2014
Article

These are detailed instructions on how to set up the Airships code and libraries with NetBeans. At the end of these instructions, you will have a copy of the game running from the source code, ready to be modded.
You will need:

Gather the Files

First, create a new folder called "Airships" or similar for the project. This is where NetBeans will store its stuff. Put the "src" folder from the source download into it. Then, copy the "lib", "data", "default_ships" and "default_buildings" folders from the game install into it. The result should look like this:


Project Setup

Now, start up NetBeans. Choose "New Project" from the File menu. Choose "Java project with Existing Sources" and hit Next.

In the next screen, select the folder you set up earlier as the project folder. Tick "Use Dedicated Folder for Storing Libraries" and set "Libraries Folder" to "./lib" - which means it's going to use the lib folder in the project folder, where the libraries from the install are. Click next.

Now, add the "src" folder as a source package folder. Next.

The next screen should look something like this, listing various .java files:

Click "Finish".The Airships project should now appear in the panel on the left.


Libraries

It will have an error icon, but that's just because you still need to explicitly add the libraries. Let's do that now. Right-click on the "Libraries" folder below the project and choose "Add Jar/Folder". In the file chooser that comes up, navigate to the lib folder and choose all files that end in .jar.

Hit OK, and NetBeans will chug for a moment, and then the errors should disappear. You can open the "Source Packages" folder and see the various Java classes that comprise the game.


Running the Game

The final thing that needs doing is setting up the game to run. To do that, right-click on the project icon (the little red coffee cup) and choose "Properties". There, select the "Run" panel.Browse for the Main Class and select "com.zarkonnen.airships.Main". For "Working Directory", put ".". (A single period.) For "VM Options", put "-Djava.library.path=lib/native -Xmx1024m". (These options mean "use the native OpenGL library bindings that are in lib/native" and "use up to 1 GB of RAM if needed.)

Hit OK and then press the big green triangle button to run the project. With any luck, the game should now start up.


That's it! You now have a working copy of Airships which you can mod to your heart's content. The basics of doing that, and how to distribute the mod, will be covered in another installment. For now, have a poke around, and join us on the forums if you have questions, comments, or ideas to share.


Post comment Comments
D.E.G
D.E.G Aug 6 2014, 6:46am says:

OS you are developing it on?

+2 votes     reply to comment
Zarkonnen
Zarkonnen Aug 6 2014, 9:25am replied:

I've been developing it on Mac OS X, but just switched to a machine with Linux Mint, which is that these screenshots are taken on. This setup works for Mac, Linux and Windows. :)

+1 vote     reply to comment
Post a Comment
click to sign in

You are not logged in, your comment will be anonymous unless you join the community today (totally free - or sign in with your social account on the right) which we encourage all contributors to do.

2000 characters limit; HTML formatting and smileys are not supported - text only

Icon
Airships
Platforms
Windows, Mac, Linux
Developed By
Zarkonnen
Engine
Custom Built
Contact
Send Message
Official Page
Zarkonnen.com
Release Date
Released Mar 24, 2014
Game Watch
Track this game
Feature
Browse
Features
Report Abuse
Report article
Related Games
Airships
Airships Indie Single & Multiplayer Real Time Strategy
Related Engines
Custom Built
Custom Built Commercial Released Sep 1, 2007