当前位置：首页 > news >正文

Sui 链游戏开发实战：用 Move 写一个链上剪刀石头布游戏！

news 来源：原创 2025/7/18 20:33:34

系列文章目录

Task1：hello move🚪
Task2：move coin🚪
Task3：move nft🚪
Task4：move game🚪

更多精彩内容，敬请期待！✌️

文章目录

系列文章目录
前言
什么是 Sui 链？
什么是 Move 编程语言？
Move 共学活动：快速上手 Move 开发
一、创建项目
- 1.1 新建 Move 项目
- 1.2 导入依赖
二、编写合约代码
- 2.1 资金池管理
- 2.2 游戏逻辑
- 2.3 主网部署
三、测试与验证
- 3.1 调用 deposit 函数
- 3.2 调用 withdraw 函数
- 3.3 调用 play 函数
总结

前言

在上一篇文章《Task3：move nft》中，我们深入探讨了如何通过 Move 编程语言 创建一个简单的 NFT 合约，学习了如何利用 Move 的资源管理和模块化设计来实现非同质化代币的存储和转移。在此过程中，我们掌握了 NFT 的创建与管理、链上资产的唯一性保障 等关键技术，为后续的更复杂应用打下了坚实的基础。

本篇文章将延续之前的学习路径，完成 Move 共学活动 中的 Task4：move game 任务。在这一任务中，我们将挑战创建一个链上互动游戏——剪刀石头布。通过编写智能合约来实现游戏的存款、取款、胜负判断等逻辑，你将进一步了解如何利用 Move 构建链上游戏，探索更多 Move 的应用场景。通过这个任务，你将能够掌握以下技术要点：

如何在 Move 合约中实现资金池的管理；
如何通过随机数生成游戏结果；
以及如何实现链上游戏的公平性与交互性。

让我们一起开启 Move 链上游戏的开发之旅，进一步挖掘 Move 编程语言在区块链应用中的巨大潜力！

HOH社区

什么是 Sui 链？

Sui 是一个高性能的区块链平台，旨在为去中心化应用提供快速、安全且可扩展的基础设施。它由 Aptos Labs 团队开发，基于新型的共识协议——Narwhal & Tusk。Sui 的设计目标是解决区块链性能瓶颈，提供极高的交易吞吐量和低延迟，适应复杂应用场景的需求。

Sui 链的主要特点：

高吞吐量与低延迟： Sui 的共识机制允许并行处理大量交易，而无需等待整个网络的全局共识。这种并行化的设计能够实现每秒处理成千上万的交易，极大提高了区块链的吞吐量，并减少交易确认的延迟。
面向对象的资源管理： Sui 将区块链中的资源视为对象进行管理。这些资源（例如代币、NFT）有独立的标识符，能够被直接跟踪和操作。通过这种方式，Sui 可以在多个节点之间高效并行地处理资源，而不需要处理全局状态，进一步提升性能。
灵活的交易模型： Sui 提供了灵活且高效的交易模型，支持在多个资源对象之间并行执行交易。这意味着不同用户的交易可以独立且高效地进行，避免了传统区块链的性能瓶颈。
高效的账户和权限管理： Sui 提供了多样化的账户管理机制，可以应对去中心化应用中复杂的权限需求。无论是个人账户、智能合约账户，还是多签账户，都能灵活配置和管理。

什么是 Move 编程语言？

Move 是专为区块链开发设计的编程语言，最初由 MetaLibra（后来的 Diem）团队开发，后被 Sui 区块链采用。Move 的设计重点是资源的管理、所有权的控制以及类型安全，它特别适用于处理去中心化应用中的资产和数字资源。

Move 语言的主要特点：

