How to use GMSI as an external call

11-26-2009, 09:07 AM

gekko's GMSI is a pretty awesome tool. It lets you alter map code, terrain, object data, etc with code similar to C. It's now possible to embed GMSI scripts directly into your own libraries and run them with an external call, just like the ObjectMerger that everyone already uses. Here's how:

1.) Download GMSI from the linked thread.

2.) Extract the entire contents of the .rar file directly into the BASE directory of your jassnewgen folder. It won't work if you use a different folder.

3.) Open jasshelper.conf within the base jassnewgen directory and add GMSI as an external entry:

Code:

//* 
//* grimextension pack by pitzermike:
//*
((underneath all the other entries, add:))
"GMSI", "GMSI.bat"

4.) Edit GMSI.bat within your base jassnewgen directory (you can use Notepad) to the following:

Code:

start java -Xmx512m -jar GMSI.jar %3 %1

5.) Now you may use external calls to GMSI within your maps. Here's an example of how to do so:

JASS:

//! externalblock extension=gsl GMSI $FILENAME$
//! i 
//! i echo("Hello world!");
//! i 
//! endexternalblock

If you see the GMSI console pop up and print "Hello world!" then you've done everything correctly.

Hopefully, the next version of the NewGen pack will include GMSI support, so these steps will be unnecessary in the future.