![](https://img.cointime.com/builder/RUDPIZ76jmqxiGCfNDjBvMygriD3QbxG28wDyb3o.png)
在 AO 上实现自治宠物游戏。
作者:李大狗
审阅:Lemon
来源:内容公会 - 新闻
从本篇开始,将以一个链上宠物游戏为例, Step by Step 讲述如何基于 AO 进行游戏开发。
仓库: https://github.com/rootMUD/ao-autonomous-pet/
Process Code Online:
https://www.ao.link/#/entity/oMIa9Ea8dWESVZJ3iDX62mbTNFdm9zwFtV-5th6f5zs
0x00 架构设计
和其他区块链应用一致,
同样遵循「轻链上,重链下」、「抽象链上、具象链下」的原则。AO-Autonomous-Pet
在这种原则下,我们这样设计应用的架构:
![](https://img.cointime.com/builder/TCZ8twtxeTGM2Z3iuxRuN6BikuAcgWY6Vt7gE9MY.png)
在链上,我们设计出抽象层面的 Pet 以及必要的 Create/Read/Write 等方法,在 AO Process 中实现。
在链下,我们把抽象层面的 Pet 通过渲染(Renderer)模块渲染为具体的 Pet;通过 Pet Getter 对 AO Process 中的数据进行读取。通过 Pet Feeder 对 Pet 的等级进行提升。
0x01 Pet.lua 的实现与部署
在 AO-Counter | AO 极速入门(一) 中,我们使用的是原生存储方式。在本次实践中,我们通过 AOS-SQLite 来实现我们的存储,SQLite是非常流行的文件式关系型数据库。
1.1 代码加载
AOS-SQLite Repo: https://github.com/permaweb/aos-sqlite
![](https://img.cointime.com/builder/LjDs7GG9S1fNir50lupGwSiVexd6yIomHOlYVezJ.png)
在 AOS-SQLite Repo 中查看
的当前版本。ao-sqlite module id
在 process 中加载 lua 脚本。
![](https://img.cointime.com/builder/Tn0zPrJef34CsXQDQcXeuW2Ve4Cx8KFjUKqiMnAU.png)
1.2 初始化 MySQL
![](https://img.cointime.com/builder/d9BU0rM0Q3C3XzvE9IhQzRf50gkKSkAEbAxCPNZD.png)
加载 DB,然后执行 exec 脚本。
在这里,我们创建了一个表,里面包含如下字段:
- 自增 id
- Pet 名字
- Pet 描述
- Pet 等级
- Pet 类型
- Pet 拥有人地址
- 上次更新时间戳
1.3 关于 Pet 的 CRW
CRW
即 Create-Read-Write
的缩写。通常,我们认为传统计算机中的基本操作是 CRUD
—— Create, Read, Update and Delete
。在区块链架构中,由于区块链不可篡改的基本特性,所以基本操作转变为 CRW
—— Create, Read and Write
。
1.3.1 initPet
![](https://img.cointime.com/builder/5QPvPlgawQenTn8YuIPntbRmYHQsoUkf3RYmYSIq.png)
通过一个 Handler 和 一个 Function
,我们实现了
。initPet
stmt
是 SQLite 中用于执行准备好的语句的函数。在 SQLite 的上下文中,准备好的语句是一个预编译的 SQL 语句,它可以用来提高效率和安全性。stmt:step()
当你调用
时,它会执行准备好的 SQL 语句。如果 SQL 语句返回结果(例如 stmt:step()
SELECT
查询),那么
会将语句的执行状态移动到结果集中的下一行。对于其他类型的 SQL 语句(如stmt:step()
INSERT
、
和 UPDATE
),DELETE
会实际执行这些操作。stmt:step()
如果
返回 stmt:step()
,这意味着还有更多的行可以处理。如果返回sqlite3.ROW
sqlite3.DONE
,这意味着语句已经完成执行,结果集已经完全遍历或者操作已经执行完毕。
- 简单随机数
在计算机编程中,随机数会具备两种属性:可预测性
与可验证性
。
![](https://img.cointime.com/builder/MOJJdWuhVJBS2Cryb5QAdyJDcrtIz1C0Wujqes3I.png)
💡https://blog.chain.link/verifiable-random-function-vrf-zh/
不同的使用场景对随机数有不同的需求。例如,在
中,我们希望生成一个宠物类型,但这个随机数没有验证公平性的需求,所以我们可以直接使用 lua 自带的 initPet
函数。math.random()
如果需要随机数可验证的话,会使用 AO 自带的
,这个在本系列的后续中再予以阐述。crypto.cipher.issac.getRandom()
- 时间戳
在 Handler 中,msg 默认携带时间戳,我们把 msg 中的时间戳作为变量传入函数即可。
1.3.2 getPet
& getPets
,通过 Address 作为 Key 来获取 Pet。getPet
,获取所有 PetsgetPets
![](https://img.cointime.com/builder/TkzpDwPxye9CfnNfMNVqXS0OrO4VmIdpGkdwyvXx.png)
- json 处理
我们通过
将 pets 转换为 string 进行回复,主要要在文件头引入 json.encode
json package --
local json = require("json")
。
1.3.3 UpdateLevel
![](https://img.cointime.com/builder/ELB6APxzVbjrW2JPFNDT4gCqDvrC2a9ZHmFIkFJN.png)
![](https://img.cointime.com/builder/otxBM8fBB1xsmSx3WyxGvSXcgx2Lk6jh5TbAP8Hd.png)
在updatePetLeve
l函数中,我们设置了基于时间的升级机制,升级后会需要一个小时的冷却时间。
1.3.4 调用 Handler 的 AO 指令
initPet
![](https://img.cointime.com/builder/Tn6r8564jYQsyunA9A57INek8ZAGJVlwnqZeNVYO.png)
getPet
![](https://img.cointime.com/builder/hXys94uJ358bKn5n890sGWpItZgz2BpsddmMZc4o.png)
getPets
![](https://img.cointime.com/builder/OLw8ERAmJcGBeM196MsGxx4T3Gzx2htM5pX6AHUP.png)
updateLevel
![](https://img.cointime.com/builder/yitm9duWZHscL9EIcE0ztUFLGAi3CspX0umTheil.png)
0x02 番外:关于 GPT 编写代码的极简指南
本篇阐述一个额外的重要话题,如何利用 GPT 来辅助编写代码?
我们来一个一句话的极简指南:
💡把已有的代码或模板放在 Prompt 的最前面,然后再问问题 ——
抽象来看就是:
![](https://img.cointime.com/builder/1Tr1mIPB6lEXqbXAd2CfIWug9wjFIkEZIXj5kjZ8.png)
或
![](https://img.cointime.com/builder/WjqbpgaAzBrTaEelUH6Aq1vx1hq6hG0NI92vhCmb.png)
以 .lua
的编写为例,我们将 https://github.com/iamgamelover/ao-twitter 作为起始模板用 AI 进行代码编写。
2.1 Sqlite 交互代码生成
Prompt:
local json = require("json")local sqlite3 = require("lsqlite3")DB = DB or sqlite3.open_memory()DB:exec [[ CREATE TABLE IF NOT EXISTS stories ( id TEXT PRIMARY KEY, address TEXT, post TEXT, range TEXT, category TEXT, likes INT, replies INT, coins INT, time INT );]]DB:exec [[ CREATE TABLE IF NOT EXISTS replies ( id TEXT PRIMARY KEY, post_id TEXT, address TEXT, post TEXT, likes INT, replies INT, coins INT, time INT );]]DB:exec [[ CREATE TABLE IF NOT EXISTS likes ( id TEXT, address TEXT, time INT );]]DB:exec [[ CREATE TABLE IF NOT EXISTS txids ( id TEXT PRIMARY KEY, txid TEXT );]]Give me the code about ao-pets.lua, which includes follow fields: name, description, lastUpdated, level, type, address which is unique and id which is increased automatically.
Answer:
Here's an example of the ao-pets.lua script that includes the specified fields (name, description, lastUpdated, level, type, address, id which is unique and automatically incremented):
![](https://img.cointime.com/builder/79T9016rHczBIdu2H2bPKNr5E2IzIliGnyYmF9bt.png)
In this script:
- The
ao_pets
table is created with fields
,id
,name
,description
,lastUpdated
,level
, andtype
.address
- The
id
field is set as the primary key and will automatically increment.
- The
field is unique.address
- The
add_pet
function inserts a new pet into the
table.ao_pets
- The
function retrieves and prints all pets in the table.get_all_pets
You can modify the script further based on your specific needs.
2.2 Handler 代码生成
Prompt:
Handlers.add( "AddNew", Handlers.utils.hasMatchingTag("Action", "AddNew"), function (msg) table.insert(Players, msg.Data) count = #Players Handlers.utils.reply("bizz buzz")(msg) end)
Here is a handler example, impl Action "GetAllPets".
Answer:
Here's an example of a handler for the Action "GetAllPets" that retrieves all pets from the ao_pets table and sends them back as a response:
![](https://img.cointime.com/builder/11CV2ijm0DoW0ROdVSl9v2MQmh04lPlszxiHbWB8.png)
In this handler:
- The
action is defined and will be triggered when a message with theGetAllPets
"GetAllPets" is received.Action
- The handler function retrieves all rows from the
table and stores them in aao_pets
pets
table. - A response table is created with the
"GetAllPetsResponse" and the retrieved pets data.Action
- The response is sent back using
.Handlers.utils.reply
This will ensure that when the "GetAllPets" action is received, the handler will retrieve all pets from the database and send them back in the response.
![](https://img.cointime.com/builder/ovWqQr70ci3CijXUFxZiP4idaEP58ZuGsMQnfzzy.png)
🏆 “捉虫”有奖:在本文发现错字、病句、描述有误,点我报告,可得激励。
免责声明:本文不代表 PermaDAO 的观点或立场。PermaDAO 不提供投资建议,亦不为任何项目背书。请读者遵守所在国法律,合规进行 Web3 活动。
🔗 关于 PermaDAO:Website | Twitter | Telegram | Discord | Medium | Youtube
All Comments