---

What is it?

Jass NewGen Pack 2 is one of the most important tool for any WC3 modder because it offers a full set of plugins to develop maps using the improved vJASS language. Even more, it comes with new stuff to make mapping a faster and reliable experience.

In this new version we have implemented the newest applications, more access to specific tools, help files and (hopefully) a nicer experience to the final user. If you have any comment or suggestion about how to improve this pack, just propose it here in a new reply. The features included in this pack are the following:

• Grimoire (version 1.5)
• MindWorX's SharpCraft (4.0.0.137)
• Glowackos / Cohadar jasshelper compiler (version 2014-03-10)
• TESH 0.8.5 (TESH Revamp by looking_for_help)
• Vexorian's jasshelper compiler (version 0.A.2.B)
• PJass (1.0m)
• PitzerMike's Grim Extension pack 1.0b
• UMSWE (5.0)
• Risc's Colorizer FINAL. Requires .NET framework to run
• ScorpioT1000's Campaign Builder (0.1)

The final result is a world editor that compiles vJass code, uses the latest PJass to check for errors, highlights jass code, has a proper testing environment, supports visual preview of colored tooltips 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.

What's new in JNGP 2.X.X.

---

this project started after Vexorian left the developing JNGP 5d, and it was an interest to recover a lost feature since Warcraft III version 1.24: the ability to play a map directly with just a right click. From this simple idea we've been adding more a more features which were requested in this topic, and now, after several years, we are offering a very stable version with new and interesting features. Let's talk about this:

Multiplayer Emulation: Taking advantage of Kloader library (credits to kolkoo for this awesome app), we now can run multiple instances of Warcraft III in local way. At first sight is that was not useful, but with this you can use the LAN Game settings to test your map in an equivalent multiplayer environment and thus, checking any possible issues related with desyncs or failures that only were possible to detect with the help of a partner in Bnet. Important note: Since 1.27 patch, this loader doesn't work directly, so it's is mandatory to revert WC3 version to 1.26. Please use the Patcher Dialog Box to allow this feature. JNGP Version 2.0.X > Start Multiplayer Emulation...
Warcraft III Patcher Motivated in running the Multiplayer Emulation Tool in 1.27 patch, This tool was created to set different versions of WC3. It covers several versions, from 1.21 to the current 1.27. This patcher must be set in 1.26 if you want to run the multiplayer emulation, and with the older patches, it could allow running classic maps, just to remember the old days :) JNGP Version 2.0.X > Change WC3 version...
Fast Map Running With this feature you can run any map with just a right click. In order to enable this feature you have to open JNGP and uncheck and check the "Enable Shell Extension". Doing this JNGP will reload the new feature. Right click in a Warcraft III map
Custom Menu Settings With this you can add custom WC3 tools in JNGP without the need of touching any part of the JNGP code. With this you can run from executables to normal files. JNGP Version 2.0.X > Set Custom Menu Loader...
Status Information This dialog box will serve as a way to report any issue, it was designed to get important info about your current JNGP and WC3 settings and it will serve to add more settings according to the evolution of this pack. From this interface, you can post directly and nicely your bug reports (even it open this page to post your issues at once :) ) JNGP Version 2.0.X > Diagnose JNGP Settings...
Set Manually WC3 Path After receiving a lot of issues related to non detection of Warcraft III path in JNGP, I've set a way where you can define it manually. If you can't set the Path in this way, definitely you don't have WC3 installed or you have something really wrong :P JNGP Version 2.0.X > Set Manually WC3 Path...

About bug reporting

---

In order to be organized in the bug reporting process, please use the JNGP Settings dialog box to get your actual settings.

New Features Suggestion

---

Besides the current new features, you can propose other ones. You can do it in this thread. Please take in mind that Warcraft III and WE itself has its own limitations, and even more JNGP. For that reason we will inform you if the feature requested can be possible or not.


Usage

