====== Gridarta ======
===== Introduction =====
Gridarta is a project that merges CFJavaEditor from Crossfire with its derivate DaimoninEditor from Daimonin, started in May 2006 by Cher, Ragnor, and Zergus.
This page is a HOWTO for downloading and launching Gridarta for Crossfire Map Editor for use with the Crossfire.
==== Java or OpenJDK Installation ====
While either Sun Java or OpenJDK will work, the initial instructions are a guide for using OpenJDK Java Runtime Environment (or JRE).
===== Linux Distribution Specific Dependencies =====
==== Check Java Installation and Version ====
Check if you have Java installed and what version with the following command:
java -version
Some possible output:
$ java -version
openjdk version "1.8.0_402"
OpenJDK Runtime Environment (build 1.8.0_402-8u402-ga-2ubuntu1~20.04-b06)
OpenJDK 64-Bit Server VM (build 25.402-b06, mixed mode)
$ java -version
openjdk version "11.0.22" 2024-01-16
OpenJDK Runtime Environment (build 11.0.22+7-post-Debian-1deb11u1)
OpenJDK 64-Bit Server VM (build 11.0.22+7-post-Debian-1deb11u1, mixed mode, sharing)
$ java -version
openjdk version "11.0.22" 2024-01-16
OpenJDK Runtime Environment (build 11.0.22+7-post-Ubuntu-0ubuntu222.04.1)
OpenJDK 64-Bit Server VM (build 11.0.22+7-post-Ubuntu-0ubuntu222.04.1, mixed mode, sharing)
$ java -version
openjdk version "11.0.22" 2024-01-16
OpenJDK Runtime Environment (build 11.0.22+7-post-Debian-1deb11u1)
OpenJDK 64-Bit Server VM (build 11.0.22+7-post-Debian-1deb11u1, mixed mode, sharing)
$ java -version
openjdk version "17.0.10" 2024-01-16
OpenJDK Runtime Environment (build 17.0.10+7-Debian-1deb12u1)
OpenJDK 64-Bit Server VM (build 17.0.10+7-Debian-1deb12u1, mixed mode, sharing)
$ java -version
openjdk version "17.0.9" 2023-10-17
OpenJDK Runtime Environment (Red_Hat-17.0.9.0.9-4) (build 17.0.9+9)
OpenJDK 64-Bit Server VM (Red_Hat-17.0.9.0.9-4) (build 17.0.9+9, mixed mode, sharing)
> java -version
openjdk version "11.0.22" 2024-01-16
OpenJDK Runtime Environment (build 11.0.22+7-suse-150000.3.110.1-x8664)
OpenJDK 64-Bit Server VM (build 11.0.22+7-suse-150000.3.110.1-x8664, mixed mode)
$ java -version
openjdk version "17.0.10" 2024-01-16
OpenJDK Runtime Environment (build 17.0.10+7-Ubuntu-123.10.1)
OpenJDK 64-Bit Server VM (build 17.0.10+7-Ubuntu-123.10.1, mixed mode, sharing)
And if Java is not installed:
$ java -version
-bash: java: command not found
If you have Java installed you can proceed to the Download instructions. If Java is not installed, follow the next steps for installing OpenJDK.
==== Distribution Specific Install Instructions ====
==== Arch Linux ====
A quick reference for Arch Linux using the command line interface:
sudo pacman -S jre8-openjdk
Instructions creation date: 2024-April-4
Last tested date: 2024-April-4
==== Debian ====
For all Debian versions, it is also possible to install Java using `default-jre` package (This dependency package points to the Java runtime, or Java compatible runtime recommended for this architecture)
==== Debian 10 (Buster) ====
A quick reference for Debian 10 (Buster):
sudo apt install openjdk-11-jre
Instructions creation date: 2024-April-4
Last tested date: 2024-April-4
==== Debian 11 (Bullseye) ====
A quick reference for Debian 11 (Bullseye):
sudo apt install openjdk-11-jre
Instructions creation date: 2024-April-4
Last tested date: 2024-April-4
==== Debian 12 (Bookworm) ====
A quick reference for Debian 12 (Bookworm):
sudo apt install openjdk-17-jre
Instructions creation date: 2024-April-4
Last tested date: 2024-April-4
==== Devuan ====
For all Devuan versions, it is also possible to install Java using `default-jre` package (This dependency package points to the Java runtime, or Java compatible runtime recommended for this architecture)
==== Devuan Chimaera 4.0 ====
A quick reference for Devuan (Chimaera 4.0):
sudo apt install openjdk-11-jre
Instructions creation date: 2024-April-4
Last tested date: 2024-April-4
==== Devuan Daedalus 5.0 ====
A quick reference for Devuan (Daedalus 5.0):
sudo apt install openjdk-8-jre
Instructions creation date: 2024-April-4
Last tested date: 2024-April-4
==== Fedora ====
For all Fedora versions, it is also possible to install Java using `java-latest-openjdk` package (This dependency package points to the Java runtime, or Java compatible runtime recommended for this architecture)
==== Fedora 37 ====
A quick reference for Fedora 37 using the command line interface:
sudo dnf install java-17-openjdk
Instructions creation date: 2024-April-4
Last tested date: 2024-April-5
==== Fedora 38 ====
A quick reference for Fedora 38 using the command line interface:
sudo dnf install java-17-openjdk
Instructions creation date: 2024-April-4
Last tested date: 2024-April-5
==== Fedora 39 ====
A quick reference for Fedora 39 using the command line interface:
sudo dnf install openjdk-17-jre
Instructions creation date: 2024-April-4
Last tested date: 2024-April-26
==== Fedora 40 ====
A quick reference for Fedora 40 using the command line interface:
sudo dnf install openjdk-17-jre
Instructions creation date: 2024-April-26
Last tested date: 2024-April-26
==== Linux Mint ====
For all Linux Mint versions, it is also possible to install Java using `default-jre` package (This dependency package points to the Java runtime, or Java compatible runtime recommended for this architecture)
==== Linux Mint 20 (Ulyana) ====
A quick reference for Linux Mint 20 (Ulyana) using command line interface:
sudo apt install openjdk-11-jre
Instructions creation date: 2024-April-4
Last tested date: 2024-April-5
==== Linux Mint 20.1 (Ulyssa) ====
A quick reference for Linux Mint 20.1 (Ulyssa) using command line interface:
sudo apt install openjdk-11-jre
Instructions creation date: 2024-April-4
Last tested date: 2024-April-6
==== Linux Mint 20.2 (Uma) ====
A quick reference for Linux Mint 20.2 (Uma) using command line interface:
sudo apt install openjdk-11-jre
Instructions creation date: 2024-April-4
Last tested date: 2024-April-6
==== Linux Mint 20.3 (Una) ====
A quick reference for Linux Mint 20.3 (Una) using command line interface:
sudo apt install openjdk-11-jre
Instructions creation date: 2024-April-4
Last tested date: 2024-April-6
==== Linux Mint 21 (Vanessa) ====
A quick reference for Linux Mint 21 (Vanessa) using command line interface:
sudo apt install openjdk-11-jre
Instructions creation date: 2024-April-6
Last tested date: 2024-April-4
==== Linux Mint 21.1 (Vera) ====
A quick reference for Linux Mint 21.1 (Vera) using command line interface:
sudo apt install openjdk-11-jre
Instructions creation date: 2024-April-6
Last tested date: 2024-April-4
==== Linux Mint 21.2 (Victoria) ====
A quick reference for Linux Mint 21.2 (Victoria) using command line interface:
sudo apt install openjdk-11-jre
Instructions creation date: 2024-April-4
Last tested date: 2024-April-6
==== Linux Mint Debian Debian Edition 6 ====
A quick reference for Linux Mint Debian Debian Edition 6:
sudo apt install openjdk-17-jre
Instructions creation date: 2024-April-4
Last tested date: 2024-April-6
==== Manjaro ====
==== Manjaro 23.1.3 (Vulcan) ====
A quick reference for Manjaro using command line interface:
sudo pacman -S jre11-openjdk
Instructions creation date: 2024-April-4
Last tested date: 2024-April-7
==== OpenSUSE ====
==== OpenSUSE Leap 15.5 ====
A quick reference for OpenSUSE Leap 15.5
sudo zypper install java-11-openjdk
Instructions creation date: 2024-April-4
Last tested date: 2024-April-7
==== OpenSUSE Tumbleweed ====
A quick reference for OpenSUSE Tumbleweed
sudo zypper install java-11-openjdk
Instructions creation date: 2024-April-4
Last tested date: 2024-April-7
==== Pop!_OS ====
==== Pop!_OS 22.04 LTS (NVIDIA) ====
A quick reference for Pop!_OS 22.04 LTS (NVIDIA)
sudo apt install default-jre
Instructions creation date: 2024-April-4
Last tested date: 2024-April-7
==== Pop!_OS 22.04 LTS ====
A quick reference for Pop!_OS 22.04 LTS:
sudo apt install default-jre
Instructions creation date: 2024-April-4
Last tested date: 2024-April-7
==== Ubuntu ====
For all Ubuntu versions, it is also possible to install Java using `default-jre` package (This dependency package points to the Java runtime, or Java compatible runtime recommended for this architecture)
The dependency and instructions for the listed versions of Ubuntu includes or applies to all eight of the different flavors including:
* Kubuntu
* Lubuntu
* Ubuntu Budgie
* Ubuntu Kylin
* Ubuntu Mate
* Ubuntu Studio
* Ubuntu Unity
* Xubuntu
==== Ubuntu 20.04 (Focal Fossa) ====
A quick reference for Ubuntu 20.04 (Focal Fossa):
sudo apt install openjdk-8-jre
Instructions creation date: 2024-April-4
Last tested date: 2024-April-8
==== Ubuntu 22.04 (Jammy Jellyfish) ====
A quick reference for Ubuntu 22.04 (Jammy Jellyfish):
sudo apt install openjdk-11-jre
Instructions creation date: 2024-April-8
Last tested date: 2024-April-4
==== Ubuntu 23.10 (Mantic Minotaur) ====
A quick reference for Ubuntu 23.10 (Mantic Minotaur) using the command line interface:
sudo apt install openjdk-17-jre
Instructions creation date: 2024-April-4
Last tested date: 2024-April-8
==== Ubuntu 24.04 (Noble Numbat) ====
A quick reference for Ubuntu 24.04 (Noble Numbat)
sudo apt install openjdk-17-jre
Instructions creation date: 2024-April-24
Last tested date: 2024-April-26
===== Getting Gridarta =====
Snapshot release are made available depending on code updates and changes for Gridarta and Crossfire Archetypes, and can be found at"
[[https://sourceforge.net/projects/crossfire/files/gridarta-crossfire/|SourceForge Gridarta Snapshot Download]]
===== Installing Gridarta on Windows =====
FIXME - the install on Windows will likely get it's own page once this page is more organized and updated
* Access the latest .jar from [[https://sourceforge.net/projects/crossfire/files/gridarta-crossfire/]]
* To run the .jar you will need the Java Runtime Environment (JRE) available:[[http://www.oracle.com/technetwork/java/javase/downloads/java-se-jre-7-download-432155.html|here]]
* Download the [[http://sourceforge.net/projects/crossfire/files/crossfire-server-windows/snaspshot/crossfire-server-bigworld-trunk-18572.exe/download|Maps]] to the localhost
* Begin Editing.
* Submit your early work to the email list before committing to the SVN for best results.
==== Running Gridarta ====
Gridarta can be run or launched through the following methods:
=== CLI (Command Line Interface) ===
For Gridarata4Crossfire run:
java -jar CrossfireEditor.jar
or for Gridarta4Daimonin run:
java -jar DaimoninEditor.jar
Also, it is possible java may not allocated enough memory defaultly, in which case use "//-Xmx128M//" or similar in the parameters to Java.
For larger machines, explicitely requesting a client type VM can significantly speedup gridarta, so consider using "//-client//".
=== GUI (Graphical User Interface) ===
Double click on the .jar file - this is the case for Windows based systems and also applies for MacOS X.
==== JRE Update ====
=== *nix Based ===
If you recently upgraded your Java JRE or having problems launching the editor, or would like to specify a particular version of Java, run this command:
$ update-alternatives --config java
Follow the instructions that appear:
NOTE: actual output, contents and options will vary, you'll want to use: /usr/lib/j2re1.5-sun/bin/java
There are 6 alternatives which provide `java'.
Selection Alternative
-----------------------------------------------
1 /usr/lib/j2re1.4-sun/bin/java
* 2 /usr/lib/jvm/java-1.5.0-sun/jre/bin/java
3 /usr/bin/gij-wrapper-4.0
+ 4 /usr/lib/jvm/java-gcj/jre/bin/java
5 /usr/bin/gij-wrapper-4.1
6 /usr/lib/j2re1.5-sun/bin/java
Press enter to keep the default[*], or type selection number: 6
Using `/usr/lib/j2re1.5-sun/bin/java' to provide `java'.
Then try launching the editor again.
=== MacOS X Based ===
* If you want to switch between '''released''' version of java, just run the 'Java Preference.app', spotlight Java and you'll get a hit.
* If you want to run a Developer Preview (DP) release you'll need to do some tweaking. See below.
* You can get [[http://lists.apple.com/archives/java-dev/2005/Aug/msg00506.html|Fancy]] with some bash scripting
== Developer Preview of Java ==
Apple does not want the normal user to run a DP version of java, so the pretty GUI and neat way of switching releases is disabled. Apple's official mechanism is to use full path to the release of java you want to run.
* Command line example to run 1.6
$ /System/Library/Frameworks/JavaVM.framework/Versions/1.6/Commands/java -version
This should display something like the following:
java version "1.6.0_01-dp"
Java(TM) SE Runtime Environment (build 1.6.0_01-dp-b06-101)
Java HotSpot(TM) 64-Bit Server VM (build 1.6.0_01-41-release, mixed mode)
* Make 1.6 your "default" for the command line
$ vi ~/.bash_profile
PATH="/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Commands:${PATH}"
Then run:
$source ~/.bash_profile
$java -version
You are now able to use java 1.6 at terminal.
FIXME-- * Make 1.6 your "default" for the GUI '''UNTESTED'''
- Open the Finder and navigate to a .class and/or .jar file
- Right click on the file and select 'Get Info'
- Expand the 'Open With:' option
- Change 'Jar Launcher (default)' to your preferred version of java
- Be bold and click 'Change All...'
=== Blank Editor Screen ===
Enter the following command in the same terminal or shell window and then try running the client:
$ export AWT_TOOLKIT=MToolkit
===== Links =====
* http://gridarta.sourceforge.net/ Gridarta Website