Skip to content
World War of Ants
Branch: master
Clone or download
Pull request Compare This branch is 9 commits behind warofants:master.
Latest commit 1d5943f Aug 14, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs/design Better overview Aug 13, 2019
src/main/java/com/worldwarofants/game fix: this commit fixes the mainclass pom tag and fixes npes in main Aug 14, 2019
.travis.yml stop travis from checking in JDK11 Aug 14, 2019 Update Aug 12, 2019 Remove CONTIBUTING template and describe actual PR flow Aug 14, 2019
LICENSE Initial commit Aug 11, 2019 Remove CONTIBUTING template and describe actual PR flow Aug 14, 2019
codecov.yml adding codecov file Aug 14, 2019
pom.xml fix: this commit fixes the mainclass pom tag and fixes npes in main Aug 14, 2019

World War of Ants

World War of Ants is a game about managing lives of ants, making sure their colony is fed, maintained, defended and prosperous. It is built with Java, and uses a command line interface for player input.


An open source project created mostly by motivated beginners and experienced professionals alike. This project aims at creating a community of developers and creatives in order to release a video game to the public.

How to play

To play the game you'll need to download the jar file from the releases tab or build the jar file yourself as explained under building.

Getting Started


Java Development Kit

First, you'll need to install the Java Development Kit (JDK). Considering compatibility and other issues, it was decided that OpenJDK 8 would be used to develop this project.

We recommend getting OpenJDK from AdoptOpenJDK, select OpenJDK 8 and choose HotSpot as the JVM.

If you do not want to use that you can also use Redhat's openJDK.

Since OpenJDK 11 is (mostly) backwards compatible with java 8 you can also use that, which is the jdk shipped with Intellij IDEA (This means that if you plan on using Intellij IDEA you can skip this step).

Integrated Development Environment

You'll also need to install an Integrated Development Environment (IDE) to make your own life easier. There are several good options to choose from, so feel free to pick one. A few options below:

  • Visual Studio Code (code-oss)
  • Eclipse
  • NetBeans
  • IntelliJ Community IDEA

We recommend using IntelliJ, as it is easy to install and contains tutorials for its interface. It also gives you the option to download plugins, some of which may be useful to you. Its most recent version include OpenJDK 11, making step one optional.


You'll also need to install git on your computer. You can find it for your particular Operating System by following this link

Anyone is welcome to contribute. Feel free to fork this repository, and make a Pull Request when you've got something working. Contact anthonyLuttrell if you'd like to request additional permissions.

Getting the code

To get World War of Ants locally you need to clone the repository, it is recommended to make a fork first so you can mess around in the code without affecting the original.

You do this by clicking fork in the top right, then open a command prompt, powershell or terminal where you want the code and running:

git clone

If you just want the latest version without making a fork run:

git clone


To build the game into a runnable jar you need to run

mvn package

This jar file can then be run using the command

java -jar FILENAME.jar


Please read for details on the process for submitting pull requests to us.



See also the list of contributors who participated in this project.


GNU General Public License

You can’t perform that action at this time.