🎮 Number Bomb - 谁输谁洗碗

中文 | English

一款支持双人对战的猜谜游戏小程序，上线一个月累计注册用户超 3w+

📖 中文文档

📋 目录

项目简介
功能特性
技术栈
快速开始
项目结构
游戏规则
- 猜数字
- 猜颜色
更新日志
技术支持

项目简介

Number Bomb（谁输谁洗碗）是一款在微信小程序平台上运行的双人对战猜谜游戏。游戏包含多种模式，适合朋友聚会、情侣互动等场景。

游戏模式

模式	说明	特点
🎯 本地双人	两名玩家在同一设备上轮流对战	无需网络，即开即玩
🌟 每日挑战	每天一种固定模式，参与全服排名	6种模式轮换，每日限次
🧩 残局解谜	500关单机闯关模式	根据线索推理正确答案
⚔️ 联机对战	实时匹配对战	支持猜数字和猜颜色

功能特性

✅ 多种游戏模式：猜数字、猜颜色、每日挑战、残局解谜
✅ 实时联机对战：基于微信云开发的实时匹配系统
✅ 排行榜系统：全服排行、洗碗王排行、每日挑战排行
✅ 游戏记录：云端保存对战记录，随时查看历史战绩
✅ 用户反馈：内置反馈系统，持续优化游戏体验
✅ 音频系统：Web Audio API 合成音效，无需外部文件
✅ 震动反馈：支持手机震动，增强游戏沉浸感

技术栈

前端框架: 微信小程序原生框架 (WXML + WXSS + JavaScript)
后端服务: 微信云开发 (CloudBase)
数据库: 云开发数据库 (MongoDB)
存储: 云开发存储
实时通信: 微信云开发实时数据推送

快速开始

环境准备

微信开发者工具
微信小程序账号（注册）
开通微信云开发环境

项目配置

1. 配置 AppID

打开 project.config.json 文件，将 YOUR_APPID_HERE 替换为你的小程序 AppID：

{
  "appid": "YOUR_APPID_HERE"
}

获取 AppID：

登录微信公众平台
进入"开发" -> "开发管理" -> "开发设置"
复制"AppID(小程序ID)"

2. 开通云开发

在微信开发者工具中点击"云开发"按钮
按照提示开通云开发环境
记录你的云开发环境 ID

部署云函数

在云函数目录 cloudfunctions/ 中，部署以下云函数：

云函数	功能说明
`saveUser`	保存用户信息到云数据库
`saveRecord`	保存游戏记录到云数据库
`updateRecord`	更新已有游戏记录
`getRecords`	获取用户的游戏记录列表
`getRecordDetail`	获取单条游戏记录详情
`getDailyInfo`	获取每日挑战信息
`startDailyChallenge`	开始每日挑战
`submitDailyResult`	提交每日挑战结果
`getDailyRank`	获取每日挑战排行榜
`getGlobalRank`	获取全服排行榜
`getLoserRank`	获取洗碗王排行榜
`updateWinScore`	更新获胜分数
`updateLoseScore`	更新失败分数
`battleController`	联机对战控制
`cleanupRooms`	清理过期房间
`feedback_api`	用户反馈接口

部署方法：

在微信开发者工具中右键点击云函数文件夹
选择"创建并部署：云端安装依赖"

创建数据库

在云开发控制台的数据库中，创建以下集合：

集合名	用途	权限设置
`users`	存储用户基本信息	用户可读，创建者可写
`records`	存储游戏对战记录	用户可读，创建者可写
`daily_challenges`	存储每日挑战数据	所有用户可读，所有用户可写
`daily_rankings`	存储每日挑战排行榜	所有用户可读，所有用户可写
`global_rankings`	存储全服排行榜	所有用户可读，所有用户可写
`loser_rankings`	存储洗碗王排行榜	所有用户可读，所有用户可写
`rooms`	存储联机对战房间	所有用户可读，所有用户可写
`feedback`	存储用户反馈	用户可读，创建者可写
`puzzle_levels`	存储残局关卡数据	所有用户可读，创建者可写
`puzzle_progress`	存储玩家闯关进度	用户可读，创建者可写

项目结构