Make sure you are using the latest patch and that your worldedit.exe is not a cracked version.
JNGP requires internet connection for some of its addons.
After extracting the zip to some folder, execute 'NewGen WE.exe' or 'we.bat' The first time you run, JNGP might ask you for the location of Warcraft III.
Once world editor enters there should be a new set of menus in the main world editor window: Extensions, USMWE, Grimoire JassHelper, SharpCraft, Campaign Compiler (Sc Exp.) and JNGP version 2.X.X.

You can configure various hacks for the WE 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. If you're using Warcraft versions above 1.21b Grimoire, war3err and japi options won't be available any more in this menu.
• 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.
• Mute editor sounds: Turns off the startup sound, the undo/redo sound, and the sound that it makes when placing/deleting.
• Disable first save warning: When a map is saved for the first time or a Grimex tool is used on unsaved maps, a popup will tell you to save your map again. This popup will be disabled with this option.
• Customize Test Map Settings: Sets the options to load startup settings to the map.
• Grimoire Documentation: Shows the documentation
• About Grimoire: Show Grimoire's Credits

JassHelper menu commands

• Enable JassHelper: If checked jasshelper should be called when you save the map/click testmap
• Enable Cohadar's JassHelper: Sets Cohadar's version as the default compiler.
• Enable Vexorian's JassHelper: Sets Vexorian's version as the default compiler.
• 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.
• Disable script optimization: Disables jasshelper's script optimization if checked.
• 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.

Well, there's a lot of discussion about what jasshelper is better, actually is a decision of taste. Vexorian jasshelper is the base work and he finished updating in version 0.2.A.B, then cohadar took the line improving compiling speed and adding new keywords. Check the following example:


The decision is yours. Just select your favorite compiler in the JassHelper menu. Just remember if you use Cohadar's custom keywords, and change to Vexorian version, this one won't compile your map properly.


Extensions menu commands

Now it is possible to use some of PitzerMike's extensions from this menu interface instead of from the map script. One pretty useful thing here are the shell extensions which make it so a double click on a map opens it in the NewGen editor and not the normal editor, and adds context menu items to run them in Warcraft. A detailed explanation can be found in the separate Grimex documentation.


TESH integration

In this version, we've added the new TESH 2.0, developed by Looking_for_help. Inspired in the previous work by SFilip, and other modifications, this version is now developed in C++ and gives a new step in features and look & feel.
This will highlight your JASS-code in the trigger editor and assist you while typing your code. Just check the image above to give an idea how nice is now coding vJASS in JNGP.




UMSWE 5 integration

UMSWE 5 combines the best of UMSWE 4, WE Unlimited and some smaller spin-off projects. In the UMSWE menu you'll find several menu items that can be used to configure UMSWE.
More details on how to use UMSWE and its features can be found in the UMSWE manual.


Notes

• This is an uncompress and run pack for those who don't want to mess with single file preparation and stuff.
• The plan is to update this package whenever one of its parts is updated or a new feature is implemented.
• To uninstall just remove the files in the folder "jassnewgenpack5d".
• NewGen WE.exe and NewGen Warcraft.exe can be given usual worldedit.exe/war3.exe arguments and and pass them (you can make a file associations for w3x/w3m etc use this custom editor)
• 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)

Troubleshooting



I don't know how and where this must be installed and how to run it?

Just extract all files from the downloaded archive to a directory of your choice. Preferably don't install it directly into the Warcraft III directory. To use it, simply start NewGen WE.exe and NewGen Warcraft.exe.


Which operating systems are supported?

This pack works on Windows 2000 and XP testedly, Windows Vista and Windows 7 also seems to work according to user reports. For Windows 7 is common to set the executable to run as administrator. Older versions and Unix systems or Macintosh are not supported, however parts of this pack can work on other systems if used from the command line.


When I use the test map button, Warcraft III will start but return to the main menu instead of loading a map?

This can happen when your map uses vJASS code and you hit the test map button when the map is unsaved (*-symbol is shown in the title bar) or the map has been saved-as directly before testing the map. Simply save your map before every test-run, so that it's fully compiled.


Windowed and OpenGL mode work fine with the test map button, but why is the test ai button not affected?

You can work around it with the menu command Grimoire\Test map configuration. It offers the same settings as the test ai configuration but works with the normal test map button.


