# pin-wx-linkup-game

**Repository Path**: code0307/pin-wx-linkup-game

## Basic Information

- **Project Name**: pin-wx-linkup-game
- **Description**: 微信小游戏-矿物质连连看游戏
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-08-31
- **Last Updated**: 2026-08-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 矿物质连连看游戏

一款基于连连看玩法的微信小游戏，玩家通过连接相同矿物质元素消除方块，完成四关关卡挑战，收集矿物质元素并在包裹兑换产品奖励。

## 🎮 游戏特色

- **四关关卡设计**: 4x4、6x6、8x8、10x10 网格布局
- **10种矿物质元素**: 钙、铁、锌、镁、硒、钾、钠、磷、铜、碘
- **元素收集系统**: 完成关卡随机掉落元素，可兑换产品
- **6款可兑换产品**: 元素TA能、元素乳伴、元素植饮、元素润本、元素活力饮、新產品
- **自定义概率**: 可调整各元素掉落概率
- **科技感UI**: 渐变背景 + 圆角卡片设计

## 🚀 快速开始

### 运行游戏

1. 在微信开发者工具中打开项目目录
2. 点击右上角"编译"按钮
3. 点击"开始游戏"即可开始

详细说明请查看 [QUICKSTART.md](QUICKSTART.md)

### 项目结构

```
├── game.js                      # 游戏入口
├── game.json                    # 游戏配置
├── project.config.json          # 项目配置
├── js/
│   ├── main.js                  # 主循环管理器
│   ├── databus.js               # 全局数据管理
│   ├── config.js                # 配置常量
│   ├── storage.js               # 本地存储封装
│   ├── utils.js                 # 工具函数
│   ├── components/
│   │   └── grid.js              # 连连看棋盘组件
│   ├── managers/
│   │   ├── pathfinder.js        # 路径查找算法
│   │   ├── audio-enhanced.js    # 增强版音频管理器
│   │   ├── resource.js          # 资源管理器
│   │   └── touch.js             # 触摸事件管理
│   └── scenes/
│       ├── game.js              # 游戏场景
│       ├── shop.js              # 包裹场景
│       └── settings.js          # 设置场景
├── audio/                       # 音频资源（可选）
├── images/                      # 图片资源（可选）
└── docs/                        # 项目文档
```

## 🎯 游戏规则

### 关卡系统
| 关卡 | 网格 | 总元素 | 时间限制 |
|------|------|--------|----------|
| 第一关 | 4×4 | 16 | 3分钟 |
| 第二关 | 6×6 | 36 | 3分钟 |
| 第三关 | 8×8 | 64 | 3分钟 |
| 第四关 | 10×10 | 100 | 3分钟 |

### 胜利条件
- 消除所有元素即可过关
- 两个相同元素可以通过0-2个拐角连接
- 时间耗尽则游戏结束

### 元素收集
- 每关完成后随机掉落2个元素
- 收集的元素可在包裹中查看详情
- 使用收集的元素可以兑换产品

### 产品兑换
| 产品 | 所需元素 |
|------|---------|
| 元素TA能 | 钾(1) + 钙(1) |
| 元素乳伴 | 钾(1) + 钙(1) + 钠(1) |
| 元素植饮 | 碘(1) + 磷(1) + 铁(1) |
| 元素润本 | 硒(1) + 锌(1) + 铜(1) + 镁(1) |
| 元素活力饮 | 钙(1) + 镁(1) |
| 新產品 | 钙(1) + 铁(1) + 锌(1) |

## 📚 文档

- [QUICKSTART.md](QUICKSTART.md) - 快速启动指南
- [docs/IMPLEMENTATION_GUIDE.md](docs/IMPLEMENTATION_GUIDE.md) - 实现指南
- [docs/IMPLEMENTATION_STATUS.md](docs/IMPLEMENTATION_STATUS.md) - 实现状态报告
- [docs/AUDIO_INTEGRATION.md](docs/AUDIO_INTEGRATION.md) - 音频集成文档
- [audio/README.md](audio/README.md) - 音频资源说明

## 🛠️ 技术栈

- **框架**: 微信小游戏原生 API
- **渲染**: Canvas 2D
- **语言**: JavaScript (ES6+)
- **存储**: 微信小程序本地存储
- **音频**: InnerAudioContext

## ✨ 核心功能

### 连连看算法
- ✅ 直连检测（0个拐角）
- ✅ 单拐角检测（1个拐角）
- ✅ 双拐角检测（2个拐角）
- ✅ 路径可视化动画

### 元素系统
- ✅ 10种矿物质元素
- ✅ 元素详情弹窗
- ✅ 随机掉落系统
- ✅ 自定义掉落概率

### 兑换系统
- ✅ 6款产品
- ✅ 元素库存管理
- ✅ 兑换验证
- ✅ 兑换成功弹窗

### 音频系统
- ✅ 点击/匹配/过关音效
- ✅ 背景音乐
- ✅ 音量控制
- ✅ 静音功能
- ✅ 设置持久化

## 📦 资源文件

### 图片资源（可选）
```
images/minerals/
├── ca.png   (钙)
├── fe.png   (铁)
├── zn.png   (锌)
├── mg.png   (镁)
├── se.png   (硒)
├── k.png    (钾)
├── na.png   (钠)
├── p.png    (磷)
├── cu.png   (铜)
└── i.png    (碘)

images/products/
├── ta-neng.png        (元素TA能)
├── ru-ban.png         (元素乳伴)
├── zhi-yin.png        (元素植饮)
├── run-ben.png        (元素润本)
├── huo-li-yin.png     (元素活力饮)
└── new-product.png    (新產品)
```

### 音频资源（可选）
```
audio/
├── click.mp3   (点击音效)
├── match.mp3   (匹配成功音效)
├── win.mp3     (过关音效)
└── bgm.mp3     (背景音乐)
```

**注意**: 即使没有添加这些资源文件，游戏也能正常运行。系统会使用占位资源。

## 🔧 自定义配置

编辑 `js/config.js` 文件可以自定义：
- 元素掉落概率
- 关卡配置
- 产品信息
- 界面颜色

## 📊 项目状态

- **核心功能**: 100% ✅
- **UI界面**: 100% ✅
- **音频系统**: 100% ✅
- **总体完成度**: 95% ✅

详细实现状态请查看 [docs/IMPLEMENTATION_STATUS.md](docs/IMPLEMENTATION_STATUS.md)

## 🎯 开发说明

本项目使用微信小游戏原生 API 开发，未使用任何第三方框架，性能最优。

### 优势
- ✅ 纯原生 API，性能最佳
- ✅ 无框架依赖，包体小
- ✅ 代码结构清晰，易于维护
- ✅ 完善的错误处理

### 技术亮点
- 对象池管理，减少内存占用
- 图片和音频预加载
- 本地数据持久化
- 优雅的错误处理

## 📝 更新日志

### v1.0.0 (2026-03-03)
- ✅ 完成四关连连看游戏机制
- ✅ 实现10种矿物质元素
- ✅ 完成元素收集系统
- ✅ 完成6款产品兑换系统
- ✅ 实现元素说明弹窗
- ✅ 完成概率设置系统
- ✅ 集成音频系统
- ✅ 完善UI界面

## 📞 问题反馈

如有问题或建议，请通过以下方式反馈：
- 查看项目文档
- 检查微信开发者工具控制台
- 查阅微信小游戏官方文档

## 📄 许可证

本项目仅供学习和参考使用。

---

**祝游戏开发顺利！🎉**