Warcraft III Map Tools

io.github.GodMephistov0.1.3更新于 Oct 3, 2026

Read, audit and edit Warcraft III maps byte-faithfully

已验证STDIO仅桌面Developer Tools Files & Storage Media & Design

概览

AI 生成的概览

读取、审计并逐字节保真地编辑《魔兽争霸 III》的 .w3x 和 .w3m 地图，包括地形、物体、单位和内部文件。

功能: 这是一个本地 stdio MCP 服务器，提供 49 个用于《魔兽争霸 III》地图处理的工具。只读工具涵盖地图元数据、压缩包内文件列表、脚本句柄泄漏、单位技能配置、物体数据、地形统计、声音、镜头、玩家、势力以及 .w3g 录像摘要。写入工具可编辑物体、地形、寻路、装饰物、单位、物品、区域、起始点、声音、镜头和场景字段，并保存到单独的 out_path。它还能把物体模型渲染为 PNG、在地图之间移植单位，以及从加密地图中恢复文件名。
适用场景: 当助手需要检查或修改《魔兽争霸 III》地图时使用：审计物体数据和提示文本、查找脚本泄漏、分析单位技能、编辑地形或放置物，或在地图之间移植单位。适合在 Windows 上工作、希望以脚本化可重复方式编辑而非手动使用世界编辑器的地图作者和模组制作者。
运行要求: 仅支持 64 位 Windows；随附的 CascLib 游戏数据读取库是 Windows 库。发布包自带 .NET 运行时，无需另外安装。读取基础游戏数据的工具需要安装《魔兽争霸 III：重制版》；地图工具无需该游戏。游戏目录会自动检测，也可通过 WC3_GAME_DIR 环境变量或工具的 game_dir 参数指定。无需账号或 API 密钥。

安装前请注意

许多工具会写入地图，但写入工具要求 out_path 与输入地图不同，因此原始地图不会被覆盖。安装过程会运行 PowerShell 脚本，下载发布包、校验其 SHA-256、解压并修改 AI 应用的设置文件，修改前会先备份；含注释的文件不会被改写。该服务器读取本地地图和游戏文件，并将其内容发送给所连接的 AI 应用。

安装

在 SourceWeft 中

打开控制台中的 Warcraft III Map Tools，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照仓库中的启动说明。

README

wc3-mcp

Made by GodMephisto

[CI]

An MCP server that lets AI assistants such as Claude read, audit and edit Warcraft III .w3x and .w3m maps byte-faithfully (files you do not touch keep their bytes).

What you need

64-bit Windows. The game data reader (CascLib) is a Windows library.
Warcraft III Reforged, only for the tools that read base game data. Map tools work without it.
Any AI app that speaks MCP. Nothing else, the release carries its own .NET.

Install

Open PowerShell and run

That downloads the latest release, checks its SHA-256, unpacks it into %LOCALAPPDATA%\Programs\wc3-mcp, adds that folder to your PATH and sets up every supported AI app it finds. No admin rights. Run the same line again to update. Restart your AI app afterwards.

Prefer to do it by hand? Download the zip from the Releases page, unzip it into any folder you like, then from that folder run

The setup records wherever the exe actually is, so any folder works. It also adds that folder to your user PATH once, so from then on plain wc3-mcp works in any new terminal. Pass --no-path to skip that, and use .\wc3-mcp.exe from its folder instead.

Using Claude Desktop only? Download wc3-mcp-<version>-win-x64.mcpb from the Releases page and double-click it. Claude Desktop installs it as an extension. Its one setting, the Warcraft III folder, can stay empty to have the install detected. The server is also listed in the MCP Registry as io.github.GodMephisto/wc3-mcp, for apps that install from there.

Set up your AI app

These need wc3-mcp on your PATH, which the one-line install and the first wc3-mcp.exe install both arrange. Until then, run them as .\wc3-mcp.exe ... from the folder the exe is in.

wc3-mcp install --all            set up every supported app found on this PCwc3-mcp install cursor vscode    set up only the apps namedwc3-mcp uninstall --all          remove it againwc3-mcp config <app>             print the settings to paste by handwc3-mcp clients                  list supported apps and whether each is set upwc3-mcp doctor                   check the install, the game folder and the apps

wc3-mcp install --all            set up every supported app found on this PCwc3-mcp install cursor vscode    set up only the apps namedwc3-mcp uninstall --all          remove it againwc3-mcp config <app>             print the settings to paste by handwc3-mcp clients                  list supported apps and whether each is set upwc3-mcp doctor                   check the install, the game folder and the apps

