# memory-game

**Repository Path**: gitluan/memory-game

## Basic Information

- **Project Name**: memory-game
- **Description**: 简单记忆游戏
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-30
- **Last Updated**: 2026-05-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🌟 Memory Game 🎴

A fun emoji memory card-matching game with multiple difficulty levels and a leaderboard system.

## 🎮 Game Overview

Memory Game is a classic brain-training puzzle game. Players must find all matching emoji card pairs within a time limit, enjoying an exciting and challenging experience!

### ✨ Key Features

- **🎯 Multiple Difficulty Levels** - Easy, Medium, and Hard difficulty modes
- **📊 Real-time Statistics** - Displays current move count, matched pairs, and timer
- **🏆 Leaderboard System** - Tracks best scores for each difficulty level
- **✨ Beautiful Visual Effects** - Smooth card flip animations and matching effects
- **👤 Player Records** - Supports player name input to save scores

## 🚀 Getting Started

### Play Online

Simply open the `memory-game.html` file in your browser to start playing.

### Run Locally

```bash
# Clone the project
git clone https://gitee.com/gitluan/memory-game.git

# Navigate to directory
cd memory-game

# Open the HTML file in browser
open memory-game.html
# or
xdg-open memory-game.html
```

## 🎯 How to Play

1. **Choose Difficulty** - Click one of the difficulty buttons (Easy/Medium/Hard)
2. **Flip and Match** - Click cards to reveal them and find matching emoji pairs
3. **Challenge Your Score** - Complete all matches within the limited number of moves
4. **Submit to Leaderboard** - Enter your name to save your best score

### Difficulty Levels

| Difficulty | Rows×Columns | Total Pairs |
|------------|--------------|-------------|
| Easy       | 4×3          | 6 pairs     |
| Medium     | 4×4          | 8 pairs     |
| Hard       | 5×4          | 10 pairs    |

## 📁 Project Structure

```
memory-game/
├── memory-game.html          # Main game file (single-file application)
├── docs/
│   ├── superpowers/
│   │   ├── plans/            # Implementation plan documents
│   │   └── specs/            # Design specification documents
└── README.md
```

## 🛠️ Technology Stack

- **HTML5** - Game structure
- **CSS3** - Styling and animations
- **JavaScript** - Game logic
- **localStorage** - Local data storage (leaderboard)

## 🤝 Contribution Guidelines

Issues and pull requests are welcome!

1. Fork this repository
2. Create a feature branch (`git checkout -b feature/xxx`)
3. Commit your changes (`git commit -m 'Add xxx'`)
4. Push to the branch (`git push origin feature/xxx`)
5. Create a pull request

## 📄 License

MIT License

---

**Have fun playing!** 🎉

If a LICENSE file exists in the project, please refer to it for official licensing terms.