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 ans reliable experience.
In this new version we have implemented new stuff, 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. The features included in this pack are the following:
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.
Important Note: This version now comes with Sharpcraft, a better implementation of Reinventing the Craft. So from JNGP version 2.0.7. we'll be updating this awesome mod and JNGP will offer and easy to use File Updater.
最終結果是世界編緝器編譯 vJass 代碼，使用最新的 PJass 檢查錯誤，反白 jass 代碼，有完完全全的執行環境，支授著色工具提示圖像預覽，並可以使用 grim 擴充套件包。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. JNGP 2.X.X. 最新動向
------------------------------------------------------------------------------------------------------------------
Mainly our interest was 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 we've added more a more features requested in this topic and now we are offering a very stable version with new features. These are the new features implemented:
Check for Updates: 檢查更新:
[attach]232216[/attach]
From version 2.0.7, you will have an easy interface to know if there's a new version of this pack or any of the other mods contained in JNGP. In this first release, Sharpcraft will come as a CORE feature of this pack, but later we'll implement a protocol to allow other custom additions to this pack.
Multiplayer Emulation: 多人遊戲模擬:
[attach]232217[/attach]
Taking advantage of Kloader library (credits to kolkoo for this awesome app), we now can run multiple instances of Warcraft III. 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.
JNGP Version 2.0.X > Start Multiplayer Emulation...
Fast Map Running 快速執行地圖
[attach]232218[/attach]
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
有了此功能你可以按右鍵來執行任何地圖。為了啟用此功能，你必須已經開啟 JNGP 並解除核取和核取 "啟用殼層擴充套件"。此動作將會重新載入 JNGP 的新功能。
在魔獸爭霸 III 地圖按右鍵
Custom Menu Settings 自訂選單設定
[attach]232222[/attach]
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.
Status Information 狀態資訊
[attach]232223[/attach]
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 Creports (even it open this page to post your issues at once [attach]232228[/attach][attach]232228[/attach])
Set Manually WC3 Path 手動設定魔獸爭霸3路徑
[attach]232224[/attach]
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 [attach]232230[/attach]
JNGP Version 2.0.X > Set Manually WC3 Path...
收到大量 JNGP 偵測魔獸爭霸 III 路徑之後，我已經設定一個方法來手動設定路徑。如果你使用此方法不能設定路徑，你無擬沒有安裝魔獸爭霸3或你有什麼出錯
JNGP 版本 2.0.X > 手動設定魔獸爭霸3路徑...
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.
After extracting the zip to some folder, execute 'NewGen WE.exe' or 'we.bat' The first time you run, Grimoire might ask you for the location of Warcraft III.
Once world editor enters there should be three new menus in the main world editor window: Extensions, Grimoire and Compiler.
You can configure various hacks for the WE at the Grimoire menu.
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.
JassHelper menu commands JassHelper 選單指令
------------------------------------------------------------------------------------------------------------------
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 TESH 整合
------------------------------------------------------------------------------------------------------------------
In this version SFilip's Trigger Editor syntax highlighting plugin (now improved by Van Damn) has been upgraded with the addition of hashtables commands and delimited comments. This was called "Project Horus" and comes with the latest version of Scintilla library highlighter.
This will highlight your JASS-code in the trigger editor and assist you while typing your code.
Additionally, I've set as default a dark theme for TESH highlightning for better reading (check image below).
UMSWE 5 integration UMSWE 5 整合
------------------------------------------------------------------------------------------------------------------
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.
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 "jassnewgenpack5e".
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 擬難排解
------------------------------------------------------------------------------------------------------------------ My antivirus software reports viruses, is this package infected? 我的殺毒軟件報告有病毒，此封裝是否被感染病毒? No, some antivirus tools just think it is 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, see below).
Here's a list of tools that have been reported to cause trouble with NewGen:
Avira Antivir detects several of the files as trojans, you can choose ignore for the reports and whitelist those
files later to fix the problem.
Kaspersky Antivirus also gives false alarm and it's not possible to effectively whitelist NewGen. You need to turn Kaspersky off to use NewGen (see several questions below).
EZ Antivirus silently quarantines some files breaking the editor completely. You need to turn it off before even downloading the pack, but then you should be able to whitelist NewGen, once it's installed.
Avast Antivirus reports false viruses. It is possible to whitelist NewGen in its configuration though.
AVG reports false viruses and may silently delete required files. I don't know if you can set an exception in AVG.
F-secure reports several false viruses but you can make it ignore the NewGen files.
Check the forums if you have trouble with your antivirus software and NewGen.
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? 當我使用測試地圖按鈕，魔獸爭霸 III 將開啟，但如何返回主選單同時不會載入地圖?
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? 在視窗化和 OpenGL 模式使用測試地圖沒有問題，但為什應測試 AI 按鈕不受影響?
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? 每當我開啟 NewGen WE ，會顯示找不到魔獸爭霸目錄，或者我需要每次在瀏覽器對話框選擇它。有什麼出錯?
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? 每當我開啟 NewGen WE，會顯示執行個體已經執行，我需要換入 CD 或關閉卡巴斯基。有什麼出錯?
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? 當我開啟 NewGen WE 時，Grimoire 選單不會出現，或只出現於第一次開啟 NewGen 時侯。WE 的行為如像未完全安裝模塊，似個一般 WE，什麼出錯?
Make sure you have patched your Warcraft installation to version 1.21.
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? 觸發編輯器有時會隨機故障或我看到一個訊息關於無效的指標或相似於tesh.dll?
The syntax highlighter has problems with Window Blinds and maybe other window mods. Set an exception for the WE in Window Blinds or disable the tool while you're using NewGen.
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[attach]232227[/attach]
)