Staredit Network > Forums > SC1 Mapping Tools > Topic: Tool to extract triggers from .scx file and then reinsert them
Tool to extract triggers from .scx file and then reinsert them
Dec 5 2018, 12:45 am
By: sethmachine  

Dec 5 2018, 12:45 am sethmachine Post #1


I have used this open source project for Warcraft 3 files (.w3x):

It treats a .w3x as an archive which is made up of other files. Namely there is a war3map.j file, which contains all the triggers for that map.

What is the equivalent for an .scx file? I want a way to programmatically rebuild a .scx file with updated triggers, so I don't have to use the SCMDraft GUI to copy and paste whole new triggers, etc.

The API should look something like below. I know this is 100% possible, because I have this exact setup/API for Warcraft 3 maps (see: using an external DLL. Can someone point me to what I need to look at to get started?

infile = '/path/to/map.scx'
# extract the triggers data (in human readable format)
with open_archive(infile, 'r') as archive:

# create new triggers or whatever
new_trigs = create_new_trigs()

# update the map's triggers data
with open_archive(infile, 'w') as archive:


Dec 5 2018, 7:15 am poiuy_qwert Post #2

PyMS and ProTRG developer

Hey sethmachine,

StarCraft maps (.scm and .scx files) are also archives like .w3x files. They are all just MPQ files (or MoPaQ files) with different extensions, so can be opened/edited with any of the various MPQ editing programs/libraries.

The first problem for editing StarCraft maps in the way you are looking for is that most of their "parts" are not stored in separate files in the mpq (only custom sound files are stored separately). Everything else is placed together into one binary scenario.chk file inside the mpq. The second issue is that your triggers are not stored in the chk file as "code", but as a "compiled" version of the triggers (though unless you are using a trigger generator, no information is lost in the compiling, it can be decompiled to its original source). The third and probably most complex/hardest issue is that all of the strings used for the map (scenario text, custom unit/switch/location names, trigger text, sound file paths, etc.), are stored and intermingle in a single section and only referenced from the other sections by an ID, so its very hard to manage the strings.

There are various tools that have been made to do trigger generation using higher level languages (including Python), you can find a bunch of them on the main page in this forum, and i'm pretty sure there are more. Most of them generate SCMDraft triggers that can be pasted into SCMDraft (or .trg files which can be imported into a map or used in mods), but I think there might be a couple that can inject them directly into maps. Also most, if not all, of these tools don't extract triggers from the map. Usually you would keep your "code" outside the map, update the code, regenerate the triggers, and update the map with those new triggers. Here is just a small list of the tools off the top of my head that you could look into (there are plenty of great tools around):
- LangUMS
- LIT (Lua)
- ProTRG (Python)
- TriGen (Python)
- Oreo Triggers (PHP)
- MacroTriggers

Another option is to go even lower level. I have written a suite of modding tools in Python called PyMS, which are built on top of custom libraries to read/edit most of the StarCraft files, including CHK and MPQ files (MPQ editing is a wrapper around ShadowFlare's SFmpq.dll). It may not be super user friendly, but if you know your way around python/programming, it can accomplish everything you are asking and will provide total control over everything. ProTRG could also probably be tweaked to interface with PyMS for even more power. I can also try and give some help/direction if this is the route you would like to take.

There is a lot of information here, I hope it all makes sense and gives you some idea where you want to go. If you have any questions I would be happy to clarify/elaborate.

Have fun!

Post has been edited 1 time(s), last time on Dec 8 2018, 5:44 pm by poiuy_qwert.

  Back to forum
Please log in to reply to this topic or to report it.
Members in this topic: None.
[02:32 pm]
ProtoTank -- I just played on a korean map where protoss forge was used to upgrade all units. Is this an EUD map? How did they do that?
[10:17 am]
O)FaRTy1billion[MM] -- :wob:
[2020-5-28. : 10:57 pm]
lil-Inferno -- That's legit the only other map trailer I can think of, also by Tux
[2020-5-28. : 10:56 pm]
lil-Inferno -- A&O Saga?
[2020-5-28. : 8:44 pm]
youarenotworthy -- The trailer in question uses that exact music I linked. In fact, it's the main reason I remember it at all, because originally I was thinking it was a Matrix map, but I think it only used that music and that's why i thought that.
[2020-5-28. : 8:43 pm]
youarenotworthy -- Thanks NudeRaider, I found that, it's not it.
[2020-5-28. : 8:25 pm]
NudeRaider -- youarenotworthy
youarenotworthy shouted: If anyone remembers though, the map/trailer for his map used this music: ""
the music is not exactly the same, so I'm not sure if it's another piece entirely or just another version but maybe this is it? this would be the trailer to Tuxedo-Templar's Rush map.
[2020-5-28. : 7:48 pm]
youarenotworthy -- If anyone remembers though, the map/trailer for his map used this music: ""
[2020-5-28. : 7:46 pm]
youarenotworthy -- Thanks lil-inferno... I'm not sure if it was tuxedo templar. I remember his stuff being good too, but I can't find the trailer the guy made. I might be mistaken about his name. Either way, thanks. I'm gonna give up on trying to find it XD
Please log in to shout.

Members Online: Roy