minigame-std：微信小游戏与浏览器跨平台标准库 · C# 开源游戏

国内开发环境适配

Windows

官方声明支持

Linux

官方声明支持

macOS

未知

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

从源码构建需使用 NuGet 还原依赖，国内网络可能较慢，建议配置镜像源；包管理器因 NuGet API 变更已不可用，需手动下载插件包。

中文项目介绍

Duality 是一个基于 C# 与 OpenTK 构建的插件式 2D 游戏开发框架。它并非一个完整的游戏引擎，而是一套为 2D 游戏开发提供底层支持与编辑器扩展能力的框架。项目采用插件化架构，开发者可以通过组合不同的插件来扩展功能，从而适应不同项目的需求。官方提供了项目主页与文档站，方便开发者快速了解框架能力与使用方法。

Duality 的代码仓库标签中包含 portable，表明其设计上考虑了可移植性。框架本身使用 C# 编写，并依赖 OpenTK 进行图形渲染，因此其运行环境需要支持 .NET 与 OpenGL。

核心功能

插件式架构

Duality 的核心设计围绕插件展开，框架功能、编辑器扩展、甚至项目资源都可以通过插件形式组织。这种设计使得框架具备较高的可扩展性，开发者可以根据需要引入或开发插件。

基于 C# 与 OpenTK

框架使用 C# 作为主要开发语言，并基于 OpenTK 封装 OpenGL 调用，为 2D 渲染提供支持。对于熟悉 .NET 生态的开发者来说，技术栈较为友好。

编辑器与运行时分离

仓库中包含 `DualityEditor` 与 `DualityLauncher` 等启动项目，分别对应编辑器与游戏启动器，便于在开发过程中进行场景编辑与运行测试。

包管理支持

已有项目可以通过 Package Manager 更新框架版本或插件，简化依赖管理流程。

技术架构分析

构建与运行

根据 README 说明，从源码构建 Duality 的步骤如下：

使用 Visual Studio 或 MonoDevelop 打开 Duality.sln 解决方案文件。
选择“Build Solution”进行构建。
在非 Windows 系统上，只能构建核心项目，需要先卸载编辑器相关项目。
从命令行构建时，需先执行 nuget restore Duality.sln 以还原所需包。

构建完成后，框架的输出文件位于共享的 Build/Output 文件夹中。示例项目的构建结果则位于各自 Content/Plugins 子目录下。要运行示例项目，可在 IDE 中将其设为启动项目，或使用 DualityEditor / DualityLauncher 作为启动项目。

最新二进制版本可从 Releases 页面下载（v3.0），已有项目可通过 Package Manager 更新框架或插件。

补充说明

项目状态与注意事项

README 中明确标注项目状态为“无限期搁置——可能永久搁置”。最新版本稳定可用，但存在以下注意事项：

包管理器不可用：由于 NuGet API 变更，包管理器已无法正常工作。如需使用可用插件，可在 NuGet 上搜索 Duality 插件，下载包后解压 dll 到 Duality 的插件文件夹中。
v4 版本：master 分支上正在开发 v4 版本，据描述应较为稳定，可按上述构建方式自行构建。但未来没有进一步的工作计划。

项目维护者包括 SirePi、Barsonax 以及创建者 Ilexp（现已不活跃，但仍会提供建议）。

社区与支持

Duality 拥有 GitHub Discussions 讨论区与 Discord 聊天频道，适合提问、交流与反馈。对于不需要进一步讨论的 bug 与功能请求，建议直接提交到 GitHub Issue 追踪系统。

学习建议

Duality 适合对 C# 与 2D 游戏开发有一定了解、并希望研究插件式框架设计的开发者。由于项目已搁置，且包管理器不可用，新手入门可能需要更多手动配置。建议先阅读官方文档站，了解框架的基本概念与插件机制，再尝试构建并运行示例项目。对于希望学习 2D 渲染、编辑器扩展或插件架构的开发者，Duality 的代码结构仍具有参考价值。