A popup keeps telling me that i should save my map again, especially when working in the campaign editor, how to deal with it?

For the first time a map is saved this is normal, because the path of the map isn't known until then. When you're editing maps from a campaign, however the path cannot be found because those maps are stored inside the campaign.
A workaround is saving a local copy of that map in the maps folder and working with that copy, then when the map is finished re-import it into the campaign.
You can also turn off the popup via the Grimoire\Disable first save warning menu item, in case you want to make basic edits to maps that don't use vJASS features.
Another possible reason are non-standard-ansi characters in the path of your map. On Windows systems of other languages like Russian or Chinese this can be the problem. Copy the map to a directory that contains only standard ansi characters to fix it.


Whenever i start the NewGen WE I'm told that it can't find my Warcraft directory or I need to select it in a browser dialog everytime. What's wrong?

The browse for directory dialog is normal if it's the frist time you are starting the NewGen pack.
If the browser pops up every time, one possible reason could be the lack of admin privileges on the machine. Another possible reason for this is non-standard-ansi characters in your Warcraft installation path, like already described in the previous
paragraph.
If all fails you can hardcode the path into findpath.lua by removing the -- from the line --path=C:\\Warcraft III" and changing the path there.


Whenever i start the NewGen WE I'm told that an instance is already running, I need to insert the CD or to turn off Kaspersky. What's wrong?

Well, as the message already suggests, an instance of the editor may already be running. If this is not the case another cause for this popup may be that you're using a patch prior to version 1.21b and do not have the Warcraft CD in your CD drive.
Some antivirus tools like Kaspersky antivirus also cause this popup. You need to disable those tools before running NewGen.
If you have Kaspersky Antivirus installed, follow these steps to get it working:

• Remove your current NewGen installation.
• Redownload the NewGen pack and extract it to a directory of your choice.
• Reboot your computer.
• Turn off Kaspersky (right-click in systemtray -> Exit) before running NewGen.
• Start the NewGen WE.

Make sure you never try to run NewGen when Kaspersky is on, because it will permanently block it until you restart your computer.


When i start the NewGen WE, the Grimoire menus never appear, or only appear the first time that i start NewGen. The WE acts like a completely unmodded, normal WE, what's wrong?

• Make sure you have patched your Warcraft installation to version 1.21. (is it possible to have it in a version prior to this??)
• Make sure you're not using a cracked WE. Mount the TFT mini image in daemon tools instead of using a crack if you must. Although some people have successfully used NewGen with a cracked WE it is not recommended.
• If you're using Vista/Win7, try it under Windows XP, maybe it's a Vista/Win7 problem.
• A virus might be the root of the problem too, make sure your computer is clean.
• Finally anti-virus, anti-spyware and firewall software can be causing the problem by blocking the changes that Grimoire makes to the WE. Try disabling such software temporarily.

The trigger editor gets random crashes or I get a message about an invalid pointer or similar in tesh.dll?

The old syntax highlighter (Sfilip version) had problems with Window Blinds and maybe other window mods. There's no report with the new TESH so we expect no problems at all. Just in case, set an exception for the WE in Window Blinds or disable the tool while you're using NewGen.

---

Credits

• Grimoire: Bryan Steinbach aka PipeDream
• JassHelper: Vexorian, Cohadar
• UMSWE: the UMSWE team
• PJASS: Rudi Cilibrasi (first versions), PitzerMike & Deaod (updates)
• GrimEx: Pitzermike
• TESH: SFilip, Van Damm
• Colorizer: Risc
• ScorpioT1000: Campaign builder
• Icon: Mc!
• Moyack: JNGP 2.X.X compilation
• PurgeandFire: Suggestions about the development of the new JNGP 2.X.X.

---

Installation

• Please try first the official installation instructions, which are up to date
• In order to use this pack, you need to have Warcraft 3 installed with the Frozen Throne expansion.
• Now that you have downloaded the compressed file, you would need to open with the proper program: 7zip. If you don't' have it in your computer, please download it here.
• Now that you've downloaded and uncompressed the file in a convenient place in your PC, just search the following executable: "NewGen WE.exe"
• It's advisable that you create a direct access to this program if you're an avid WC3 modder :D

