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.
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.
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).
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.
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 https://github.com/YOURGITHUBNAME/wwa.git
If you just want the latest version without making a fork run:
git clone https://github.com/warofants/wwa.git
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 CONTRIBUTING.md for details on the process for submitting pull requests to us.
- Anthony Luttrell - The creator of this project - Anthony Luttrell
See also the list of contributors who participated in this project.