[oops-framework] Template project [oops-game-kit] Introduction

Introduction to Oops Game Kit

Based on the game project development template provided by Oops Framework, the project provides the latest version of Cocos Creator 3.x plug-ins and the general logic for initializing game resources.

Create a game template project

1. Download the template project

git clone https://gitee.com/dgflash/oops-game-kit.git

2. Download Oops Framework

Installing the framework plugin for the first time

windows

md extensionscd extensionsgit clone -b master https://gitee.com/dgflash/oops-plugin-framework.gitgit pull

mac

mkdir -p extensionscd extensionsgit clone -b master https://gitee.com/dgflash/oops-plugin-framework.gitgit pull

Template project directory structure

res - prefab referenced static resourcesresources - dynamically loaded referenced resourcesaudio - Music resourcecommon - common resourceconfig - configure resourcesgame - Game custom content configuration data sheetconfig.json - Framework default configuration resources (extensible content)content - custom dynamically loaded content resourcegame - core gameplay content resourcegui - interface resourcesloading - the first loading interface of the gamelanguage - Multilingual resourcesscript - Game scriptgame - Game business modulecommon - Game common modulesconfig - Game configurationGameEvent.ts - global event configurationGameUIConfig.ts - UI window configuration (provides configuration data used by the oops.gui module)table - game configuration table object (can be automatically generated by oops-plugin-excel-to-json)initialize - Game initialization moduleSingletonModuleComp.ts - Game singleton business moduleMain.ts - Game entry script

According to the above directory structure, when developing games, resources can be stored in corresponding folders for management.This template project comes with the following essential game features.

• Screen adaptation
• Get game local configuration data
• Getting game address query parameters
• Game initialization business process
  • Initial customizable resource loading prompt interface
• Load and realistic first game custom interface

Screen fit

Cocos Creator Menu->Project->Project Settings

Landscape adaptive

Portrait adaptive

After setting, the rest can be handled automatically by the framework. If you have special adaptive needs, you can join the QQ exchange group for discussion.

Game initialization module

Required assets loaded at game startup

initialize/bll/InitRes.ts

This script manages the necessary resources loaded when the game starts. It should be noted here that the resources configured here should be as small as possible, so as to avoid the black screen for too long during the silent loading stage, which will lead to a decrease in the game experience.

• Load public resources
• Load multilingual package (optional)
• Load custom resource (optional)

initialize/view/LoadingViewComp.ts

This script is the control script of the game content resource loading interface. The game content resources are generally large, and there will be a loading progress bar prompt to improve the game experience.After all resources are loaded, the first custom interface of the game will be displayed by executing the following script.

oops.gui.open(UIID.Demo);