And.... that's all. If you have any issue with this installer please post a comment/post/ here.

Old Versions

• JNGP 2.0.7

Don't worry about that, in fact it's not a virus. Just check the official JNGP thread

Does this tool contain viruses?
 No, some antivirus tools just think it does due to the nature of this tool, that works by injecting its own code into the process of the WE. Most tools allow to setup an exception for such cases, some have to be turned off though (like Kaspersky)

I think you have to add an exception to this tool so it won't show annoying warnings.

It says it contains 0.A.2.B but it contained 0.A.2.A for me.

I've just checked and it shows version 0.2.A.B.

Anyways, I'll do an update, just in case.

Updated with the latest version, which includes the latest version of jasshelper by Cohadar. Download it using this link: [smg id=12 type=box width=600 align=center]

It throws an error saying that it wasn't compressed properly whenever I try to extract it. Try re-compressing it and uploading. (unless it works for you)

Hmmm!!!

Try it out the NEW VERSION!!!!! JNGP 1.5e [smg id=1 type=box]

Hello!

today, I ran into a crash:



I thought my map may be corrupted so I export map script and use command line like this: jasshelper.exe common.j Blizzard.j HAVOC.j HAVOC.j but it still crashed.

I tried with older backup of my map, it is fine.

I tried the old jasshelper (with the current map) and it worked fine.
---
check out the script I attached below.

if you comment-out the struct "Resurection" (search for "struct Resurection" and comment-out the whole struct block), jasshelper won't crash.
---
I may hit a limit or something?

can anyone help me?

Hi Tom and welcome to Blizzmod!!

Have you tried this installation pack? One option is to try it first. If it doesn't work, please post what libraries are you using in my map. I have the feeling sure you're one of the few modders who is using old scripts.

With this version of JNGP you can switch without reinstalling or editing anything the jasshelper version. So testing won't be an issue :)


EDIT: what are the library depedencies of that resurection struct? is this struct inside a library or a scope? are you using too many scopes??

I'll do a test this night. I'll put that trigger alone in a test map. If it compiles then the problem would be with pjass. TrollBrain let me know that pjass has a limit in coding processing.

> Question: where is the library "MiscFunctions"?

it's in MiscFunc trigger

> I've seen the issue could be related to the looooooong code and the management of the libraries, I'd suggest to check all the libraries that the codes need.

ok, I will review the code and report anything I find :)

Very small update.

Hi moyack!

The ScExp extension provides features to compile maps in a campaign the same way as individual maps.

The most useful function is "on save" event - it handles your attempts to save by itself and asks you to input some required info.

How to use with the JNGP:
For example you have a campaign mycamp.w3n with a map mymap.w3x
1. Open WE
2. Open campaign window, open your mycamp.w3n
3. Click on mymap.w3x and Edit
4. Do your modmaking stuff
5. Click Save the map
6. Enter name of the map (mymap.w3x)

First WE saves the map and the campaign without compiling. After that CampaignBuilder extracts the map from the w3n archive and starts compilation. If successful, CampaignBuilder imports compiled map back to campaign archive.

If you have any troubles, check your registry:

HKEY_CURRENT_USER\\Software\\Grimoire\\
should have string variables
Enable CampaignBuilder
Use "Recent Document" as current campaign
and values to "on"

Also string variable GrimPath and values - path to your JNGP, ex.: D:\Documents and Settings\User\My Documents\Making\jassnewgenpack5d_experemental\

Thanks,
ScorpioT1000.

Arrg, its confusing boss. The thread title is The Jass NewGen Pack (JNGP) 2.0 but yet the first post title is Jass New Generation Pack (JNGP) version 1.5e, so what is it really?

For now I changed the title of the first post from Jass New Generation Pack (JNGP) version 1.5e -> The Jass NewGen Pack (JNGP) 2.

You fixed the multiplayer local tools??

The emulation also can be found in BlizzMod folder [if I was right, its name was Blizzard Modding/BlizzMod]
Edit the configuration.txt path to Warcraft 3 path then run the Multiplayer Emulation, it should solve it.