Skip to content
World War of Ants
Java
Branch: master
Clone or download
anthonyLuttrell Merge pull request #58 from lemikistu/master
Code restructure, details in comment.
Latest commit be05812 Aug 15, 2019

README.md

GitHub contributors Discord Build Status

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.

Motivation

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

Prerequisites

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.

Git

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 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

Building

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

Contributing

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

Resources

Authors

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

License

GNU General Public License

You can’t perform that action at this time.