# 插件

游戏=游戏引擎+游戏业务代码。 希望将游戏引擎部分独立,在不同游戏中复用,从而缩减游戏包大小、降低首次启动时间。

# 插件创建申请

访问开发者平台 (opens new window),点击创建插件 img.png

填写插件信息进行插件创建申请,点击提交等待申请审核 img.png

申请通过后,进去插件管理页面可以获取插件ID和Secret, 用于插件的发布 img.png

# 插件开发与发布

在插件工程目录下定义plugin.json:

{
  "main": "index.js"  // 插件入口文件
}

在插件项目父目录或者其他目录(注意不要在当前待打包插件目录或者子目录):

$ mgc config

配置成功后会在当前目录生成配置文件 mgc.config.js,配置示例如下:

module.exports = {
  "appId": "4503b3691d974573a747ed85f74f1a29",
  "appSecret": "752d7e4a3b8b4525",
  "entry": "./", // 待打包的插件路径
  "type": "plugin"
}

在生成 mgc.config.js 的同级目录执行以下命令进行插件发布:

$ mgc publish

开发者可以在开放平台查看已发布的插件版本,可标记某个版本为“稳定版本”: img.png

# 配置使用

使用方式和微信一致。微信只支持一个引擎插件,我们可以支持多个插件。

在game.json中指定插件信息:

{
  "plugins": {
    "cocos": { // requirePlugin 时用的名称
      "provider": "mgc********", // 插件的appid
      "version": "1.0", // 必须指定插件的版本
    }
  }
}

在游戏运行时使用插件:

requirePlugin('cocos') // 包含插件
requirePlugin('cocos/d3.js') // 包含插件并指定入口文件
上次更新: 8/10/2026, 5:36:37 PM