Code Monkey home page Code Monkey logo

wwa's Introduction

GitHub contributors Discord Build Status codecov

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

wwa's People

Contributors

plat251 avatar anthonyluttrell avatar nishantacharya avatar johnnyirvin avatar jannik143 avatar ehwhoami avatar doubleapple123 avatar orhanar avatar suppergerrie2 avatar alextopher avatar jacksole avatar dorogi avatar blackk100 avatar jeffhasbugs avatar smithtj avatar veradux avatar alexdqmf avatar mgxzy avatar

Stargazers

Jim Watkyns avatar Maciej avatar

Watchers

Maciej avatar Matthew Broadbent avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.