WebGL 模型查看器:支持魔兽争霸与星际争霸模型预览
快速上手
获取项目代码
git clone https://gitcode.com/gh_mirrors/md/mdx-m3-viewer
启动服务
npm install # 安装项目依赖
npm run serve # 启动本地服务器
启动成功后,打开浏览器访问 http://localhost:8080/clients/example/ 即可看到演示界面。
核心功能
多格式全面兼容
- MDX 文件:魔兽争霸 3 标准模型格式,支持完整的动画系统和材质效果
- M3 文件:星际争霸 2 专用模型格式,兼容复杂的粒子特效系统
- 纹理支持:BLP1、TGA 等主流游戏纹理格式
- 地图文件:W3M/W3X 格式地图完整解析
实时 3D 渲染引擎
基于 WebGL 技术构建的高性能渲染引擎,提供流畅的模型展示效果。你可以自由操控模型视角,全方位观察每个细节。
专业级实用工具
项目内置多个专业客户端,满足不同使用需求:
- 模型优化器:位于
clients/mdlxoptimizer/,有效提升模型加载和渲染性能 - 地图编辑器:完整支持 W3X 地图文件解析和编辑功能
- 纹理图集管理:高效处理游戏纹理资源,支持批量格式转换
技术架构
模块化设计理念
核心代码位于 src/viewer/ 目录,采用高度模块化的架构设计。这种设计让开发者能够轻松扩展功能或集成到其他项目中。
渲染管线优化
通过精心设计的渲染管线,确保在各种设备上都能获得流畅的模型展示体验。
应用场景
游戏开发者工作流
游戏开发者可以快速预览模型效果,检查材质和纹理应用是否正确,大幅提升开发效率。
地图制作辅助工具
地图制作者可以直观查看模型在地图中的实际表现,确保模型导入和配置的准确性。
学习研究助手
对于想要深入了解 3D 模型文件结构和游戏图形技术的学习者,这是一个绝佳的学习工具。
开发环境
项目为开发者提供完整的开发环境配置:
- VSCode 工作区:
Viewer.code-workspace - Sublime Text 项目:
Viewer.sublime-project
类型系统完善
完整的 TypeScript 类型定义和编译配置,确保代码质量和开发体验。
总结
这款开源工具为魔兽争霸 3 和星际争霸 2 的模型文件提供了完美的 WebGL 查看解决方案。无论是技术新手还是资深开发者,都能通过这款工具获得简单易用又功能丰富的模型查看体验。

