gitee页面(由于gitee图片上传限制,部分图片需翻墙查看,稍晚修复这个问题)
对于游戏编辑器GameCreator以及此教程有任何疑问与想法可以添加QQ1658914566或者详细记录问题发送到邮箱[email protected]
QQ群 897259916
部分图片可能需要翻墙后才能加载
GameCreator的Conflux插件接入教程
什么是 GameCreator?
GameCreator 是一款兼容专业级游戏制作和爱好者游戏制作的可视化游戏制作软件。通过游戏模板系统和插件系统以及多类型的可视化编辑器(如场景对象、粒子和动画等)方便快捷的制作游戏。
如何下载 GameCreator?
Steam上的GameCreator
什么是 Conflux?
什么是ConfluxPortal?
GameCreator软件本体的基础视频教程
GameCreator文档中心
GameCreator论坛
在开始教程之前,请先安装Google Chrome(谷歌浏览器)或者Fire Fox(火狐浏览器)
浏览器安装完毕后,请安装使用Conflux所必须的浏览器钱包插件 ConfluxPortal
ConfluxPortal浏览器插件Github下载地址
如果您从未使用过GameCreator软件或者类似的其他游戏编辑器,建议在顶部的几个网站内学习如何快速入门。
目录:
[toc]
下载GC并且注册账户
登录与注册账户:
下载GC:
下载GC免费版本后可通过激活码体验付费功能。
选择游戏模板
点击新建工程后即可选择所需要的游戏模板,此处我们选择苍之羽
下载和使用插件
进入游戏模板内后点击插件管理器即可进入插件系统
点击插件商城就可以下载自己想要的插件了
在插件商城中找到Conflux插件并且下载安装
成功安装后如图所示
安装成功后,首先切换到对象层开始创建场景对象
右键地图就可以开始创建场景对象
左键选中场景对象,开始设置相关事件
在事件的插件指令一栏我们可以找到Conflux插件的相关指令
点击插件指令后出现下图,请按照Conflux相关文档以及基于范例工程的详细功能介绍配置相关参数
下载范例工程(范例工程自带插件)
范例工程已经设置好了插件的参数以及一些默认的事件,玩家无需自行设置参数和事件,对于初学者而言,建议使用范例工程来学习插件的使用
按住CTRL+F9以网页端测试运行游戏
(如果首次启动浏览器时未能启动连接钱包,请按F5刷新浏览器)
以下部分为基于范例工程的详细功能介绍
连接钱包
安装钱包
请根据前文的引导与提示,正确地下载浏览器和浏览器插件并且打开该插件,保持您的浏览器和钱包处于在线状态,钱包会在待机一定时间后登出账户,钱包待机时间可以于钱包设置中变更。
游戏界面
点击头顶漂浮有“连接钱包”字样的角色来开始连接你的钱包,
(此时你应该已经安装好了相关插件并且钱包处于在线状态)
如果未成功连接到钱包则会显示以下图片:
已连接:(cfxtest 开头字符串为当前连接的账户测试网地址)
配置界面
如图所示,打开相关的配置页面
配置页面:
选项说明书
显示窗口关闭按钮:
勾选以允许玩家在不完成钱包连接的情况下关闭连接钱包窗口。
已连接时跳过该事件:
如果钱包已连接,则直接执行事件流的下一个事件,不会在弹出界面。
限制允许连接的链/网络:
勾选后只允许特定 ID 的网络进行连接。应为 ID 可读性不足,需填写链/网络的名称来提示用户切换到哪个网络。
记录结果:
绑定变量,事件执行完毕之后将会吧结果传入绑定的变量中,0表示成功,其余值表示不同的错误代码。
账户地址:
绑定字符串变量,钱包连接成功后返回账户地址到绑定的字符串变量中。
链/网络 ID:
绑定字符串变量,钱包连接成功后返回登录的链/网络对应的 ID 到绑定的字符串变量中,值为 16 进制编码。
通过 Alert 弹窗展示错误信息:
勾选后执行过程出现的错误会以 alert 弹窗的形式出现,便于开发调试。
获取 CFX 余额
游戏界面
配置界面
总览:
支持查询指定账户或者当前连接的账户的余额:
选项说明书
查询:
支持查询指定账户或者当前连接的账户的余额,支持绑定字符串变量。
阻塞运行:
开启:等待数据获取完成后再执行后续步骤
关闭:静默异步获取,不会停顿
执行结果:
绑定变量,事件执行完毕之后将会吧结果传入绑定的变量中,0表示成功,其余值表示不同的错误代码。
余额(单位:CFX):
CFX 是标准的余额单位,包含 18 位精度小数。因 JavaScript 数值精度问题,使用字符串变量存储。
余额(单位:Drip):
Drip 是最小和分的单位,不包含小数。因 JavaScript 数值精度问题,使用字符串变量存储。
通过 Alert 弹窗展示错误信息:
勾选后执行过程出现的错误会以 alert 弹窗的形式出现,便于开发调试。
发送交易
游戏界面
通过修改配置界面相关的设置来达到以下两种效果
玩家输入收款地址和金额:
你也可以指定收款地址和金额,玩家不可更改:
配置界面
总览:
支持绑定变量和预先指定
选项说明书
收款地址:
支持玩家输入、固定地址和绑定字符串变量。
代币类型:
目前只支持 CFX 类型,如果需要对合约 Token 进行转账,请使用 “合约交互” 事件。
转账金额:
填写 CFX 单位。支持玩家输入、固定金额和绑定变量。
显示取消按钮:
勾选以允许玩家在不完成交易的情况下关闭交易窗口。
等待交易确认:
开启:在发送交易后会弹出加载界面,并等待交易所在区块被链上确认或者失败。
关闭:交易发送成功后不会等待,立即执行事件流的下一步。
执行结果:
绑定变量,事件执行完毕之后将会吧结果传入绑定的变量中,0表示成功,其余值表示不同的错误代码。
交易地址:
绑定字符串变量,交易发送成功以后会吧交易地址存入被绑定的变量中。
通过 Alert 弹窗展示错误信息:
勾选后执行过程出现的错误会以 alert 弹窗的形式出现,便于开发调试。
部署合约
在点击部署ERC20合约之前,可以先到配置界面更改相关参数,然后点击部署,随即将会弹出如游戏界面所示的内容。
游戏界面
点击确认即可完成合约部署
配置界面
总览:
参数类型展示:
选项说明书
abi (JSON):
合约的接口定义,格式为 JSON
bytecode:
合约代码
构建函数传参列表:
部署合约所需要的信息,请参考合约 abi 文件或合约文档按需填写。
等待交易确认:
开启:在发送交易后会弹出加载界面,并等待交易所在区块被链上确认或者失败。
关闭:交易发送成功后不会等待,立即执行事件流的下一步。
执行结果:
绑定变量,事件执行完毕之后将会吧结果传入绑定的变量中,0表示成功,其余值表示不同的错误代码。
交易地址:
绑定字符串变量,交易发送成功以后会吧交易地址存入被绑定的变量中。
合约地址:
绑定字符串变量,不勾选 “等待交易确认” 时,执行结果不包含合约地址。
通过 Alert 弹窗展示错误信息:
勾选后执行过程出现的错误会以 alert 弹窗的形式出现,便于开发调试。
调用合约
游戏界面
点击下列两个选项可以分别调用视图类接口和交易类接口
视图类接口:
交易类接口:
配置界面
点击数据库找到界面
找到合约功能测试
此处示例点击部署ERC20合约 然后点击通用事件 并且找到参数
视图类接口:
*交易类接口:
返回数据支持多种类型:
选项说明书
显示名称:
可根据操作类型自定义弹窗标题信息,便于玩家理解。
合约地址:
被调用的合约的链上地址。
abi (JSON):
合约的接口定义,格式为 JSON。
方法名称
被调用的合约接口的名称,限定为方法类接口,请参考合约 abi 文件或合约文档按需填写。
合约方法传参列表
运行方法所需要传入的数据,请参考合约 abi 文件或合约文档按需填写。
模式:
视图(view):例如读取合约数据的方法,不写入数据的方法,免费调用。
读取/写入(nonpayable):例如转账方法,会写入合约数据,发送交易并产生交易费用的方法。
记录结果:
绑定变量,事件执行完毕之后将会吧结果传入绑定的变量中,0表示成功,其余值表示不同的错误代码。
交易地址:
模式为:“需要支付(nonpayable)” 时出现。绑定字符串变量,交易发送成功以后会吧交易地址存入被绑定的变量中。
返回数据:
模式为:“视图(view)” 时出现。根据返回值的类型进行选择并绑定变量,合约调用成功后会将结果存入绑定的变量中。
通过 Alert 弹窗展示错误信息:
勾选后执行过程出现的错误会以 alert 弹窗的形式出现,便于开发调试。
已知问题
- 在浏览器的初始页面中使用此插件可能会遇到无法连接钱包的 BUG,
F5
刷新页面即可解决。 - 合约交互与合约操作时的错误不会返回具体的错误代码,因为无法得到具体的错误码,目前一律返回
-1
。