Link Callsites and References

[WaterKnight]

When researching and reading about some API, it is useful to know how it was already used by others, especially by Blizzard in their maps, seeing what arguments they use and the context it was used in.

It would be nice if Jassbot or another easily accessible service could show this information. To realize this, existing maps like the campaign and bonus maps could be mined, later maybe even user maps.

[Luashine]

I've used grep -r to get some results out of Blizzard maps. Had I thought to do this earlier, it'd have saved be probably an hour of working on commandbuttoneffect when I was trying to understand it and needed examples :/

Ah whatever. The 250 MB or so of Jass compressed nicely to 5.5 MB. It's a 7z, but Github is too stupid to allow it.

OfficialMapsJass-j.7z.its_actually_a_7z.zip

Extract war3map.j from all maps in a folder

#!/usr/bin/env bash

# INSTALLATION:
# NEED: MPQEDITOR.exe (Cygwin)

# USAGE:
# ./script.sh "path/to/folder/with/maps.w3m"

set -euo pipefail

MPQEDITOR="./MPQEditor.exe"
MAPSCRIPT='war3map.j'

sleepExit() {
	sleep 5
	exit "$1"
}

if [[ ! -f "$MPQEDITOR" ]]; then
	echo "MPQ EDITOR NOT FOUND!"
	echo "Path 1: '$MPQEDITOR'"
	echo "Path 2: '$(realpath "$MPQEDITOR")'"
	sleepExit 2
fi

folderPath="$1"
test -d "$folderPath"

find "$folderPath" \( -iname "*.w3m" -o -iname "*.w3x" \) -print | 
	while read mapPath; do
		echo "Map is: '$mapPath'" >&2
		extractDir="${mapPath}-out/" 
		mkdir -- "$extractDir" || true # dunno why it fails on a handful of maps
		"$MPQEDITOR" extract "$mapPath" "$MAPSCRIPT" "$extractDir" &
		
		#test -f "$extractDir/$MAPSCRIPT"
		#unset extractDir
	done

Map sources:

1. Reforged CASC: Classic/Reforged Campaigns + Melee. I think Classic and Reforged maps are really separate?
2. https://www.hiveworkshop.com/threads/1-33-campaign-preservation-project.340191/ Kam's rolled back improvements
3. Old Classic versions from MPQ if you insist on having them separately. Remember to put base and patch MPQs in the correct order in MPQEditor (right click to move up/down)