GX Studios - MapEditor

This is a simple download page for anyone who's looking for the latest version of MapEditor.

Report

As part of the project, I was required to produce a report detailing how I went about writing MapEditor. Anyone who's interested in reading it can find it here.

Requirements

• You must have the Java 1.5 compiler installed. If you don't, get it here.
• You must have Java3D installed. If you don't, get it here. (I'm using the OpenGL version of Java3D, but since I'm only using some of the vector classes from it, I can't see that it's likely to matter much.)
• You must have JOGL installed. If you don't, get it here. The version you want is the latest one, which at the time of writing is under Release Builds 2005 -> 1.1 June 24. You need jogl.jar, which has to go in the lib\ext directories of both your jdk and jre installations, and jogl-natives-?.jar, depending on your operating system. The libraries inside it (e.g. the DLLs, for Win32) need to be extracted to the bin directory of your jre installation.
• It's very possible that they'll change the layout of their download site at some point. If so, just go here and search around for it. Look for words like "Precompiled binaries". If the worst comes to the worst, email me, because I've got the files. If I'm likely to reply, you probably already know my email address so I won't put it here for spammers! :)

Installation Instructions (for Windows)

1. Save this file to a folder of your choice as "MapEditor-Source.jar". (The source code will be extracted to a folder called MapEditor in the directory you choose.)
2. Save the installer to the same directory.
3. Locate and run the install program (either in Explorer or at the command prompt).
4. (Save the maps file to the newly-created MapEditor directory and extract the files within it by typing "jar xf MapEditor-Maps.jar" at the command prompt whilst in the MapEditor directory. You only need to do this if you want to take a look at the maps I've created with the editor.)

Installation Instructions (for Unix)

It's slightly harder to install on Unix, because I haven't got easy access to a Unix system on which to test an automated script and thus haven't written one yet. The following instructions essentially tell you to do manually exactly what the Windows batch file does.

1. Save this file to a folder of your choice as "MapEditor-Source.jar". (The source code will be extracted to a folder called MapEditor in the directory you choose.)
2. In the shell (in the directory you saved in which you saved the file), type "jar xf MapEditor-Source.jar".
3. Type "cd MapEditor".
4. Type "jar xf MapEditor-Resources.jar".
5. Type "make".
6. (Do as per the Windows instructions for the maps file.)

Running the program (in Windows)

1. Change to the MapEditor directory.
2. Type "run".

Running the program (in Unix)

1. Change to the MapEditor directory.
2. Type "java -jar MapEditor.jar".

Uninstalling

• Delete the MapEditor directory.
• Delete the MapEditor-Source.jar file.
• Delete the install.bat file (Windows only).