JassNewGen

# The JassNewGen pack 1.4a

This distribution includes grimoire (1.4), the jasshelper compiler (0.9.9.3), PJass (1.0j) and PitzerMike' Grim Extension pack 0.9 and TESH 0.7 all ready to run.

The final result is a world editor that compiles vJass code, uses PJass to check for errors, highlights jass code, has a proper testing environment and can use grim extension pack as well. Not to mention that jasshelper also saves backups of whatever you save so it is also safer.

# Usage

Make sure you computer has access to your war3 CD and that you are using the latest patch and that your worldedit.exe is not a cracked version

After extracting the zip to some folder, execute 'NewGen World Editor.exe'

The first time you run, grimoire might ask you for the location of warcraft III

Once world editor enters there should be two new menus in the main world editor window: grimoire and compiler

You can configure wehack at the grimoire menu

## Grimoire menu commands

- Start war3 with: These are options for testmap, you may disable grimoire for war3 so it stops loading war3err during test map, war3err is good for finding your errors but it may be an obstacle when testing performance.
- Enable object editor hack: This allows you to enter custom rawcodes for objects created in the object editor.
- Enable no limits: If checked removes World Editor limits (doodad/neutral building/etc)
- Syntax checker options: It is better to keep these options checked for optimal jasshelper compatibility, else world editor's syntax may cause you issues or even crashes when enabled.
- Enable war3err: You may eventually want to enable grimoire for test map but not war3err, this is the option for you to disable.

A more detailed description can be found in the Grimoire documentation.

## JassHelper menu commands

- Enable JassHelper: If checked jasshelper should be called when you save the map/click testmap
- Debug Mode: Sets debug mode, check jasshelper's readme for more information.
- Disable vJass syntax: You may find that the vJass syntax compiling might take some time from you when editing maps that do not use it, you can disable it so jasshelper just calls Pjass to compile the map.
- Show previous errors: It could happen that you got syntax errors and you closed the error window, if you want to check them back without compiling the map again, use this option.

More details on the vJASS standard can be found in the JassHelper manual.

## Extensions menu commands

Now it is possible to use some of PitzerMike's extensions from this menu interface instead of from the map script. A detailed explanation can be found in the separate Grimex documentation

## TESH integration

In this version SFilip's Trigger Editor syntax highlighting plugin is already included. This will highlight your JASS-code in the trigger editor and assist you while typing your code.

## WE Unlimited support

If it finds WEU installed on your computer, Grimoire will add a menu item to the Grimoire menu. If for some reason you need to use WE Unlimited but still want the extensions this pack offers, simply enable that option in the menu and restart the editor.

# Documentation files

Grimex Manual: grimext\grimexmanual.html
JassHelper Manual: jasshelper\jasshelpermanual.html
JassHelper Demos: jasshelper\demos\
Grimoire Manual: grimoiremanual.pdf

# Notes

- This is an unzip and run pack for those who don't want to mess with single file preparation and stuff.
- To update and use grimoire it would be better to just keep using its distributions and just add the single mapcompiler.exe and pjass.exe to it
- Grimoire's read me and all the tools are available
- To update PJass simply replace the jasshelper\jass.exe
- To update JassHelper simply replace the jasshelper\jasshelper.exe with a newer version
- To update Grim Extension pack simply replace the contents of grimext folder
- The plan is to update this package whenever one of its parts is updated.
- To uninstall just remove the files
- 'run World editor.exe' can be given usual worldedit.exe arguments and pass them (you can make a file association to it so double clicking a map opens it in this custom editor)
- By default, WE will use grimoire with war3err for testmap, it is really useful to find mistakes that would otherwise cause silent bugs or crashes, and to monitor memory leaks.
- In this release, Grimoire's war3err has bytecode trace and nopause turned off, you have to edit war3err.conf to enable them.
- In case something goes wrong, jasshelper automatically saves last 26 input maps in the backups folder. So you can restore a backup (it should be useful to sort the contents by date)

# Credits

- Grimoire: Bryan Steinbach aka PipeDream
- JassHelper: Vexorian
- PJASS: Rudi Cilibrasi (first versions) and PitzerMike (updates)
- GrimEx: Pitzermike
- TESH: SFilip
- Icon: Mc!