本页目录

HTML5 回合制战棋《装甲元帅2》重制（Open Panzer）

openpanzer · nicupavel/openpanzer

Open Panzer 是用 JavaScript/HTML5 重写的《装甲元帅2》（Panzer General 2）回合制策略游戏，直接在浏览器中运行。据 README，项目遵循 W3C HTML5/CSS3 规范，代码保持 ECMAScript 5 基础特性，可在较新版本的 Chrome、Firefox、Safari...

策略自研引擎 JavaScript 敌人 AI 存档系统关卡管理游戏状态管理高级

★ Stars 190 Forks 51 License 未明确更新 2026-11-07

GitHub 官方仓库在线 Demo Releases

国内开发环境适配

Windows

未知

Linux

官方声明支持

macOS

未知

引擎 / 框架：自研引擎暂无中文教程标记未标记站长实测

项目无 npm 依赖与构建流程，直接打开 index.html 即可；本地以文件方式加载资源时 Chrome 需加 --allow-file-access-from-files 参数。README 未提及国内网络或镜像相关问题，待核验。

中文项目介绍

Open Panzer 是开发者 Nicu Pavel 发起的一个开源项目，目标是用 JavaScript 与 HTML5 技术重写经典回合制策略游戏《装甲元帅2》（Panzer General 2）。根据 README 的描述，它并非简单的移植，而是围绕原版游戏的数据规格重新构建的一套浏览器端实现：单位、地图、战役等资源沿用原版体系，游戏逻辑与界面则用 Web 技术重新编写。

项目遵循 W3C 的 HTML5 与 CSS3 规范，尽量把浏览器特定的写法降到最低，README 中甚至以「null」来形容这类特殊处理的数量。JavaScript 层面以 V8 开源引擎为基础，代码保持在 ECMAScript 5 的基本特性范围内，因此对运行环境的要求相对宽松。源码以 GNU 通用公共许可证（GPL）第 2 版或更高版本发布，作者同时声明，向项目贡献代码或内容即表示同意以 GPL 或维护者未来选择的其他开源许可证分发。

补充说明

浏览器与平台支持

README 明确列出了项目验证过的运行环境：

桌面端：较新版本的 Google Chrome、Mozilla Firefox、Safari 与 Opera。
移动端：Android（作者在 2.2、2.3、4.x 版本上测试过）以及 iOS 5.0 及以上设备。
Internet Explorer：README 认为 IE 11 或许可以运行，但为 IE 做大量代码改动并不是项目的优先事项。

需要说明的是，这些是 README 中作者自述的测试范围，并不代表当前所有浏览器版本都经过验证。由于项目坚持使用基础 ECMAScript 5 特性且不依赖额外库，理论上现代浏览器仍具备运行条件，但实际兼容性建议自行在本地确认。

源码结构说明

README 用一棵目录树详细描述了代码组织方式，可以归纳为几个层次：

css/：界面样式表，按用途拆分为字体、战斗信息动画、装备窗口、消息窗口、开始菜单、单位信息对话框以及主样式 ui.css。
js/：游戏核心逻辑，包括 AI 引擎（ai.js）、精灵动画（animation.js）、DOM 工具（dom.js）、游戏管理器（game.js）、攻击/移动/补给/增援/距离等规则（gamerules.js）、基于 HTML5 本地存储的存档（gamestate.js）、六边形地图与玩家对象（map.js）、从 XML 加载剧本与地图（maploader.js）、Canvas 渲染（render.js）、音效（sound.js）、单位与运输对象（unit.js）以及鼠标交互与界面构建（ui.js）。
resources/：游戏资源，涵盖动画精灵图、战役、装备属性、字体、地图背景大图、剧本、音效，以及按钮、光标、对话框、旗帜、指示器、菜单、启动画面等 UI 素材，还有每个单位 1×9 的方向精灵图。
tools/：资源转换脚本，用于把 PG2 的 .cam 战役格式、PG2Suite 导出的装备数据、SHPTool 导出的位图，以及 SCN/MAP/TXT 地图文件转换为项目使用的格式。
index.html：承载游戏基本 DOM 结构的入口页面。

从这份结构可以看出，项目把「规则逻辑」「渲染」「界面」「资源转换」做了较清晰的分离，对想学习如何用原生 Web 技术组织一个完整游戏的人来说，是一个可读性较好的样本。

开发约定

README 的「Development notes」一节给出了几条明确的工程约束：

不引入任何额外的 JavaScript 库（如 jQuery、Node 等），并应长期保持这一状态。
DOM 元素的样式应写在对应的 CSS 文件中，不应在代码里为静态元素添加样式。
DOM 元素的所有定位都应在 CSS 文件中完成；简而言之，能用 CSS 解决的事情就不要写进 JavaScript。
新增代码应遵循项目已有的编码风格（例如对象创建方式）。
主要测试工作在 Linux 下的 Chrome 与 Firefox 上完成。
在本地用 Chrome 运行代码时，启动浏览器需要加上 --allow-file-access-from-files 选项。

这些约定反映出作者对「无依赖、样式与逻辑分离」的坚持，也解释了为什么项目能在多年间保持较简单的技术栈。

图形资源与数据来源

README 说明了项目素材的来源与授权背景：

单位图像取自 OpenGeneral Icons 项目。
游戏围绕原版游戏的规格说明构建，该规格由 Luis Guzman 整理发布。
单位装备数据从 PG2Suite 导出后，再转换为 JSON 格式供游戏使用。

这意味着 Open Panzer 的「重制」更多体现在引擎与交互层，美术与数值数据则大量复用社区已有的开放资源。使用或二次分发时，需要同时留意 GPL 许可证以及这些素材来源各自的授权条件。

如何运行与学习建议

README 没有提供 npm 安装或打包流程，项目本身也不依赖构建工具。按照其说明，最直接的方式是通过 index.html 在浏览器中打开；若在本地以文件方式加载资源，Chrome 需要加上前述的 --allow-file-access-from-files 参数，否则可能因跨文件访问限制而无法读取地图与资源。

对于学习者，建议按以下顺序阅读源码：先看 index.html 与 ui.css 了解页面骨架，再进入 game.js 把握主循环与状态流转，随后结合 map.js、unit.js、gamerules.js 理解六边形战棋的核心规则，最后研究 ai.js 与 render.js。tools/ 下的转换脚本则适合想了解如何把旧格式数据接入 Web 项目的读者。