# TK

**Repository Path**: alan223/tk

## Basic Information

- **Project Name**: TK
- **Description**: 这是一个基于区块链的卡牌对战游戏DApp项目，玩法类似Marvel Snap
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-03-01
- **Last Updated**: 2025-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TK 项目

## 🎮 项目概述

TK 是一款基于区块链的卡牌对战游戏 DApp，玩法灵感来自 **Marvel Snap**。玩家可以收集、交易英雄卡牌，并通过策略对战赢取奖励。

## 🏗 技术架构

- **智能合约**：Solidity `^0.8.28`
- **开发框架**：Hardhat
- **前端框架**：Next.js
- **UI 框架**：Tailwind CSS

## 🔥 核心合约

### 🪙 GameToken (GTK)
- **ERC20 标准游戏代币**
- 用于游戏内支付和奖励
- 支持铸造（Mint）和销毁（Burn）功能

### 🃏 HeroCard
- **ERC1155 标准的英雄卡牌 NFT**
- 每张卡牌包含 **名称、战力、费用、特殊能力** 等属性
- 支持 **批量铸造和转移**

### 🏪 Market
- **英雄卡牌交易市场**
- 支持 **挂单、撤单、修改价格、购买** 功能
- 使用 **GTK 代币** 进行交易

### ⚔️ Battle
- **卡牌对战系统**
- 支持 **押注与 Snap 机制**
- 基于 **状态哈希** 进行游戏状态管理

## 🚀 本地开发

### 1️⃣ 安装依赖
```bash
npm install
```

### 2️⃣ 编译智能合约
```bash
npx hardhat compile
```

### 3️⃣ 运行测试
```bash
npx hardhat test
```

### 4️⃣ 启动本地区块链节点
```bash
npx hardhat node
```

### 5️⃣ 部署合约至本地节点
```bash
npx hardhat run scripts/deploy.js --network localhost
```

### 6️⃣ 启动前端应用
```bash
npm run dev
```

## 🎯 主要功能

### 🔹 代币系统
- GTK 游戏代币管理
- 代币奖励机制

### 🔹 卡牌系统
- 英雄卡牌铸造
- 卡牌属性管理
- 卡牌所有权转移

### 🔹 交易市场
- 卡牌挂单交易
- 价格管理
- 交易历史查询

### 🔹 对战系统
- 游戏创建与加入
- 押注与 Snap 机制
- 游戏状态管理
- 奖励分配

## 🤝 贡献指南

欢迎任何形式的贡献！请按照以下步骤进行：

1. **Fork 本项目**
2. **创建特性分支** (`git checkout -b feature/AmazingFeature`)
3. **提交更改** (`git commit -m 'Add some AmazingFeature'`)
4. **推送到分支** (`git push origin feature/AmazingFeature`)
5. **提交 Pull Request**

## 📜 许可证

本项目采用 **MIT 许可证**，详情请见 [LICENSE](LICENSE) 文件。

---
✨ **加入我们，一起打造最酷的区块链卡牌游戏！** 🚀