mgswin overview

mgswin is the windows interface. It is basically an enhanced notepad. You'll find all relevant commands in the Tools menu.

Settings :

DLL Name :
 You can select the dll file. This adds the dll directory to the search path.

Output File Name :
 MAP file to output generated brushes.

Paths file :
 You can add any number of directories to the search path. Simply create a text file with your paths. One line per directory path.

Overwrite Map File :
 You can choose to overwrite the MAP file you are working on, or to append the brushes. Overwriting is helpfull for testings, but adding is required when working on a bigger level.

Use Float Coordinates :
 Tells MGS to output using float coordinates. The MAP files are larger, but you avoid distortions caused by integer clamping that may cause leaks. This feature is only relevant if your level editor supports float coordinates, such as radiant.

Default Texture Name :
Enter the default texture name.

Usage example :

1) Open your favorite map editor
2) Create a new map file
3) Begin map design, till you feel like using some MGS feature ... say you want to add a corridor
4) Save your current map file, and open mgswin
5) Type in your corridor ... for example :
corridor { data prefabs/corr2.map begin <0,0,0> end <400,100,100> }
6) Save the script file (.mgs)
7) select your map file in the Settings dialog box, unselect the overwrite flag.
8) Execute the script (Alt+G)
9) Reload your map file in the editor ... there it is!

Now you just have to learn the scripting syntax ... browse through the docs, edit the *.mgs files provided ...