百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
O

open-realm

> 编程语言
开源

这是一个基于 C 语言的 Warcraft III 游戏引擎的开源重新实现,可直接从 War3.mpq (v1.0–v1.29b) 加载和渲染原始游戏资源,目标平台为

200 stars0 点赞1 次浏览
访问官网GitHub

工具介绍

这是一个基于 C 语言的 Warcraft III 游戏引擎的开源重新实现,可直接从 War3.mpq (v1.0–v1.29b) 加载和渲染原始游戏资源,目标平台为

OpenWarcraft3

OpenWarcraft3 is an open-source, Quake-style engine and compatibility project for Blizzard-era game data. Warcraft III is the primary playable target; StarCraft II and World of Warcraft provide additional format and renderer targets.

The project does not include retail game data. Use it only with data you legally own. OpenWarcraft3 is not affiliated with Blizzard Entertainment.

Current targets

  • Warcraft III — openwarcraft3, the main development target, including the client/server runtime, JASS, SLK/profile data, FDF UI, campaign flow, maps, fog, units, and networking.
  • World of Warcraft — openwow, an exploratory M2/WMO/DBC/MPQ and UI target with a Lua-backed interface.
  • StarCraft II — opensc2, an exploratory M3/SC2Map/SC2Layout target.

The shared runtime contains the client, server, renderer backend, networking, archive loading, console/cvars, sound, and math libraries. Game-specific code lives under games// and is connected through Quake 2-style import/export tables.

Download

Pre-built binaries and Flatpak bundles are available from the latest release. CI artifacts are published by the CI workflow. Neither releases nor CI artifacts contain retail assets.

For Flatpak and Steam Deck packaging, see Flatpak And Steam Deck Packaging.

Build

The native build requires a C compiler, make, SDL2, and system OpenGL (or GLES3 on supported Linux systems). MPQ loading and most format tooling are provided by vendored or in-tree code.

macOS:

bash
brew install sdl2

Ubuntu/Debian:

bash
sudo apt-get install build-essential libsdl2-dev

Windows builds use MSYS2/MinGW or Visual Studio with SDL2 development libraries.

bash
git clone https://github.com/corepunch/open-realm.git
cd open-realm
make build

Useful targets:

bash
make openwarcraft3       # Warcraft III executable
make openwow             # World of Warcraft executable
make opensc2             # StarCraft II executable
make tools               # Asset/archive diagnostic tools
make test                # Generate fixtures and run tests
make test-ui             # Warcraft III UI parser/layout tests

The default build is diagnostic. Select release mode and renderer settings with:

bash
make clean && make BUILD=release openwarcraft3
make clean && make BUILD=release GL_BACKEND=gles3 MSAA=0 openwarcraft3

Supported settings are BUILD=debug|release, GL_BACKEND=gl|gles3, MSAA=0|2|4|8, and GLSL=120|140|150. Run make clean when changing these values. See Build And Renderer Platforms.

Run with game data

Point the executable at a Warcraft III installation containing its MPQ archives:

bash
build/bin/openwarcraft3 -data "/path/to/Warcraft III"

The directory is scanned for top-level MPQs and an optional loose Maps/ directory. The Makefile also supports WC3DATA:

bash
WC3DATA="/path/to/Warcraft III" make run

Useful examples:

bash
build/bin/openwarcraft3 -data "/path/to/Warcraft III" +menu_main
build/bin/openwarcraft3 -data "/path/to/Warcraft III" +map 'Maps/Campaign/Orc01.w3m'
build/bin/openwarcraft3 -data "/path/to/Warcraft III" -vid_modes +com_frame_limit 10

Open the in-game Quake-style console with backtick/tilde. Use build/bin/mpqtool to inspect archives:

bash
build/bin/mpqtool -mpq "/path/to/Warcraft III/War3.mpq" ls Maps/Campaign

Tests and diagnostics

make test generates deterministic fixture archives under build/tests/ and runs engine, parser, persistence, and format tests. For Warcraft III UI changes, run make test-ui. Useful tools include mdxtool, maptool, m2tool, mpqtool, blp2jpg, blpgen, and mdxgen. Bounded runtime diagnostics use +com_frame_limit N.

Documentation

  • Architecture — module boundaries and API contracts
  • Runtime configuration — paths, cvars, and startup order
  • Rendering scene workflow — launching maps and model scenes
  • UI authoring — FDF, bindings, and UI tests
  • WC3 gameplay documentation
  • Diagnostic tools
  • Contributing

License

This project is licensed under the MIT License.

Issues· 13 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

C

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月18日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言