# oops-framework

**Repository Path**: dgflash/oops-framework

## Basic Information

- **Project Name**: oops-framework
- **Description**: 基于 Cocos Creator 3.x 版本开发的游戏框架，此项目为 Oops Framework 教程项目，如果使用框架制作游戏项目可下载 oops-game-kit 游戏项目模板开发。
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://gitee.com/dgflash/oops-framework/wikis/pages
- **GVP Project**: No

## Statistics

- **Stars**: 1514
- **Forks**: 506
- **Created**: 2021-07-03
- **Last Updated**: 2025-08-08

## Categories & Tags

**Categories**: game-dev

**Tags**: CocosCreator, 游戏框架, TypeScript, JavaScript, 游戏开发

## README

<div align="center" >
<img src="https://foruda.gitee.com/images/1724943109003294846/4b4d1ba8_548477.png" width="425" height="186" />
</div>


<div align="center" >
<a href="https://gitee.com/dgflash/oops-plugin-framework/blob/master/LICENSE" target="_blank">
    <img src="https://img.shields.io/badge/Licence-MIT-green.svg?style=flat" height="22"/>
</a>
<a href="https://gitee.com/dgflash/oops-framework/wikis/pages?sort_id=12101082&doc_id=2873565" target="_blank">
    <img src="https://img.shields.io/badge/Version-2.0.0-blue.svg?style=flat" height="22"/>
</a>
<a href="https://gitee.com/dgflash/oops-framework/wikis/pages?sort_id=12002367&doc_id=2873565" target="_blank">
    <img src="https://img.shields.io/badge/Document-Guide-red.svg?style=flat" height="22"/>
</a>
<a href='https://gitee.com/dgflash/oops-framework/stargazers' target="_blank">
   <img src='https://gitee.com/dgflash/oops-framework/badge/star.svg?theme=dark' alt='star' height="22" />


</div>

<br/>

# 概览

oops Framework 是一款基于 Cocos Creator 3.x 开发的游戏框架。自 2021 年 7 月开源起，它始终与 Cocos Creator 3.x 的各个版本保持同步更新。与此同时，该框架也在持续迭代版本，不断提升稳定性与易用性。

<br/>

<br>

# 设计理念

oops Framework 致力于提供一个拥有游戏开发常用技术的框架，从而提高开发效率、降低开发门槛、专注于内容设计、促进技术共享和交流。

<br/>

<br/>

# 框架特点

- 提供较为全面的游戏开发常用技术
- 提供可提高开发效率的插件工具
- 提供教学项目以及不同类型的解决方案项目
- 拥有稳定可靠的框架技术
- 对新人极为友好，操作简单且易于上手

简要结构：

```mermaid
graph LR
OOPS -.主框架.-> oops-plugin-framework
OOPS -.热更新.-> oops-plubgin-hot-update
OOPS -.Excel转json.-> oops-plubgin-excel-to-json
```

主框架部分：

```mermaid
graph TB
主框架 --> 核心模块
核心模块 --> 界面管理
核心模块 --> 音效管理
核心模块 --> 消息管理
核心模块 --> 资源管理
核心模块 --> 本地存储
核心模块 --> ...
主框架 --> 可选模块
可选模块 --> 动画状态机
可选模块 --> MVVM
可选模块 --> ECS
可选模块 --> 网络模块
可选模块 --> 渲染纹理
可选模块 --> GUI组件
可选模块 --> ...等

```

<br/>

<br/>

# 官方推荐

- <a href="https://mp.weixin.qq.com/s/FfkKn1jLxfDCd6sMaDAT-A" target="_blank">Cocos 官方推荐框架</a>
- <a href="https://mp.weixin.qq.com/s/WTLBMjv0uoA4XPneLcjC-w" target="_blank">Cocos 官方2022年TOP10的插件工具</a>
- <a href="https://mp.weixin.qq.com/s/MzP-6P6uiddm3ckrISvmkg" target="_blank">Cocos Creator 3.x 优秀开源框架</a>
- <a href="https://www.bilibili.com/video/BV1B9pFejEko/?vd_source=2ecab277f9fb79c5e11c909bf0affd34" target="_blank">Cocos Creator 3.x 优秀开源框架盘点</a>

框架产品案例： [产品案例](https://gitee.com/dgflash/oops-framework/wikis/%E5%BA%94%E7%94%A8%E6%A1%88%E4%BE%8B)

<br/>

<br/>

# 学习资源

oops框架文档： [WIKI](https://gitee.com/dgflash/oops-framework/wikis/pages?sort_id=12002375&doc_id=2873565)

bili视频教程：[dgflash](https://space.bilibili.com/479459079?spm_id_from=333.788.upinfo.detail.click)

Cocos Store产品：[Cocos Store](https://store.cocos.com/app/search?name=oops)

<br/>

<br/>

# 社群链接

- 798575969（1群 - 满） 
- 621415300（2群 - 满）
- 628575875（3群 - 满）
- 226524184（4群 - 满）
- 741197640（5群 - 满）
- 438995424（6群 - 满）
- 916492808（7群 - 推荐）

### QQ频道：q366856bf5

> 欢迎大家交流、推广，在此感谢！