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



Hi,

I have used this open source project for Warcraft 3 files (.w3x): https://github.com/ladislav-zezula/StormLib

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: https://github.com/sethmachine/pyw3x) using an external DLL. Can someone point me to what I need to look at to get started?

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

# create new triggers or whatever
new_trigs = create_new_trigs()

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




None.

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.




Options
  Back to forum
Please log in to reply to this topic or to report it.
Members in this topic: None.
[03:29 am]
DarkenedFantasies -- Probably just didn't care. For example, at some point before release, they've updated the graphics of some of the Protoss buildings (Forge, CyberCore, Citadel, Observatory, Arbiter Tribunal), but instead of properly re-rendering them with edited 3D models, they did crappy copy-paste jobs on the rendered graphics.
[08:35 pm]
Ultraviolet -- :wob:
[2026-6-21. : 11:38 pm]
Symmetry -- :wob:
[2026-6-21. : 4:56 am]
Ultraviolet -- I suppose we'll likely never know, but my guess would be that they already saw it operating successfully and there was no monetary incentive to finish the original work. And the dev cycle in old school Blizzard was so hectic, it's possible it just got forgotten about after the original game got released. Plus there's an element of existing MPQ files that were packaged with the original discs becoming outdated if they updated it. And it's not like they remade the original MPQs, they just made new ones for BW specifically
[2026-6-21. : 4:26 am]
Oh_Man -- so that makes me think maybe the theory they are unfinished is not true and its a deliberate design decision, coz why not finish them wen ur making brood war?
[2026-6-21. : 4:25 am]
Oh_Man -- the thing is thos buildings are from classic. that means they went ahead and made brood war without ever finishing the 'unfinished' buildings
[2026-6-20. : 6:15 pm]
Ultraviolet -- Yeah he's talked about a lot of that stuff in his casts before. It seems plausible. Especially knowing how Blizzard of yesteryear operated.
[2026-6-20. : 3:47 pm]
NudeRaider -- to clarify: couldn't recall the behavior for every single Protoss building but I was aware the disparity exists.
[2026-6-20. : 3:43 pm]
NudeRaider -- Contained nothing new for me. Didn't know all building's behavior, but very much all unit's. Also Terran balance whine - also nothing new :lol:
[2026-6-19. : 9:57 am]
Oh_Man -- makes me wonder if SEN knows anything about the topic
Please log in to shout.


Members Online: jy2413804