jeheydorn / nortantis

Nortantis is a fantasy map generator. It uses a simple tectonic plate simulation to create islands and continents with trees, rivers, and mountains. The result has the appearance of an old-fashioned hand-drawn map.
GNU Affero General Public License v3.0
72 stars 20 forks source link

compile for archlinux - installation instructions? #22

Open cburgard opened 1 month ago

cburgard commented 1 month ago

Dear developers!

I've recently stumbled over this project, and it looks quite exciting. Thanks for putting in all the hard work over so many years!

Unfortunately, I had no luck getting it to run yet, since I'm not familiar with java and there seems to be no package for achlinux. Would it be possible for you to add some installation instructions for people who want to build this project from source for a non-supported OS?

jeheydorn commented 1 month ago

A google search shows that it might be possible to install a deb file in archlinux, although there's quite a few steps. For example: https://www.baeldung.com/linux/arch-install-deb-package

I'm not familiar with archlinux, but you should be able to build and run from source, although that won't install Nortantis for you. To build and run from source:

1) (not sure if this step is necessary since Eclipse for Java Developers comes with Java) Install Java. I imagine java is available through whatever package manager archlinux uses. In Ubuntu, it's something like sudo apt install openjdk-21-jdk. You need at least java version 10. 2) Download and install Eclipse for Java developers. 3) Create a folder for your workspace, wherever you want your source code. 4) Use git to clone https://github.com/jeheydorn/nortantis.git into the workspace folder. 5) Open Eclipse to your workspace folder. 6) File -> New -> Java Project. Name it nortantis (not capitalized). Eclipse should find the existing source that you cloned. 7) In Eclipse's Package Explorer window, find MainWindow.java (it's in package nortantis.swing). Right click it -> Run As -> Java Application.

That should run the app. To re-run it, you can simply press the Run button in the button bar along the top of Eclipse.

Let me know if that works.

cburgard commented 1 month ago

Thanks a lot for your instructions. With your help and some AI-powered code generation, I added build files for gradle. Please review the above PR. Once this is merged, I'm happy to also add a packaging script for archlinux that is based on this.