2 Star 82 Fork 47

dgflash / oops-game-kit

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
MIT

oops-game-kit

介绍

基于 Oops Framework 提供的游戏项目开发模板,项目中提供了最新版本 Cocos Creator 3.x 插件与游戏资源初始化通用逻辑。

使用Oops Framework创建游戏模板项目

  1. 下载模板项目
git clone https://gitee.com/dgflash/oops-game-kit.git
  1. 下载框架插件

windows

  • 执行 update-oops-plugin-framework.bat 克隆与更新框架插件
  • 执行 update-oops-plugin-hot-update.bat 克隆与更新热更新插件
  • 执行 update-oops-plugin-excel-to-json.bat 克隆与更新Excel转Json格式插件

mac

  • 执行 update-oops-plugin-framework.sh 克隆与更新框架插件
  • 执行 update-oops-plugin-hot-update.sh 克隆与更新热更新插件
  • 执行 update-oops-plugin-excel-to-json.sh 克隆与更新Excel转Json格式插件

模板项目目录结构

res                         - 预制引用的静态资源
resources                   - 动态加载引用的资源
    audio                       - 音乐资源
    common                      - 公共资源
    config                      - 配置资源
        game                        - 游戏自定义内容配置数据表
        config.json                 - 框架默认配置资源(可扩展内容)
    content                     - 自定义动态加载内容资源
    game                        - 核心玩法内容资源
    gui                         - 界面资源
        loading                     - 游戏初次加载界面
    language                    - 多语言资源
script                      - 游戏脚本
    game                        - 游戏业务模块
        common                      - 游戏公共模块
            config                      - 游戏配置
                GameEvent.ts                - 全局事件配置
                GameUIConfig.ts             - 界面窗口配置(提供oops.gui模块使用的配置数据)
            table                       - 游戏配置表对象(可通过oops-plugin-excel-to-json自动生成)
        initialize                  - 游戏初始化模块
        SingletonModuleComp.ts      - 游戏单例业务模块
    Main.ts                     - 游戏入口脚本

根据上面的目录结构,在开发游戏时,可将资源存放到对应的文件夹中管理。这套模板项目自带以下游戏必备功能。

  • 屏幕自适应
  • 游戏本地配置数据获取
  • 游戏地址查询参数获取
  • 游戏初始化业务流程
    • 初始可自定义资源加载提示界面
  • 加载与现实第一个游戏自定义界面

屏幕自适应

Cocos Creator 菜单->项目->项目设置

横屏自适应

竖屏自适应

设置好后,其它的交给框架自动处理即可。

游戏初始化模块

游戏启动时加载的必备资源

initialize/bll/InitRes.ts

这个脚本管理游戏启动时加载的必备资源,此处要注意的是,这里配置的资源尽量小一些,避免无提示加载阶段黑屏时间过长,导致游戏体验下降。

  • 加载公共资源
  • 加载多语言包(可选)
  • 加载自定义资源(可选)

initialize/view/LoadingViewComp.ts

这个脚本是游戏内容资源加载界面的控制脚本,游戏内容资源一般较大,会有加载进度条提示来提高游戏体验。所有资源加载完后,会通过执行以下脚本来显示游戏第一个自定义界面。

oops.gui.open(UIID.Demo);

QQ群

  • 798575969(1群)
  • 621415300(2群)
  • 628575875(3群)

QQ频道扫码加入,提供教程,持续更新

MIT License Copyright (c) 2022 dgflash Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

基于 Oops Framework 提供的游戏项目开发模板,项目中提供了最新版本 Cocos Creator 3.x 插件与游戏资源初始化通用逻辑。 展开 收起
TypeScript 等 4 种语言
MIT
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
TypeScript
1
https://gitee.com/dgflash/oops-game-kit.git
git@gitee.com:dgflash/oops-game-kit.git
dgflash
oops-game-kit
oops-game-kit
master

搜索帮助

14c37bed 8189591 565d56ea 8189591