Table of Contents

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

A quick reference for Devuan Beowulf 3.1.1

sudo apt install openjdk-11-jre

Instructions creation date: 2024-May-2

Last tested date: 2024-May-2

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

Devuan Daedalus 5.0

A quick reference for Devuan (Daedalus 5.0):

sudo apt install openjdk-17-jre

Instructions creation date: 2024-April-04

Last tested date: 2024-May-03

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

Last tested date: 2024-May-04

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

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

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

Last tested date: 2024-May-05

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

Last tested date: 2024-May-06

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

Last tested date: 2024-May-08

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

Last tested date: 2024-May-08

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

Last tested date: 2024-May-08

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

Last tested date: 2024-May-08

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

Last tested date: 2024-May-08

Linux Mint 21.3 (Virginia)

A quick reference for Linux Mint 21.3 (Virginia) using command line interface:

sudo apt install openjdk-11-jre

Instructions creation date: 2024-May-12

Last tested date: 2024-May-12

Linux Mint 22 (Wilma)

A quick reference for Linux Mint 22 (Wilma) using command line interface:

sudo apt install openjdk-17-jre

Instructions creation date: 2024-July-26

Last tested date: 2024-July-26

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

Last tested date: 2024-May-08

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

Last tested date: 2024-May-08

Manjaro 24 (Wynsdey)

A quick reference for Manjaro 24 (Wynsdey) using command line interface:

sudo pacman -S jre-openjdk

Instructions creation date: 2024-May-15

Last tested date: 2024-May-15

OpenSUSE

OpenSUSE Leap 15.5

A quick reference for OpenSUSE Leap 15.5

sudo zypper install java-11-openjdk

Instructions creation date: 2024-April-04

Last tested date: 2024-May-09

OpenSUSE Tumbleweed

A quick reference for OpenSUSE Tumbleweed

sudo zypper install java-11-openjdk

Instructions creation date: 2024-April-04

Last tested date: 2024-May-10

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

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

Last tested date: 2024-May-11

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:

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

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

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“

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

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

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'

  1. Open the Finder and navigate to a .class and/or .jar file
  2. Right click on the file and select 'Get Info'
  3. Expand the 'Open With:' option
  4. Change 'Jar Launcher (default)' to your preferred version of java
  5. 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