MetaCore/README.md

MetaCore

MetaCore 是一个基于 Panda3D 进行二次开发的 Unity-like 编辑器与引擎框架原型。

当前目标

• 以 Panda3D 作为底层引擎与运行时基础
• 以 Dear ImGui Docking 搭建 Unity-like 编辑器工作流
• 使用 GameObject + Component 模型组织编辑器语义层
• 先把 Hierarchy / Scene / Inspector / Project / Console 跑通
• 在不破坏主架构的前提下，以模块化方式持续叠加功能

技术栈

• C++20
• CMake
• vcpkg
• Panda3D 1.10.16
• glm
• Dear ImGui Docking

目录结构

• Source/MetaCoreFoundation：基础服务
• Source/MetaCorePlatform：Panda3D 宿主窗口与输入采集
• Source/MetaCoreScene：场景与对象模型
• Source/MetaCoreRender：Panda3D 场景桥与显示区域驱动
• Source/MetaCoreEditor：编辑器模块与 Unity-like 界面
• Apps/MetaCoreEditor：编辑器程序入口
• Apps/MetaCorePlayer：运行时壳层入口
• tests：基础烟雾测试

构建

前提：

• 已安装 vcpkg
• 已设置环境变量 VCPKG_ROOT
• Windows 环境可联网时，cmake configure 会自动准备 Panda3D 1.10.16 SDK
• 如果已经本地安装 Panda3D，可设置环境变量 PANDA3D_ROOT

cmake --preset vs2022-debug
cmake --build --preset build-debug
ctest --preset test-debug

如果希望生成更适合分发的可执行文件，可使用：

cmake --preset vs2022-release
cmake --build --preset build-release

当前完成内容

• Panda3D 单窗口宿主
• ImGui Docking 编辑器外壳
• Panda3D 中央场景 DisplayRegion
• 网格、坐标轴、立方体绘制
• Hierarchy 选择
• Inspector 中编辑 Transform
• Alt+左键 / 中键 / 滚轮 / F 相机交互
• 模块注册接口与内置编辑器模块