w3xdata

w3xdata allows for extracting Warcraft 3 map data in a typed, semi-structured way.

Examples

import {
  mapItemSpecs,
  mapStrings,
  mapUnitSpecs,
  replaceStrings,
} from "w3xdata";
import { promises as fs } from "fs";

Promise.all([
  fs.readFile("map/war3map.w3u"),
  fs.readFile("map/war3map.w3t"),
  fs.readFile("map/war3map.wts"),
]).then(([w3u, w3t, wts]) => {
  const strings = mapStrings(wts);
  const units = replaceStrings(mapUnitSpecs(w3u), strings);
  const items = replaceStrings(mapItemSpecs(w3t), strings);

  console.log(units.hfoo.text?.Name); // "Footman"
  console.log(units.h001.text?.Name); // "Custom Footman"
  console.log(items.ratf.text?.Name); // "Claws of Attack +15"
});

Reforged skin files

Reforged maps split cosmetic overrides (names, tooltips, icons) into war3mapSkin.w3u / war3mapSkin.w3t. Pass them as the optional second arg and the modifications are applied on top of the main file:

const units = mapUnitSpecs(w3u, w3uSkin);
const items = mapItemSpecs(w3t, w3tSkin);