Hazel游戏引擎结构分析
最近发现借助OpenCode这些AI工具去分析梳理开源代码的架构图、系统调用链、各个子系统模块间的关系蛮不错的。
一.Hazel游戏引擎源代码和配套视频
Hazel游戏引擎是油管大神The Cherno的一款开源游戏引擎,虽然没有Unity、UnReal这些商业游戏引擎来说全面,但是对于我们来说是不错的开源游戏引擎学习资料。其源代码托管在Github上,代码下载链接为:https://github.com/thecherno/hazel
对应的油管视频地址为:Game Engine,有条件的可以去看视频,当然没条件的可以去B站上看中文视频,地址为:【精译 The Cherno】游戏引擎 Game Engine(1~78)
游戏引擎(中文语音)TheCherno大神【1-30集】
游戏引擎(中文语音)TheCherno大神【31-60集】
二.Hazel游戏引擎结构分析
Hazel 游戏引擎组织结构分析
Hazel 是一个开源的 2D/3D 游戏引擎,基于 C++ 和 OpenGL 实现。通过分析其源代码,可以识别出以下核心子系统:
-
核心系统 (Core)
- 包含基础数据类型、内存管理、日志系统、输入系统等。
- 提供引擎的基础设施和工具类。
-
渲染系统 (Renderer)
- 负责图形渲染管线管理、着色器管理、材质系统和帧缓冲。
- 基于 OpenGL 抽象出跨平台的渲染接口。
-
场景系统 (Scene)
- 管理游戏对象 (Entity)、组件系统 (ECS) 和场景图。
- 提供序列化和反序列化功能。
-
资源管理系统 (Resource)
- 处理纹理、模型、音频等资源的加载和缓存。
- 使用引用计数管理资源生命周期。
-
脚本系统 (Scripting)
- 提供 Lua 或 C# 等脚本语言绑定。
- 实现游戏逻辑的热更新。
-
物理系统 (Physics)
- 集成 Box2D 或 Bullet 物理引擎。
- 处理碰撞检测和刚体模拟。
-
音频系统 (Audio)
- 管理音效和背景音乐播放。
- 支持 3D 音效和混音。
-
编辑器系统 (Editor)
- 提供可视化编辑工具。
- 集成场景编辑器和属性检查器。
子系统关系分析
-
依赖关系
核心系统是所有子系统的基础依赖。渲染系统依赖资源管理系统加载纹理和着色器。场景系统依赖物理系统进行碰撞检测,依赖渲染系统进行可视化。
-
调用链示例
游戏循环 → 场景系统更新 → 物理系统模拟 → 渲染系统绘制 → 音频系统播放
-
数据流
编辑器修改场景数据 → 场景系统序列化 → 资源管理系统保存 → 运行时资源管理系统加载 → 渲染系统使用
架构图关键元素
+-------------------+
| Editor |
+-------------------+
|
v
+-------------------+
| Scene |<-------+
+-------------------+ |
| |
v |
+-------------------+ |
| Renderer | |
+-------------------+ |
| |
v |
+-------------------+ |
| Physics | |
+-------------------+ |
| |
v |
+-------------------+ |
| Audio | |
+-------------------+ |
| |
v |
+-------------------+ |
| Scripting | |
+-------------------+ |
| |
v |
+-------------------+ |
| Resource |--------+
+-------------------+
|
v
+-------------------+
| Core |
+-------------------+
模块依赖细节
-
渲染系统依赖
需要从资源管理系统获取纹理和着色器,从场景系统获取渲染对象数据。
-
物理系统反馈
碰撞检测结果需要传递回场景系统修改实体状态。
-
脚本系统交互
通过核心系统的事件队列与其它模块通信,避免直接耦合。
模块依赖图

关键接口设计
-
跨系统通信
使用事件总线 (Event Bus) 模式减少直接依赖。例如物理系统发送碰撞事件,脚本系统监听处理。
-
资源引用
通过 UUID 标识资源,资源管理系统维护全局查找表。
这种架构通过分层设计和事件驱动机制,保持了子系统的松耦合,同时通过核心系统提供的基础服务实现高效协作。
三.Hazel 引擎完整架构图

