Setup
First you need a JDK to build your java sources (a JRE is only good to execute code, not to compile). You can choose either:
- Oracle JDK (it's the official one)
- OpenJDK (open source alternative)
Make sure you choose at least version 8.
Unzip the zip to some location or install the setup executable.
Now you need Eclipse, and IDE for Java (others IDE are ok too, but not covered in this guide because i like Eclipse better).
Go here and download Eclipse for Java developers (not "Eclipse IDE for Enterprise Java Developers", nor "Eclipse IDE for Java and DSL Developers", althou they just have extra stuff you don't care so are ok too)
Once installed (unzipped somewhere), run it and choose a workspace (any work folder you like). When it's ready, go to Windows -> Preferences and then go to Java and Installed JREs. You'll probably see something there already. If it's your JDK you're good to go, otherwise you need to import it.
If you need to import it, click on Add and choose the folder where you installed the JDK at the first step. You should end up with something like this (remember to flag the jdk as Default):
Now on eclipse go to File -> Import then choose Existing Maven Project:
Now on the Root Directory, choose the directory where you stored Omicron, a list of project should be appear, among which are "omicron-api", "omicron-engine" etc.
Click Finish and the project will be imported, and the building process should immediately start, downloading all dependencies etc. When everything settles down, you should have something like this:
If there are no red error signs, everything should be ok and you can start any of the demos included, just head to the launcher file and start it either in debug or run, like so:
Enjoy Omicron!