Supports the use of ScriptableObject in Cocos Creator

Cocos Creator
1

Portal: Cocos Store

Introduction

Provides the same functionality as Unity’s ScriptableObject

Convenient for configuring complex structured data, facilitating collaboration, and referencing other resources

Just like configuring prefab component data normally, but without the need for nodes or attaching components

Tested Platforms

H5 WeChat Mini Game Android Native iOS Native TikTok Mini Game OPPO Mini Game vivo Mini Game
:heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark:

Features and Planning

  • [x] Custom ScriptableAsset Types

  • [x] Preview and Edit

  • [x] Drag and Drop Assignment to Component Fields (Recognition of Specified Custom ScriptableAsset Types)

  • [x] Add Right-Click Creation Button Using Decorators

  • [x] Compatible with 3.7.x

  • [x] Test on more publishing platforms

  • [ ] Support for Search

  • [ ] Support for Custom ScriptableAsset Inspector

Usage

Example Project

Gitee scriptableasset_example

GitHub scriptableasset_example

Creation

Automatically added to the right-click menu, create custom type data files

ps: You need to copy the example script template to your project: .creator\asset-template\typescript\ScriptableAssetScriptTemplate.

Create Resource.gif

Visual Configuration Modification

Modifying configuration is the same as modifying the field data of a Component

Any property decorator provided by CocosCreator can be used

Modify Resource.gif

For more usage: Cocos Creator 3.8 Manual - Decorator Usage

Referencing and Loading

Just like other resources (cc.Prefab, cc.AudioClip, etc.), reference and load

Referenced


import { _decorator, Component, Node } from 'cc';

import { bh } from 'db://scriptable-asset/scriptable_runtime';

import { CharSA } from './scripts/CharSA';

import { CharRender } from './scripts/CharRender';

const { ccclass, property } = _decorator;

@ccclass('TestRefScriptableAsset')

export class TestRefScriptableAsset extends Component {

   

    @property(CharRender)

    charRender: CharRender;

    @property(CharSA)

    charData: CharSA;

    start() {

        console.log(this.charData.charName);

        this.charRender.setCharAsset(this.charData);

    }

    update(deltaTime: number) {

    }

}

Interface

image.png

Dynamic Loading


import { _decorator, assetManager, Component, director, Node } from 'cc';

import { CharRender } from './CharRender';

import { CharSA } from './CharSA';

const { ccclass, property } = _decorator;

@ccclass('TestLoadScriptableAssetDynamic')

export class TestLoadScriptableAssetDynamic extends Component {

    /**

     *

    */

    @property(CharRender)

    charRender: CharRender = null;

    @property

    assetPath: string = "char/char_datas/CharSA"

    start() {

    }

    update(deltaTime: number) {

    }

    loadScriptableAsset() {        

        assetManager.loadBundle('scriptable_asset_test_res', (err, bundle) => {

            if (err) {

                console.error(err);

                return;

            }

            bundle.load(this.assetPath, (err, asset:CharSA) => {

                if (err) {

                    console.error(err);

                    return;

                }

                console.log(asset);

                this.charRender.setCharAsset(asset);

            });

        });

    }

}

Known Issues

  • Custom classes that are decorated with the ccclass decorator and do not inherit from Component, such as CustomClass, require an initial value to be assigned.

  • Using a specific ScriptableAsset type may cause the field assignment’s adjacent search functionality to not return any results. It is necessary to use the base class ScriptableAsset as the type for the field decorator, or to use @bh.scriptableAsset directly for marking.

    
@bh.scriptableAsset

charData: CharSA;

  • Deleting the ScriptableAsset script will cause dependent locations to display as UnknownType. After restoring the script, restarting the editor will resolve the issue.

Other Works

2

Wow! Looks great!
Thank you for sharing!