number-bomb/
├── cloudfunctions/          # 云函数目录
│   ├── saveUser/           # 保存用户信息
│   ├── saveRecord/         # 保存游戏记录
│   ├── updateRecord/       # 更新游戏记录
│   ├── getRecords/         # 获取记录列表
│   ├── getRecordDetail/    # 获取记录详情
│   ├── getDailyInfo/       # 获取每日挑战信息
│   ├── startDailyChallenge/# 开始每日挑战
│   ├── submitDailyResult/  # 提交挑战结果
│   ├── getDailyRank/       # 获取每日排行榜
│   ├── getGlobalRank/      # 获取全服排行榜
│   ├── getLoserRank/       # 获取洗碗王榜
│   ├── updateWinScore/     # 更新获胜分数
│   ├── updateLoseScore/    # 更新失败分数
│   ├── battleController/   # 联机对战控制
│   ├── cleanupRooms/       # 清理过期房间
│   └── feedback_api/       # 用户反馈接口
├── pages/                   # 页面目录
│   ├── index/              # 首页
│   ├── ranking/            # 排行榜
│   ├── rules/              # 游戏规则
│   ├── names/              # 玩家设置
│   ├── coin/               # 抛硬币
│   ├── secret/             # 设置密码
│   ├── intermission/       # 中场休息
│   ├── game/               # 猜数字游戏
│   ├── result/             # 回合结果
│   ├── victory/            # 胜利结算
│   ├── color-mode/         # 颜色模式选择
│   ├── color-game/         # 猜颜色游戏
│   ├── color-result/       # 颜色回合结果
│   ├── color-victory/      # 颜色胜利界面
│   ├── color-gameover/     # 颜色游戏结束
│   ├── records/            # 历史战绩
│   ├── record-detail/      # 战绩详情
│   ├── feedback/           # 用户反馈
│   ├── daily-game/         # 每日挑战（数字）
│   ├── daily-color/        # 每日挑战（颜色）
│   ├── weekend/            # 周末活动
│   └── puzzle-game/        # 残局解谜
├── utils/                   # 工具函数
│   ├── audio.js            # 音频管理
│   ├── dailyChallenge.js   # 每日挑战工具
│   └── historyManager.js   # 历史记录管理
├── icons/                   # 图标资源
├── images/                  # 图片资源
├── app.js                   # 应用入口
├── app.json                 # 应用配置
├── app.wxss                 # 全局样式
├── project.config.json      # 项目配置
├── project.private.config.json # 私有配置
└── sitemap.json             # 站点地图

游戏规则

猜数字

基本玩法

玩家人数: 2人
游戏目标: 猜中对方设置的4位数字密码

游戏流程

设置密码: 每回合开始，当前玩家设置一个4位数字密码（每位数字0-9，可重复）
轮流猜测: 对方玩家在限定次数内（默认10次）猜测这个数字
猜测提示: 每次猜测后，系统会给出 A/B 提示：
- A (位置对): 数字正确且位置正确
- B (数字对): 数字正确但位置错误
回合结束: 猜中密码或次数用尽，回合结束，交换攻守
比赛结束: 一方先猜中对方密码即获胜

示例

正确答案: 5 2 8 3
玩家猜测: 5 3 7 2
提示结果: 1A2B
- 1A: 数字5位置正确
- 2B: 数字2和3存在但位置不对

猜颜色

基本玩法

玩家人数: 2人
游戏目标: 猜中系统生成的4色颜色组合

可用颜色

共有6种颜色可选：

🔴 红色
🟡 黄色
🔵 蓝色
🟢 绿色
🟣 紫色
🟠 橙色

游戏模式

简单模式: 颜色可以重复（如：红红蓝绿）
困难模式: 颜色不可重复（4个位置颜色都不同）

游戏流程

系统生成密码: 游戏开始时系统生成一个4色密码
轮流猜测: 双方玩家轮流猜测这个颜色组合
猜测提示: 每次猜测后，系统会给出红/白提示：
- 🔴 红色: 颜色正确且位置正确
- ⚪ 白色: 颜色正确但位置错误
回合结束: 猜中密码或次数用尽，游戏结束
比赛结束: 先猜中密码的玩家获胜

更新日志

v1.0.0

✅ 完整的猜数字游戏
✅ 猜颜色游戏模式
✅ 每日挑战系统
✅ 残局解谜闯关
✅ 联机对战功能
✅ 排行榜系统
✅ 用户反馈系统
✅ 游戏记录云端保存

技术支持

如有问题或建议，欢迎联系！

微信号：SURFDUCK
小红书：4682B4

📖 English Documentation

📋 Table of Contents

Introduction
Features
Tech Stack
Quick Start
Project Structure
Game Rules
- Number Guessing
- Color Guessing
Changelog
Support

Introduction

Number Bomb (Who Loses Does the Dishes) is a two-player guessing game mini-program running on the WeChat platform. The game includes multiple modes, suitable for friends gatherings, couples interactions, and other scenarios.

Game Modes

