Crossfire Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== 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. 


===== Getting Gridarta =====
Gridarta can be retrieved from svn with:
    svn co https://gridarta.svn.sourceforge.net/svnroot/gridarta

Also, there are following 'unoffical' gridarta builds:
    * [[http://www.eracc.com/other/crossfire/|Ragnor's Gridarta4Crossfire Build]] (usually updated when Ragnor makes user-visible changes)
    * wget http://www.meflin.net/crossfire/CrossfireEditor.jar

===== Installing Gridarta on Windows =====
  * Access the latest .jar from [[http://invidious.meflin.net/crossfire/CrossfireEditor.jar]]
  * 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.

===== Building and Running Gridarta =====
To build Gridarta, you need to use the //[[http://en.wikipedia.org/wiki/Apache_Ant|Apache Ant]]// build system, and Java 1.5.0 or higher is required to both build and run Gridarta.
==== Building Gridarta4Crossfire ====
Inside of the Gridarta source directory, run:
  cd crossfire
  ant
==== Building Gridarta4Daimonin ====
  cd daimonin
  ant


==== 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.

===== Special Instructions & Troubleshooting =====

==== ant setup ====

  * See the [[howto:setup_ant_toolchain|HOWTO Set up the ant toolchain]] page.

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

<code>
 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'.
</code>

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:
<code>
   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)
</code>

 * Make 1.6 your "default" for the command line
<code>
  $ vi ~/.bash_profile
  PATH="/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Commands:${PATH}"
</code>
Then run:
<code> 
   $source ~/.bash_profile
   $java -version
</code>

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
Crossfire Wiki

User Tools

Site Tools

Page Tools
