Duality 2D 游戏开发框架

Duality 是什么

Duality 是一个基于 C# 和 OpenTK 的 2D 游戏开发框架，采用插件化架构，并附带一套可视化编辑器。它把「引擎运行时」和「编辑器」放在同一个解决方案里，开发者可以在图形界面中搭建场景、挂载组件、编辑资源，再用 C# 编写游戏逻辑。

项目使用 MIT 协议开源，在 GitHub 上约有 1.4k Star，官方主页为 https://adamslair.github.io/duality，文档位于 https://adamslair.github.io/duality-docs。

核心特性

• 组件化对象模型：游戏对象由组件组合而成，逻辑与数据分离，便于复用。
• 可视化编辑器：内置场景编辑器、资源管理与属性面板，所见即所得地搭建 2D 场景。
• 插件体系：核心、编辑器、渲染等模块都以插件形式组织，可按需裁剪或扩展。
• 跨平台：基于 OpenTK 与 .NET，可在 Windows、Linux、macOS 上构建运行。
• 示例项目：仓库自带多个示例工程，构建后可直接作为启动项目运行。

从源码构建

在 Windows 上可用 Visual Studio 或 MonoDevelop 打开 Duality.sln，选择「Build Solution」即可。命令行构建前需要先还原依赖：

nuget restore Duality.sln

构建产物统一输出到 Build/Output 目录，示例项目的产物位于各自的 Content/Plugins 子目录。运行示例时，可在 IDE 中将其设为启动项目，或直接使用 DualityEditor / DualityLauncher 作为启动项。

注意：在非 Windows 系统上只能构建核心项目，需要先卸载编辑器相关工程。

项目现状与注意事项

项目作者已明确表示 Duality 处于无限期搁置状态，最新版本稳定可用，但存在以下限制：

1. 包管理器已失效：由于 NuGet API 变更，编辑器内的包管理功能无法工作。如需使用插件，可在 NuGet 上搜索 duality plugin，下载包后手动解压 dll 到 Duality 的 plugins 目录。
2. v4 分支：master 分支上曾开发 v4，相对稳定，可按上述方式构建，但官方没有后续开发计划。

适合谁使用

如果你熟悉 C#/.NET，想找一个轻量、可读性强、带编辑器的 2D 框架来做小项目、教学示例或 Game Jam 原型，Duality 仍然值得一看；但若需要长期维护与活跃社区支持，建议优先考虑 Godot、MonoGame 等仍在持续更新的方案。