Mode	Description	Features
🎯 Local 2P	Two players take turns on the same device	No network required, play instantly
🌟 Daily Challenge	Fixed mode every day, global ranking	6 modes rotation, limited attempts daily
🧩 Puzzle Mode	500 levels single-player mode	Deduce correct answer based on clues
⚔️ Online Battle	Real-time matchmaking	Support number and color guessing

Features

✅ Multiple Game Modes: Number guessing, color guessing, daily challenge, puzzle solving
✅ Real-time Online Battle: Real-time matching system based on WeChat Cloud Development
✅ Leaderboard System: Global ranking, loser ranking, daily challenge ranking
✅ Game Records: Cloud save battle records, view history anytime
✅ User Feedback: Built-in feedback system, continuously optimizing game experience
✅ Audio System: Web Audio API synthesized sound effects, no external files needed
✅ Vibration Feedback: Support phone vibration, enhance game immersion

Tech Stack

Frontend: WeChat Mini Program Native Framework (WXML + WXSS + JavaScript)
Backend: WeChat Cloud Development (CloudBase)
Database: Cloud Development Database (MongoDB)
Storage: Cloud Development Storage
Real-time Communication: WeChat Cloud Development Real-time Data Push

Quick Start

Prerequisites

WeChat Developer Tools
WeChat Mini Program Account (Register)
Enable WeChat Cloud Development Environment

Configuration

1. Configure AppID

Open project.config.json file, replace YOUR_APPID_HERE with your Mini Program AppID:

{
  "appid": "YOUR_APPID_HERE"
}

Get AppID:

Login to WeChat Official Platform
Go to "Development" -> "Development Management" -> "Development Settings"
Copy "AppID (Mini Program ID)"

2. Enable Cloud Development

Click the "Cloud Development" button in WeChat Developer Tools
Follow the prompts to enable cloud development environment
Record your cloud development environment ID

Deploy Cloud Functions

In the cloud functions directory cloudfunctions/, deploy the following cloud functions:

Cloud Function	Description
`saveUser`	Save user info to cloud database
`saveRecord`	Save game record to cloud database
`updateRecord`	Update existing game record
`getRecords`	Get user's game record list
`getRecordDetail`	Get single game record details
`getDailyInfo`	Get daily challenge info
`startDailyChallenge`	Start daily challenge
`submitDailyResult`	Submit daily challenge result
`getDailyRank`	Get daily challenge leaderboard
`getGlobalRank`	Get global leaderboard
`getLoserRank`	Get loser leaderboard
`updateWinScore`	Update win score
`updateLoseScore`	Update lose score
`battleController`	Online battle control
`cleanupRooms`	Clean up expired rooms
`feedback_api`	User feedback interface

Deployment Method:

Right-click the cloud function folder in WeChat Developer Tools
Select "Create and Deploy: Cloud Install Dependencies"

Create Database

In the cloud development console database, create the following collections:

Collection	Purpose	Permission
`users`	Store user basic info	User readable, creator writable
`records`	Store game battle records	User readable, creator writable
`daily_challenges`	Store daily challenge data	All users readable and writable
`daily_rankings`	Store daily challenge leaderboard	All users readable and writable
`global_rankings`	Store global leaderboard	All users readable and writable
`loser_rankings`	Store loser leaderboard	All users readable and writable
`rooms`	Store online battle rooms	All users readable and writable
`feedback`	Store user feedback	User readable, creator writable
`puzzle_levels`	Store puzzle level data	All users readable and writable
`puzzle_progress`	Store player progress	User readable, creator writable

Project Structure

number-bomb/
├── cloudfunctions/          # Cloud functions directory
│   ├── saveUser/           # Save user info
│   ├── saveRecord/         # Save game record
│   ├── updateRecord/       # Update game record
│   ├── getRecords/         # Get record list
│   ├── getRecordDetail/    # Get record details
│   ├── getDailyInfo/       # Get daily challenge info
│   ├── startDailyChallenge/# Start daily challenge
│   ├── submitDailyResult/  # Submit challenge result
│   ├── getDailyRank/       # Get daily leaderboard
│   ├── getGlobalRank/      # Get global leaderboard
│   ├── getLoserRank/       # Get loser leaderboard
│   ├── updateWinScore/     # Update win score
│   ├── updateLoseScore/    # Update lose score
│   ├── battleController/   # Online battle control
│   ├── cleanupRooms/       # Clean up expired rooms
│   └── feedback_api/       # User feedback interface
├── pages/                   # Pages directory
│   ├── index/              # Home page
│   ├── ranking/            # Leaderboard
│   ├── rules/              # Game rules
│   ├── names/              # Player settings
│   ├── coin/               # Coin toss
│   ├── secret/             # Set password
│   ├── intermission/       # Intermission
│   ├── game/               # Number guessing game
│   ├── result/             # Round result
│   ├── victory/            # Victory settlement
│   ├── color-mode/         # Color mode selection
│   ├── color-game/         # Color guessing game
│   ├── color-result/       # Color round result
│   ├── color-victory/      # Color victory screen
│   ├── color-gameover/     # Color game over
│   ├── records/            # Battle history
│   ├── record-detail/      # Record details
│   ├── feedback/           # User feedback
│   ├── daily-game/         # Daily challenge (number)
│   ├── daily-color/        # Daily challenge (color)
│   ├── weekend/            # Weekend events
│   └── puzzle-game/        # Puzzle solving
├── utils/                   # Utility functions
│   ├── audio.js            # Audio management
│   ├── dailyChallenge.js   # Daily challenge tools
│   └── historyManager.js   # History management
├── icons/                   # Icon resources
├── images/                  # Image resources
├── app.js                   # App entry
├── app.json                 # App config
├── app.wxss                 # Global styles
├── project.config.json      # Project config
├── project.private.config.json # Private config
└── sitemap.json             # Sitemap