资源类型系统： Move 语言将所有的资源（如代币、NFT、智能合约中的数据等）视为“资源类型”。这些资源在系统中不能被复制或销毁，只能转移或借用。这确保了每个资源的唯一性和安全性，从根本上避免了传统智能合约中的资源丢失和重复转移问题。
所有权与借用机制： Move 通过严格的所有权和借用机制管理资源。每个资源都有一个唯一的所有者，资源的借用必须显式声明，这种机制避免了“共享资源”时的安全隐患。资源的借用可以确保开发者在不修改资源所有权的前提下共享和操作资源。
模块化编程： Move 支持模块化的编程结构，每个模块可以包含不同的资源类型和函数。模块化设计使得代码更加清晰、可复用，并有助于提高开发效率和降低代码出错的概率。
类型安全与可验证性： Move 是一门强类型语言，这意味着开发者必须在编译时明确地定义每个变量和资源的类型。Move 的类型系统能够确保合约中的大部分错误在编译阶段就被发现，从而避免了运行时错误，提高了智能合约的安全性。

Move 语言的示例代码：
以下是一个简单的 Move 合约示例，展示了如何创建和转移一个名为 Coin 的资源：

address 0x1 {module CoinModule {resource struct Coin has store {value: u64,}public fun create_coin(value: u64): Coin {Coin { value }}public fun transfer_coin(coin: Coin, recipient: address): Coin {let new_coin = Coin { value: coin.value };// 这里可以执行实际的转账操作return new_coin;}}
}

在这个示例中，Coin 是一个资源类型，包含一个 value 字段，表示代币的值。create_coin 函数用来创建新的 Coin 资源，而 transfer_coin 函数则用于将 Coin 资源转移到指定的账户。

Move 共学活动：快速上手 Move 开发

为了帮助更多开发者快速了解和掌握 Move 编程语言，Move 共学活动由 HOH 社区、HackQuest、OpenBuild、KeyMap 联合发起。该活动旨在为新手小白提供一个良好的学习平台，带领大家一步步熟悉 Move 语言，并了解如何将其应用到 Web3 开发中。

通过与 Move 领域的专业导师们合作，参与者可以快速掌握 Move 语言的基础知识，逐步向更复杂的应用开发进阶。无论是区块链初学者，还是有一定开发经验的工程师，都能从中获益。

资源链接：

sui官方文档🚪：获取关于 Sui 链的详细文档，包括开发指南、API 参考等。
move学习B站视频🚪：通过 B 站的视频教程，跟随导师学习 Move 编程语言的基础与进阶。
letsmove仓库🚪：这是一个 Move 学习资源的 GitHub 仓库，包含了各种示例代码和教程，帮助开发者掌握 Move 语言。

一、创建项目

首先，我们需要创建一个新的 Move 项目，并导入之前在 Task2 中开发的代币合约

1.1 新建 Move 项目

运行以下命令创建名为 rock_paper_scissors 的 Move 项目：

sui move new rock_paper_scissors
cd .\rock_paper_scissors\

在这里插入图片描述

1.2 导入依赖

假设我们的代币合约已经实现并存储在 my_coin 目录中。我们可以通过以下方式将其作为依赖项导入到新的项目中：

my_coin = { local = "../../task2/my_coin" }

在这里插入图片描述

在此基础上，我们空编译项目，确保依赖项正确引入并且项目能顺利编译：sui move build
在这里插入图片描述

二、编写合约代码

在合约代码中，我们创建了一个名为 rock_paper_scissors 的模块，它包含了游戏的主要逻辑，主要功能包括资金池管理、用户存款、取款以及游戏玩法的实现。以下是合约的关键部分。

2.1 资金池管理

资金池的管理是这个合约的核心部分。由于 Move 的设计需要使用 Balance 类型来存储余额，而 Balance 类型本身不具备转移功能，所以我们需要通过 Coin 类型与 Balance 类型之间的转换来进行资金管理。

为什么要对 Coin 和 Balance 进行转换？
- 原因：在合约中，所有的资金都以 Balance 类型来存储，这样可以方便地进行余额的管理和操作。然而，Balance 只能用于存储，不能作为一个可转移的对象。而 Coin 类型则可以作为具有 key 和 store 属性的对象，这样它就能够被转移到用户的钱包中。
```
public struct Balance<phantom T> has store {value: u64,
}public struct Coin<phantom T> has key, store {id: UID,balance: Balance<T>,
}
```
- 转换方法
  - into_balance：将 Coin 转换为 Balance 类型。
  - from_balance：将 Balance 转换为 Coin 类型。
```
use sui::coin;
use sui::coin::{Coin, from_balance, into_balance};
```

在游戏中，我们使用这两个方法来实现存款和取款的功能。

存款函数
用户将 Coin 代币存入资金池时，首先使用 into_balance 将 Coin 转换为 Balance，然后通过 balance::join 合并余额到游戏的资金池中。

public entry fun deposit(game: &mut Game,coin: Coin<HUAHUAHUA1223_FAUCET_COIN>,_ctx: &mut TxContext
) {let in_balance = into_balance(coin);balance::join(&mut game.balance, in_balance);
}

取款函数
当管理员从资金池中取款时，首先要检查资金池中是否有足够的余额。如果有足够余额，则将 Balance 类型转换为 Coin 类型，并转账给管理员

public entry fun withdraw(game: &mut Game,_: &Admin,amount: u64,ctx: &mut TxContext
) {assert!(game.balance.value() >= amount, EGameInsufficientBalance);let withdrawn_balance = balance::split(&mut game.balance, amount);let withdrawn_coin = from_balance(withdrawn_balance, ctx);public_transfer(withdrawn_coin, sender(ctx));
}

2.2 游戏逻辑

游戏的玩法非常简单，用户参与游戏时，需要选择剪刀、石头或布之一。合约会根据随机数生成游戏的选择，并判断用户是否获胜。如果用户获胜，奖励会是用户下注金额的两倍；如果失败，则用户下注的金额会被存入资金池。如果是平局，用户将退还代币

胜负判断函数
使用简单的规则判断玩家是否获胜：

剪刀胜布。
石头胜剪刀。
布胜石头。

public fun is_winner(player1: u8, player2: u8): bool {(player1 == 0 && player2 == 2) || // 剪刀胜布(player1 == 1 && player2 == 0) || // 石头胜剪刀(player1 == 2 && player2 == 1)    // 布胜石头
}

游戏主函数

玩家选择
玩家输入一个 u8 类型的数字（0=剪刀，1=石头，2=布）表示选择。
合约生成随机选择
使用 Random 模块生成一个随机数，取模 3 来确定游戏的选择。
胜负逻辑
- 如果玩家获胜，用户收到下注金额的两倍作为奖励。
- 如果玩家失败，下注金额进入资金池。
- 平局时，用户取回下注金额。

entry fun play(game: &mut Game,user_choice: u8,user_coin: Coin<HUAHUAHUA1223_FAUCET_COIN>,rand: &Random,ctx: &mut TxContext
) {let coin_value = user_coin.value();let game_value = game.balance.value();assert!(game_value >= coin_value * 10, EGameInsufficientBalance);let mut gen = new_generator(rand, ctx);let game_choice = generate_u8(&mut gen) % 3;if (is_winner(user_choice, game_choice)) {let reward_balance = game.balance.split(coin_value);let reward_coin = from_balance(reward_balance, ctx);public_transfer(reward_coin, ctx.sender());public_transfer(user_coin, ctx.sender());} else if (is_winner(game_choice, user_choice)) {deposit(game, user_coin, ctx);} else {public_transfer(user_coin, ctx.sender());}
}

2.3 主网部署

如果未连接主网，请参考这篇教程的第三部分🚪，之后在合约项目的根目录下（如 rock_paper_scissors），执行以下命令部署合约：
```
sui client publish --skip-dependency-verification
```
部署之后会得到一个交易哈希，记录下该值并使用 suivision区块链浏览器🚪查询合约详情
找到合约详情里的Package ID，在前端或Sui CLI测试工具中调用合约函数。