App	Name to use	Where it is written
Claude Code	`claude-code`	through `claude mcp add --scope user`
Claude Desktop	`claude-desktop`	`%APPDATA%\Claude\claude_desktop_config.json` (Store build too)
Cursor	`cursor`	`%USERPROFILE%\.cursor\mcp.json`
VS Code (GitHub Copilot)	`vscode`	`%APPDATA%\Code\User\mcp.json`
Windsurf	`windsurf`	`%USERPROFILE%\.codeium\windsurf\mcp_config.json` or `%APPDATA%\devin\mcp_config.json`
Gemini CLI	`gemini`	`%USERPROFILE%\.gemini\settings.json`
Codex CLI	`codex`	`%CODEX_HOME%` or `%USERPROFILE%\.codex\config.toml`
Cline	`cline`	`cline_mcp_settings.json` in VS Code's storage for Cline
LM Studio	`lmstudio`	`%USERPROFILE%\.lmstudio\mcp.json`
Zed	`zed`	`%APPDATA%\Zed\settings.json`

Setup only changes the one wc3 entry. Every other server and setting in the file stays as it was, and the file is copied to NAME.wc3-mcp.bak first. A file with comments in it (common in Zed and VS Code) is never rewritten, because that would delete the comments. The settings to paste are printed instead.

Any other MCP app

It is a standard stdio MCP server. Point your app at wc3-mcp.exe with no arguments. wc3-mcp config cursor prints a ready-made JSON entry with the real path filled in, which most apps accept as is.

Configuration

The Warcraft III folder is found automatically from the Windows registry, then C:\Warcraft III, C:\Program Files (x86)\Warcraft III and C:\Program Files\Warcraft III. When yours is somewhere else, either

install with wc3-mcp install --all --game-dir "D:\Games\Warcraft III", which sets WC3_GAME_DIR in each app's entry, or
pass game_dir to a single tool call.

A game_dir argument wins over WC3_GAME_DIR, which wins over the automatic search. wc3-mcp doctor shows which folder it is using.

Build from source

In PowerShell, with the .NET 8 SDK installed,

powershell

git clone https://github.com/GodMephisto/wc3-mcpcd wc3-mcpdotnet test --filter "Category!=Corpus&Category!=GameData"dotnet publish src/Wc3.Mcp/Wc3.Mcp.csproj -c Release --self-contained -r win-x64 -o dist-mcp.\dist-mcp\wc3-mcp.exe install --all

git clone https://github.com/GodMephisto/wc3-mcpcd wc3-mcpdotnet test --filter "Category!=Corpus&Category!=GameData"dotnet publish src/Wc3.Mcp/Wc3.Mcp.csproj -c Release --self-contained -r win-x64 -o dist-mcp.\dist-mcp\wc3-mcp.exe install --all

The apps then start the exe inside your clone's dist-mcp folder, and that folder is what goes on your PATH, so keep the clone where it is or rerun the last line after moving it.

Exact SDK and package versions are in REQUIREMENTS.md. CascLib.dll must stay beside wc3-mcp.exe.

Tools

49 tools across these categories:

Name	Read/Write	Description
map_info	read-only	Map metadata including name, author, player count, playable dimensions and load diagnostics.
list_files	read-only	List the map archive internal files with name, size in bytes and parsed format flags.
script_leaks	read-only	Handle leaks in war3map.j including locations, groups, forces, timers and triggers ranked by frequency.
uabi_profile	read-only	Unit ability profiles across maps including unit types, references, ids and per-race breakdown.
replay_summary	read-only	Read `.w3g` replay files with map, length, players and disconnect events.
object_list	read-only	List custom or modified objects with rawcode, base rawcode and resolved name.
object_get	read-only	Merged object fields (base overlaid by map deltas) with names resolved.
unit_abilities	read-only	Every ability a unit has and where it comes from. Unit data, spellbook contents, a placed unit's own abilities and levels, morph forms, and abilities the script hands out (inferred, with the war3map.j line).
object_set	writes	Set a field on an object and save to out_path.
object_new	writes	Create a new custom object derived from a base rawcode, save to out_path.
bundle_unit	read-only	Unit dependency closure including objects, asset files, strings, edges and JASS.
render_model	writes	Render an object model (`.mdx` or `.mdl`) to PNG at out_path.
port_unit	writes	Port a unit from a source map into a target map, auto-remapping collisions.
palette_doodad	read-only	List placeable doodad types, the palette for place_doodad.
place_doodad	writes	Place a doodad instance at (x, y) on the doodad layer.
place_region	writes	Define a rectangular region on the region layer.
place_unit	writes	Place a unit at world (x, y) owned by a player.
place_start_location	writes	Place or move a player start location at (x, y).
place_item	writes	Place a preplaced item at world (x, y).
terrain_stats	read-only	Terrain summary with tile count, min or max height, and cliff level.
terrain_deform	writes	Raise, lower, set, flatten or smooth ground height.
terrain_cliff	writes	Raise, lower or set cliff (stepped-terrain) level.
terrain_ramp	writes	Toggle the ramp (sloped cliff) flag.
terrain_paint	writes	Paint ground texture over a brush.
terrain_water	writes	Set, raise, lower or remove water.
terrain_blight	writes	Set or clear the blight flag.
deprotect_map	read-only	Recover file names from protected maps.
file_list	read-only	List archive entries with their current size.
file_get_text	read-only	Read an internal file decoded as UTF-8.
file_set	writes	Replace an internal file from a disk file.
audit_map	read-only	Behavioural audit of object data including tooltips, requirements and dangling references.
sound_list	read-only	List the map sound catalog with name, file, channel, volume, pitch and distance.
sound_add	writes	Add a new sound definition.
sound_set	writes	Set a field on a sound definition.
sound_remove	writes	Remove a sound definition.
camera_list	read-only	List cameras with name, target, rotation, angle of attack and field of view.
camera_add	writes	Add a camera at a target position.
camera_set	writes	Set a field on a camera.
camera_remove	writes	Remove a camera.
pathing_paint	writes	Paint pathing bits (Walk, Fly, Build, Blight, Water) over a brush.
map_info_get	read-only	Read editable scenario fields (name, author, fog, etc.).
map_info_set	writes	Set a scenario field.
player_list	read-only	List player slots with name, color, race, controller and start position.
player_set_force	writes	Move a player into a force (team).
force_list	read-only	List forces and teams with name, members, alliance and sharing flags.
force_set_flags	writes	Set force alliance or sharing flags.
new_map	writes	Create a blank World Editor openable map.
trigger_catalog_list	read-only	List GUI-trigger functions from the World Editor catalog.
trigger_catalog_describe	read-only	Show detail for one GUI-trigger function by name.

Safety

Writing tools require out_path to differ from the input map. The original is never overwritten.

Limits

Windows x64 only (native CascLib). Tools that query base-game data need a Warcraft III Reforged install.

Troubleshooting

Start with wc3-mcp doctor. It shows where the exe is, whether CascLib.dll is beside it, which Warcraft III folder it uses and which apps are set up.
Game not found. Run wc3-mcp install --all --game-dir "<your Warcraft III folder>", or pass game_dir to the tool.
An app does not list the tools. Restart it fully. Claude Desktop needs a quit from the tray, not just closing the window.
A settings file was not changed. It has comments or is not valid JSON, so the settings to paste were printed instead. wc3-mcp config <app> prints them again.
Protected maps. Pass listfiles to deprotect_map to supply community name lists.

Credits

Built on

Library	Author
War3Net (War3Net.Build, War3Net.IO.Mpq, War3Net.Drawing.Blp)	Drake53 and contributors
CascLib	Ladislav Zezula
CascLib.NET	Kizari
ImageSharp	Six Labors and contributors
MCP C# SDK (ModelContextProtocol)	Model Context Protocol project
Microsoft.Extensions.Hosting	Microsoft, .NET Foundation

Used directly: Luashine/jass-history (inventory change study), pjass (JASS syntax checking), devoltz and Arakunido (SLK repair guide), and the Hive Workshop community (command line arguments).

Learned from, among many others, HiveWE (stijnherfst), Warsmash and Retera's Model Studio (Retera), WC3MapTranslator (ChiefOfGxBxL), Wurst, TheHelper and the Hive Workshop. The full list of every project and community studied, 197 in all, is in CREDITS.md.

Warcraft III is made by Blizzard Entertainment. This project is unofficial, is not affiliated with or endorsed by Blizzard, reads your own install and ships no game files.

来源：README.md，提交 9f9b64e

工具

工具元数据尚未被收录。

版本历史

v0.1.3最新Oct 3, 2026