# UMSWE 5.0

UMSWE basically adds all the missing content and functions to the World Editor that Blizzard forgot or didn't manage to add. Version 5 of UMSWE is now integrated into Grimoire/Jass NewGen and the changes are dynamically applied to your data files. This means that it's now independent of your language and the Warcraft patch that you are using. Now here's a list of the most important changes to the World Editor.

## Table of content

- Core Features
- Category Configuration
- Tile Pathability Configuration
- Tileset Specific Creeps
- Credits

## Core Features

The core features of UMSWE are enabled by checking the UMSWE\Enable UMSWE menu option. Enabling this option can take several seconds because many changes have to be applied. After enabling/disabling an UMSWE option or making changes in an UMSWE configuratin dialog, the editor must be restarted to have them applied. You will notice that UMSWE is enabled if the startup logo of the World Editor changes to the UMSWE logo. For all the optional features this core option must be enabled.

### Terrain Editing Features

The max width and height for new maps is increased to 480 and the max and min terrain height is also increased. Additionally it's now possible to create steep hills with the raise/lower tool of the editor, so that you can create cliffs without using the cliff tool.

### Game Interface Additions

All additional fields for the Game Interface configuration dialog that were part of the Game Interface Project are now included in UMSWE. This means that you can now edit Tooltips, Hotkeys and Icons of general commands like move, patrol, stop, hold position, cancel and so on. Chat recipients and the fonts used by the game can now also be edited in the Game Interface configuration.

### Extended Object Editor Limits

The upper and lower bounds for many values in the object editor have been adjusted to better represent the actual bounds. It was always possible to override the bounds by shift-clicking the property in question, but is still useful as a guide to know which values will actually work ingame. Furthermore fields that are normally only available for buildings like units trained, researches available, items sold, etc. are now also available for units and heros. The type of the 'Destructable Created' field of the Volcano ability is changed to string, so that it won't display the unitpicker.

### Trigger Editor Additions

- The custom script representation of many trigger actions is changed from a bj function to the native equivalent to improve performance.
- Several trigger function hints are improved and the 'Region' trigger category is changed to 'Rectangle' in order to introduce the native region type to the GUI.
- Several new types are made available as global variables and for comparison operators. For example event ids can now be compared to find out the triggering event for a trigger.
- Numerious trigger presets have been added, for example animation names, animation tags, color presets and various other presets.
- Many missing trigger functions have been added, for example unit group and trigger handling functions and many more. Those are marked with a [UMSWE] tag in their hint.
- The new 'Return Success' trigger category offers numerous trigger actions in a way that a boolean is returned that indicates the success of the operation. That way you can issue orders and check if the order was issued successfully.
- Many outdated functions that were part of previous UMSWE and WEU versions have been moved to the 'Compatibility' trigger category to indicate that they shouldn't be used any more, but still retain compatibility with those older versions. Their hints often point you to the function that should be used instead.
- Finally a 'Custom Script' option has been added to conditions and all return types, so that you can now use custom script for function parameters and as a trigger condition.

This screenshot shows the 'Return Success' functions and the 'Custom Script' option for boolean parameters:

### Hidden Material

All the hidden models and hidden icons are added to the editor by UMSWE. You can find them in the 'Extra' section of the mdl and blp selection dropdown. Also hidden abilities like Move, Attack, and Hero and hidden units are now shown in the object editor.

## Category Configuration

UMSWE allows to change the order of the categories in the object editor, gameplay constants dialog and game interface dialog like WEU used to. Contrary to WEU, however, it's possible to customize the prefixes of the categories to change their order to your liking. This image shows the configuration dialog that can be opend via the menu command UMSWE\Customize Editor Categories:
Finally to have your custom categories applied you must check the UMSWE\Custom Editor Categories menu option and restart the editor. Assuming the UMSWE core option is also enabled your changes will then be applied:

## Tile Pathability Configuration

You can modify the buildability, walkability and flyability of each tile in a GUI that can be started via the UMSWE\Customize Tile Pathability menu command:
After restarting the editor the changes will be applied if the UMSWE\Custom Tile Pathability menu option and the UMSWE core options are enabled. Whenever you save a map, the editor will then generate the pathing map for it according to your configuration. There's a known issue, that disabled flyability automatically disables buildability for the same tile. A workaround is using the Grimex PathMapper tool to enable buildability for those tiles.

## Tileset Specific Creeps

With the UMSWE\Non Tileset Specific Objects menu option enabled, all creeps and destructables will be made available for all tilesets. After toggling this option you need to restart the editor to apply the changes.

## Credits

There are several people who worked on the original UMSWE and other related tools:

- Scio being the UMSWE godfather
- Starcraftfreak who developed UMSWE after Scio
- FyreDaug has tested out many of the object editor limits
- PipeDream made Grimoire
- ShadowFlare made the SFmpq library
- KDEWolf made the UMSWE logo
- Vexorian and BlacKDicK are UMSWE contributors
- Earth-Fury, MindWorX and HappyTauren helped with the testing/debugging
- Wc3Campaigns is hosting us and a I used their tauren theme for this

Have fun, PitzerMike