1 Star 1 Fork 0

A.Grothendieck / GC Confluxn 插件 demo

Create your Gitee Account
Explore and code with more than 6 million developers,Free private repositories !:)
Sign up
Clone or Download
Cancel
Notice: Creating folder will generate an empty file .keep, because not support in Git
Loading...
README.md

部分图片可能需要翻墙后才能加载

对于游戏编辑器GameCreator以及此教程有任何疑问与想法可以添加QQ1658914566或者详细记录问题发送到邮箱1658914566@qq.com 输入图片说明

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账户

登录与注册账户: 输入图片说明

下载GC: 输入图片说明

下载GC免费版本后可通过激活码体验付费功能。


选择游戏模板

点击新建工程后即可选择所需要的游戏模板,此处我们选择苍之羽

输入图片说明

下载和使用插件

进入游戏模板内后点击插件管理器即可进入插件系统 输入图片说明

点击插件商城就可以下载自己想要的插件了 输入图片说明

在插件商城中找到Conflux插件并且下载安装 输入图片说明

成功安装后如图所示 输入图片说明

安装成功后,首先切换到对象层开始创建场景对象 输入图片说明

右键地图就可以开始创建场景对象 输入图片说明

左键选中场景对象,开始设置相关事件 输入图片说明

在事件的插件指令一栏我们可以找到Conflux插件的相关指令 输入图片说明

点击插件指令后出现下图,请按照Conflux相关文档以及基于范例工程的详细功能介绍配置相关参数 输入图片说明

下载范例工程(范例工程自带插件)

范例工程已经设置好了插件的参数以及一些默认的事件,玩家无需自行设置参数和事件,对于初学者而言,建议使用范例工程来学习插件的使用

按住CTRL+F9以网页端测试运行游戏 (如果首次启动浏览器时未能启动连接钱包,请按F5刷新浏览器) 输入图片说明

点击这里来下载 GC Conflux 插件完整演示项目

以下部分为基于范例工程的详细功能介绍



连接钱包

输入图片说明

安装钱包

请根据前文的引导与提示,正确地下载浏览器和浏览器插件并且打开该插件,保持您的浏览器和钱包处于在线状态,钱包会在待机一定时间后登出账户,钱包待机时间可以于钱包设置中变更。

游戏界面

点击头顶漂浮有“连接钱包”字样的角色来开始连接你的钱包, (此时你应该已经安装好了相关插件并且钱包处于在线状态) 如果未成功连接到钱包则会显示以下图片: 输入图片说明

已连接:(cfxtest 开头字符串为当前连接的账户测试网地址) 输入图片说明

配置界面

如图所示,打开相关的配置页面

输入图片说明

配置页面: 输入图片说明

选项说明书

显示窗口关闭按钮: 勾选以允许玩家在不完成钱包连接的情况下关闭连接钱包窗口。

已连接时跳过该事件: 如果钱包已连接,则直接执行事件流的下一个事件,不会在弹出界面。

限制允许连接的链/网络: 勾选后只允许特定 ID 的网络进行连接。应为 ID 可读性不足,需填写链/网络的名称来提示用户切换到哪个网络。

记录结果: 绑定变量,事件执行完毕之后将会吧结果传入绑定的变量中,0表示成功,其余值表示不同的错误代码。

账户地址: 绑定字符串变量,钱包连接成功后返回账户地址到绑定的字符串变量中。

链/网络 ID: 绑定字符串变量,钱包连接成功后返回登录的链/网络对应的 ID 到绑定的字符串变量中,值为 16 进制编码。

通过 Alert 弹窗展示错误信息: 勾选后执行过程出现的错误会以 alert 弹窗的形式出现,便于开发调试。


获取 CFX 余额

输入图片说明

点击这里来获取通过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 弹窗的形式出现,便于开发调试。

已知问题

  1. 在浏览器的初始页面中使用此插件可能会遇到无法连接钱包的 BUG,F5 刷新页面即可解决。
  2. 合约交互与合约操作时的错误不会返回具体的错误代码,因为无法得到具体的错误码,目前一律返回 -1

参考资料

ConfluxPortal 文档 创建合约的教程 miniERC20合约

Repository Comments ( 0 )

Sign in to post a comment

About

GameCreator Conflux 插件演示项目 expand collapse
JavaScript and 3 more languages
Apache-2.0
Cancel

Contributors

All

Activities

Load More
can not load any more
1
https://gitee.com/agrothendieck/gc-confluxn-plug-in-demo.git
git@gitee.com:agrothendieck/gc-confluxn-plug-in-demo.git
agrothendieck
gc-confluxn-plug-in-demo
GC Confluxn 插件 demo
master

Search