当前位置：首页 > news >正文

YDWE:魔兽争霸3地图编辑器二次开发,给War3地图作者的手艺活装上Lua

news 2026/8/21 19:36:01

YDWE:魔兽争霸3地图编辑器二次开发,给War3地图作者的手艺活装上Lua

【免费下载链接】YDWEA Tool to Help the Creation of Warcraft III Map项目地址: https://gitcode.com/gh_mirrors/yd/YDWE

如果你的魔兽争霸III地图脚本还停在纯JASS时代,那YDWE大概能帮你省不少事:它是基于War3自带WorldEdit二次开发的地图制作工具,自带免CD的编辑环境、Lua 5.4脚本引擎和一套能改到内存底层的"逆天"能力,专门解决老版本WorldEdit功能缺失、脚本调试难、存档系统难做的老问题。

它到底是个什么东西

先说定位:YDWE(Yet Another World Editor)不是另一款编辑器,而是把魔兽原版的WorldEdit"开膛破肚"之后重新组装的版本。你在里面看到的编辑界面还是那个熟悉的WorldEdit,但它背后多了一整套自研的宿主层。

和官方原版编辑器比,差异主要在这几块:

兼容魔兽1.20和1.24两个版本,自带官方免CD的WE,不用自己折腾破解补丁
支持双开,可以同时编辑两张地图,做对照测试很方便
编辑器内部集成了Lua运行时,地图脚本可以写JASS也可以写Lua,而且调试体验完全不一样
带插件体系,像JASS语法着色、触发器增强这类功能都以插件形式提供,不用动核心

简单说,官方WorldEdit管"摆地形、放单位",YDWE额外管住了"脚本怎么写、怎么调、数据怎么存"这一整条链。

拆开看:技术栈和依赖怎么组织

给技术读者看部分。整个源码树分三层,目录结构很直白:

Development/Core/是C++核心,包含主程序YDWE、Lua引擎封装、SLK解析库SlkLib、DuiLib界面库,以及War3进程相关的ydbase/ydwar3两个基础库
Development/Plugin/是可加载插件,分Lua插件(日志、事件、maphash、虚拟MPQ等)和面向WE界面的YDTrigger、YDClient等组件
Development/Component/是运行时的实际载荷:Lua脚本、插件二进制、演示地图和皮肤资源都在这里

依赖的开源组件基本都随仓库带了源码,放在OpenSource/目录下:StormLib和SFmpq负责MPQ归档读写,Detours和minhook是API Hook的基础,还有zlib、minizip、D3D8转D3D9的wow64ext/Direct3D8to9适配层。JASS编译链用的是pjass/wave这一套,编译相关工具在Development/Component/compiler/下。

跑起来的门槛很明确,README里写得很直接:

Visual Studio 2017 with Update 7
Windows 10 SDK 10.0.15063
执行/Build/Build_Release.bat
编译产物在/Build/publish/Release/

构建脚本是标准的MSBuild批处理,Build/Build.bat按Debug/Release配置编译整个解决方案,没有复杂的跨平台构建系统,Windows开发机直接跑就行。

能拿来干嘛

别只把它当编辑器用,仓库里example(演示地图)/目录下按类别分好了十几类现成示例,每个场景都有一张能直接打开的测试地图:

JASS/Lua混合脚本开发:JAPI系列演示了Lua侧改单位属性、技能属性、特效和AI的写法,配套lua脚本就在地图包里,写完能直接调试,不用先背一遍API
触发器系统的极限玩法:"逆天"系列演示了动态注册触发器、触发器休眠与运行、新局部变量、CD中物品锁定这类原版做不到的事,适合研究War3运行时行为
存档与存储系统:有简化版和复杂版两套存档系统演示,还有"网游(服务器存档)"这种接近线上服务的架构示例,做RPG地图的人可以直接抄作业
物体编辑器数据的程序化读写:物体编辑器分类下的五张地图按课程顺序,从Lua模板基础讲到完整的数据生成,等于一套内置教程

另外Component/plugin/w3x2lni/下那套ini+slk+lua的数据管线值得注意,它能把物编数据按版本(1.24.4等)解析成Lua可读的结构,做数据驱动的工具链很省事。

上手第一步

不想先编译的话,最快的路径是拉源码看演示地图和脚本,对照着理解它的能力边界:

git clone https://gitcode.com/gh_mirrors/yd/YDWE

建议先看两处:一是Development/Component/说明.txt,里面有兼容版本、双开、配置入口的说明;二是随便打开一张"逆天"或"系统"类演示地图,看它的脚本结构,比读文档直观。如果你是要编译,准备一台VS2017环境的Windows机器,跑一遍Build_Release.bat就行,产物在Build/publish/Release/。遇到问题,日志在logs/ydwe.log,排查时先翻这个文件。