JUICE v1.1.1
http://sourceforge.net/projects/juiceforge

by Darren Watts (GUI code), Koji Koizumi (backend code),
and Jon Irons (backend code)

"Blood is a very special JUICE." --Mephisto, Goethe's Faust I



For questions, bug reports, or comments, contact Jon Irons: jonirons at gmail
dot com. We have a lot of basic stuff we want to do with JUICE, so we'll
probably ignore feature requests until we accomplish these goals.

More or less everything about JUICE can be found in the docs directory; for an
HTML version of the manual, see docs/Manual/Manual.html . For a printable PDF
manual (printing is highly recommended), see docs/Manual.pdf .

While we are aware that many new map editing tools are in development, we aim
to create clean, recyclable code. The primary "competition" to JUICE is
HogePiyo's MapEditorOne, which currently only runs in Windows. We look forward
to progress on this program, but we are aware that HogePiyo is Japanese, and so
are many of the comments that he has made in his code. If you don't know C++,
or you want to look at code more oriented toward speakers of English, check out
the source to JUICE. Of course, our source code is contained in the "src"
directory. Compiling it on a POSIX system should be very easy, if you have
Java 1.4.2 or greater installed: simply change to this project's root directory
(where this Readme is contained) and type the "make" command, and then either
run ./JUICE.sh or ./makeJar.sh and then java -jar JUICE.jar

We have released JUICE under the terms of the GNU General Public License; see
"docs/COPYING.txt" for more details. The gist of it is that the source code to
JUICE is completely open and free for you to use as you like, as long as you
release it under the GPL. Again, see the actual GPL document, COPYING.txt, for
details. We'd like to hear from you if you want to use our code (mainly out of
curiosity). See the top of this document for Jonathan Irons's e-mail address.

In addition to coding for the benefit of Marathon players, we are also in the
process of creating an up-to-date Map File specification sheet. It's not very
pretty right now, but it's the best concentration of Marathon 2/Marathon
Infinity/Aleph One map file information. The goal is to take the information
gleaned from Aleph One's source code (and from reverse-engineering in some
cases) and concentrate it into a single document. Check out "docs/Marathon
Infinity File Specs.txt" for more information.

Changelog:

v1.1.1: New support for Shapes patches generated by Anvil. This embeds a shapes
patch into a given level so that new textures and other shapes may be added for
transmission across a network.

v1.1: With support for LINS and SIDS, complete texture manipulation is
possible; the main thing to come out of this is the texture converter, which is
used in both a dialog, and which runs thanks to a script system. Watts also
extended JUICE to run on Java v1.4.2, allowing users of Mac OS X version 10.3
to enjoy the benefits of JUICE.

v1.0: Added tons of stuff, including "POLY" support, "OBJS" support, tons of
speed and bug fixes, a new manual, new commands in almost all editing modes, a
new Save As... function and much more. See the manual for complete information.

v0.3: Added manipulation of the "plac" chunk, which encompasses item and
monster respawn rates and related information. Added map checksumming for
secure compatibility with Aleph One. Added support for unmerged maps produced
by Forge, and for maps encoded in Mabinary (a.k.a. "Unimaps"). Created a system
to track whether parts of a map have been changed, and therefore need to be
rewritten to a file (unchanged parts are not written, which decreases the time
it takes to save a map).

v0.2: Name changed to JUICE. Created completely new project structure (separate
classes and packages for backend and GUI stuff). Added Map Info Chunk editing
(environment and mission flags, landscape selection, overhead map name
editing). Added a default directory preferences item. Added a nice little icon
to JUICE when it's running.

v0.1: First release, under the name JuiceFlag. Basic game type flag editing for
maps.

Known Bugs:

JUICE does not read all information in unmerged Forge maps encoded into
MacBinary format; the level name and game type flags do not appear.
