LocUnlock v1

[poiuy_qwert]

LocUnlock is an MPQDraft and FireGraft v0.93 plugin supporting SC:BW versions 1.15.1 to 1.15.3 (1.15.2 and 1.15.3 are currently not supported by FireGraft v0.93), designed to allow modders the use of locations in game types other then Use Map Settings. The two things you can do with this plugin is make the Anywhere location cover the whole map with all elevation levels, or set one or more values (top left x/y, bottom right x/y, and elevation flags) of any location you want.


MPQDraft Installation/Application:
1) Extract LocUnlock.qdp to your MPQDraft folder
2) When creating a SEMPQ or loading an MPQ patch, make sure the "LocUnlock v1" plugin checkbox is checked


FireGraft v0.93 Installation/Application:
1) Extract LocUnlock.qdp to your FireGraft folder
2) When editing your project, go to the Plugins tab
3) Click tha add Add button under MPQDraft plugin, and select LocUnlock.qdp


Usage:
LocUnlock uses the EnableDebugMode (which is currently only supported by PyTRG) action to edit locations, and takes its parameters from the Start Locations (unit 214) death count of different players:
Player 2: Location number
Player 3: Values to change (bitmask: 1 = top left X, 2 = top left Y, 4 = bottom right X, 8 = bottom right Y, 16 = flags)
Player 4: Top left X
Player 5: Top left Y
Player 6: Bottom right X
Player 7: Bottom right Y
Player 8: Elevation flags (bitmask: 1 = Low Elevation, 2 = Medium Elevation, 4 = High Elevation, 8 = Low Air, 16 = Medium Air, 32 = High Air)

If the Location number or Values to change is 0, then the Anywhere location is automatically set to cover the whole map with all flags set (like how it starts for UMS maps).


Examples:
Make Anywhere cover the whole map at the start of the game:

Code: Select all

Trigger(All Players):
	Conditions:
		Always()
	Actions:
		EnableDebugMode()

Cover 2x2 square of tiles in the top left with location 1 when switch 1 is set:

Code: Select all

Trigger(All Players):
	Conditions:
		Switch(1, Set)
	Actions:
		SetDeaths(Player 2, Start Location, Set To, 1)
		SetDeaths(Player 3, Start Location, Set To, 31)
		SetDeaths(Player 4, Start Location, Set To, 0)
		SetDeaths(Player 5, Start Location, Set To, 0)
		SetDeaths(Player 6, Start Location, Set To, 64)
		SetDeaths(Player 7, Start Location, Set To, 64)
		SetDeaths(Player 8, Start Location, Set To, 63)
		EnableDebugMode()

Credits:
bajadulce: Giving me the idea to make this and for hosting!
Doodle: Some code I used to learn from
A_of-s_t: Helping, and being cool
DiscipleOfAdun: Supplied function to get the SC version and for mucho grande help!

Download: LocUnlock.zip

[Ricky_Honejasi]

I might not have much interest in playing Starcraft nor followed much the SC Modding scene but ...

What is the use of being able to use locations in melee maps?

Since in all honesty, if you use locations it's pretty much assured you use it in a non-melee map (along with triggers to spawn units at that location or something that also makes the map non-melee) unless somehow the triggers are modified to be usable in melee maps.

[IskatuMesk]

You can have triggers run in melee maps but to my knowledge you cannot accurately place locations within a melee map in real-time.

[Whiplash!]

I'm confused... what exactly will this enable for modders, what is the use?

[Lavarinth]

I'm assuming this will/has the possibility to also work with locations placed in the map already?

[poiuy_qwert]

designed to allow modders the use of locations in game types other then Use Map Settings.

This is meant to be used with GOT triggers. When you are in melee all the locations are in the top left corner, with widths and heights set to 0, which means you cant use them at all (no way to move them out of the top left corner, no way to change the size). This changes that, the first function of the plugin sets Anywhere to cover the map with all elevations so you can center other locations and other triggers that required it. The second function lets you change anything about any location, so size, position, and elevation flags. In short, it enables you to do anything a UMS map can in the the melee game type, and some new cooler things like moving locations with dc math for example.