Game Rules

Number Guessing

Basic Rules

Players: 2
Goal: Guess the opponent's 4-digit password

Game Flow

Set Password: At the start of each round, the current player sets a 4-digit password (0-9, repeatable)
Take Turns Guessing: The opponent guesses the number within limited attempts (default 10)
Guess Hint: After each guess, the system gives A/B hints:
- A (Position correct): Correct number and correct position
- B (Number correct): Correct number but wrong position
Round End: Round ends when password is guessed or attempts run out, then switch offense/defense
Match End: First player to guess opponent's password wins

Example

Correct answer: 5 2 8 3
Player guess: 5 3 7 2
Hint result: 1A2B
- 1A: Number 5 is in correct position
- 2B: Numbers 2 and 3 exist but wrong position

Color Guessing

Basic Rules

Players: 2
Goal: Guess the system's 4-color combination

Available Colors

6 colors available:

🔴 Red
🟡 Yellow
🔵 Blue
🟢 Green
🟣 Purple
🟠 Orange

Game Modes

Easy Mode: Colors can repeat (e.g., red-red-blue-green)
Hard Mode: Colors cannot repeat (all 4 positions have different colors)

Game Flow

System Generates Password: System generates a 4-color password at game start
Take Turns Guessing: Both players take turns guessing the color combination
Guess Hint: After each guess, the system gives red/white hints:
- 🔴 Red: Correct color and correct position
- ⚪ White: Correct color but wrong position
Round End: Game ends when password is guessed or attempts run out
Match End: First player to guess password wins

Changelog

v1.0.0

✅ Complete number guessing game
✅ Color guessing game mode
✅ Daily challenge system
✅ Puzzle solving levels
✅ Online battle feature
✅ Leaderboard system
✅ User feedback system
✅ Cloud save game records

Support

For questions or suggestions, feel free to contact!

WeChat: SURFDUCK
Xiaohongshu: 4682B4

📄 License

本源码仅供学习交流使用，未经授权不得用于商业用途。

This source code is for learning and communication purposes only, unauthorized commercial use is prohibited.

祝你使用愉快！ | Enjoy the game! 🎮

Name		Name	Last commit message	Last commit date
Latest commit History 3 Commits
cloudfunctions		cloudfunctions
components/intro-tutorial		components/intro-tutorial
icons		icons
images		images
pages		pages
utils		utils
README.md		README.md
app.js		app.js
app.json		app.json
app.wxss		app.wxss
project.config.json		project.config.json
project.private.config.json		project.private.config.json
sitemap.json		sitemap.json

Folders and files

Latest commit

History

Repository files navigation

🎮 Number Bomb - 谁输谁洗碗

📖 中文文档

📋 目录

项目简介

游戏模式

功能特性

技术栈

快速开始

环境准备

项目配置

1. 配置 AppID

2. 开通云开发

部署云函数

创建数据库

项目结构

游戏规则

猜数字

基本玩法

游戏流程

示例

猜颜色

基本玩法

可用颜色

游戏模式

游戏流程

更新日志

v1.0.0

技术支持

📖 English Documentation

📋 Table of Contents

Introduction

Game Modes

Features

Tech Stack

Quick Start

Prerequisites

Configuration

1. Configure AppID

2. Enable Cloud Development

Deploy Cloud Functions

Create Database

Project Structure

Game Rules

Number Guessing

Basic Rules

Game Flow

Example

Color Guessing

Basic Rules

Available Colors

Game Modes

Game Flow

Changelog

v1.0.0

Support

📄 License

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors 1

Languages

Packages