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:15 pm]
Dem0n -- no
[01:57 pm]
MTiger156 -- However, my masterpiece project will be an absolutely banger. Though its an RPG (and those have a bad rep for being boring), I promise that this will be the best damn RPG ever made in SCR. Certainly that's worth tons of minerals right?
[01:55 pm]
MTiger156 -- My #FreeHongKong protest map feeling too much like a reskin of Dawn of the Dead. I hate to say that it might get scrapped.
[01:54 pm]
MTiger156 -- I say that verified "skilled" mappers should get an increased earning rate (and a much higher one for modders *wink*)My
[01:44 pm]
Dem0n -- post more
[01:43 pm]
MTiger156 -- KrayZee
KrayZee shouted: Well then. I finally got 20 minerals and it's been forever since I bought a box... then 0. Yay me.
I've only made 200 minerals despite my heavy activity across 2 years :-(
[12:33 pm]
Oh_Man -- "We hold these truths to be self evident. All men are created equal... go get me a sandwich nigger or I'll kill you!" XD
[12:32 pm]
Oh_Man -- <- my point
[12:31 pm]
Oh_Man -- Vrael
Vrael shouted: Oh_Man you kinda missed those minor details about how fundamental rights are baked into democratic systems so you actually have power to change the system (to whatever degree you wanna argue), whereas in other systems your only option is "no u", aka it's not an illusion of choice
Vrael shouted: not really two-party-system specific but it was kinda a big deal when those old guys wrote about "unalienable rights" and that stuff
one party systems have constitutions and human rights clauses too. I don't understand how you can claim they're exclusive to democracies. Have you already forgotten democracies used slaves, didn't let women vote, etc.?
[10:42 am]
martosss -- jjf28 ugh ... that's for enabling a cannon without a pylon? You can do it without having ANY pylons, using burrowed lings to enable doodad state
Please log in to shout.

Members Online: Roy, Dem0n, Clevenaq60