从零开始：手把手教你部署链上游戏合约

作为游戏老鸟，我发现区块链和智能合约简直是策略游戏的。近花了两周时间折腾Truffle框架，成功部署了人生第一个链上游戏合约。今天就把我的踩坑实录整理成攻略，手把手带你复现整个过程。

准备工作：搭建你的数字工具箱

想象你要组装一台新主机，先把螺丝刀和零件备齐。这里需要准备三个核心工具：

• Node.js（v18+） 就像游戏引擎的运行时环境
• Ganache 本地以太坊沙盒，相当于单机测试服
• MetaMask钱包插件 你的虚拟游戏账户

安装命令很简单（Windows用户记得用管理员模式打开终端）：

npm install -g truffle
npm install -g ganache

遇到权限问题的话，试试在命令前加sudo（Mac/Linux用户专属）。装好后输入truffle version，看到版本号就算成功。

创建你的游戏大厅

在桌面新建个文件夹，名字建议用my_first_dapp。打开终端跳转到这个目录，输入：

truffle init

这时会生成三个关键目录：

编写你的第一个游戏合约

我们来做个简单的战力值PK游戏。在contracts目录新建GameBattle.sol如下：

pragma solidity ^0.8.0;
contract GameBattle {
mapping(address => uint) public playerPower;
function createPlayer(uint initialPower) public {
require(initialPower<= 100, "新手战力上限100");
playerPower[msg.sender] = initialPower;
function battle(address opponent) public {
require(playerPower[msg.sender] > 0, "请先创建角色");
require(playerPower[opponent] > 0, "对手不存在");
if(playerPower[msg.sender] > playerPower[opponent]) {
playerPower[msg.sender] += 5;
} else {
playerPower[msg.sender] -= 3;

这个合约实现了两个核心功能：创建游戏角色（初始战力不超过100）和玩家对战机制。获胜方战力+5，失败方-3。

配置你的游戏服务器

打开truffle-config.js文件，修改网络配置部分：

module.exports = {
networks: {
development: {
host: "127.0.0.1",
port: 8545,
network_id: "",
};

接着启动Ganache，它默认就在8545端口运行。看到控制台出现10个测试账户，说明本地链环境就绪。

部署与测试

在migrations目录创建2_deploy_contracts.js：

const GameBattle = artifacts.require("GameBattle");
module.exports = function(deployer) {
deployer.deploy(GameBattle);
};

运行部署命令：

truffle migrate

当看到"Network up to date."的提示，说明合约已经成功部署到本地链。现在可以打开Truffle控制台来试玩：

truffle console
>> let instance = await GameBattle.deployed
>> await instance.createPlayer(85, {from: accounts})
>> await instance.createPlayer(90, {from: accounts})
>> await instance.battle(accounts, {from: accounts})
>> await instance.playerPower(accounts)
// 输出结果应该是82（因为90 > 85，所以85-3）

自动化测试脚本

在test目录新建game_test.js：

const GameBattle = artifacts.require("GameBattle");
contract("GameBattle", (accounts) => {
it("应该正确记录战力值", async  => {
const instance = await GameBattle.deployed;
await instance.createPlayer(80, {from: accounts});
const power = await instance.playerPower(accounts);
assert.equal(power, 80);
});
it("应该执行对战逻辑", async  => {
const instance = await GameBattle.deployed;
await instance.createPlayer(80, {from: accounts});
await instance.createPlayer(90, {from: accounts});
await instance.battle(accounts, {from: accounts});
const newPower = await instance.playerPower(accounts);
assert.equal(newPower, 77);
});
});

运行truffle test，看到两个绿色对勾就说明测试通过。

连接前端界面

虽然命令行很酷，但真正的游戏需要可视化界面。在项目根目录执行：

npm install @truffle/contract web3

新建index.html，这里给出核心交互代码：

// 初始化web3
if (typeof web3 !== 'undefined') {
web3 = new Web3(web3.currentProvider);
} else {
web3 = new Web3(new Web3.providers.HttpProvider('));
// 加载合约
const contractJSON = require('./build/contracts/GameBattle.json');
const gameContract = new web3.eth.Contract(
contractJSON.abi,
works['5777'].address
);
// 创建角色
async function createCharacter {
const power = document.getElementById('initialPower').value;
await gameContract.methods.createPlayer(power).send({from: accounts});
alert('角色创建成功！');
// 执行对战
async function startBattle {
const opponent = document.getElementById('opponentAddress').value;
await gameContract.methods.battle(opponent).send({from: accounts});
updatePowerDisplay;

记得在Ganache中解锁账户，MetaMask要连接到本地开发网络。现在打开浏览器访问这个页面，就能看到可以交互的网页版链游了。

常见问题排错指南

• 遇到Invalid JSON RPC response：检查Ganache是否运行在8545端口
• 交易长时间不确认：在truffle-config里设置gasPrice为
• 合约方法调用失败：用truffle networks命令确认合约地址是否正确

现在你应该能看到浏览器页面上的战力值随着每次对战发生变化。试着用两个不同的测试账户登录，观察他们之间的对战结果是否符合预期。下次可以尝试给合约添加排行榜功能，或者引入NFT角色系统——这些就留给各位发挥创意了。