C++实战：从零实现泡泡堂小游戏，掌握数组、类与碰撞检测

简介这是一份面向C初学者与课程设计需求者的泡泡堂小游戏完整源码工程适合用来练习面向对象编程、图形绘制与网络通信等综合技能。项目实现了地图与人物绘制、水泡动画效果、鼠标键盘双操作、障碍物碰撞以及泡泡放置爆炸和鞋子、泡泡、药水三类增强道具服务端支持局域网自由对抗与多人同图对战并拓展了房间列表、多张地图和临终礼物等玩法。压缩包共41个文件约1.2MB以11个h头文件与10个cpp源文件构成核心逻辑另含png贴图、ttf字体、sln与vcxproj工程文件及说明文档结构清晰便于二次开发。目前已有497人学习下载读者可从中获取完整的游戏循环、场景切换、道具系统与联机同步实现思路是课程设计或C图形游戏入门时可直接参考的实战范例。1. 从零写一个泡泡堂为什么 C 小游戏是练手的最佳选择很多人第一次想用 C 写游戏脑子里冒出来的都是「贪吃蛇」「俄罗斯方块」这类单文件就能跑完的东西。泡泡堂不太一样——它同时踩中了三个让新手翻车的点网格地图的碰撞判定、定时炸弹的状态机、以及放泡之后连锁爆炸的递归传播。你如果能把泡泡堂写明白C 的数组、指针、类、容器、随机数基本就都过了一遍这比刷一百道八股题实在得多。这篇文章面向的是已经会写for循环、能看懂class和vector但没做过完整小项目的 C 入门者。我会按「地图怎么存 → 玩家怎么动 → 炸弹怎么炸 → 连锁怎么算 → 怎么调」的顺序把每个模块的最小可运行代码和参数含义讲清楚。全程不依赖任何游戏引擎只用标准库加一个控制台或 EasyX 图形库就能跑起来。你跟着敲完手里会有一个能双人对战的泡泡堂原型而不是一堆散落的示例代码。2. 地图与实体建模用二维数组把泡泡堂的格子世界搭起来泡泡堂的地图本质是一个规则网格每个格子只有几种固定状态空地、硬墙永远炸不掉、软箱可以被炸掉、以及临时存在的炸弹和道具。这种「状态有限、位置离散」的场景用二维数组存是最省事也最不容易出错的做法。很多人一上来就想用链表或者四叉树那是给几千个动态实体准备的泡泡堂这种十几乘十几的格子图完全用不上反而增加调试成本。2.1 地图数据结构与格子类型定义我一般会用一个enum把格子类型列全再用一个二维vector存地图。用vector而不是原生数组的好处是尺寸可以在运行时决定方便你后面做不同大小的关卡。#include vector #include iostream // 格子类型0空地 1硬墙 2软箱 3炸弹 4道具 enum CellType { EMPTY 0, HARD_WALL 1, SOFT_BOX 2, BOMB 3, ITEM 4 }; class GameMap { public: int rows, cols; std::vectorstd::vectorint grid; GameMap(int r, int c) : rows(r), cols(c) { // 初始化边界和偶数行偶数列放硬墙其余随机放软箱 grid.assign(rows, std::vectorint(cols, EMPTY)); for (int i 0; i rows; i) { for (int j 0; j cols; j) { if (i 0 || j 0 || i rows - 1 || j cols - 1) grid[i][j] HARD_WALL; else if (i % 2 0 j % 2 0) grid[i][j] HARD_WALL; else if (rand() % 100 70) // 70% 概率生成软箱 grid[i][j] SOFT_BOX; } } } bool isWalkable(int x, int y) const { if (x 0 || y 0 || x rows || y cols) return false; return grid[x][y] EMPTY || grid[x][y] ITEM; } };这段代码里有两个参数值得你动手改一改看效果。一个是软箱生成概率70调低到 30 地图会空旷很多适合快速测试移动逻辑调高到 90 几乎走不动路能帮你验证碰撞判定是否严密。另一个是硬墙的分布规则i % 2 0 j % 2 0这是经典泡泡堂的棋盘格布局保证任意两个硬墙之间至少有一条通道。如果你把这一行去掉地图会变成完全随机可能出现玩家被软箱围死的情况调试时反而更麻烦。isWalkable这个函数是后面所有移动和爆炸判定的基础它把「能不能走进去」这件事收敛到一个地方。新手常犯的错误是在移动代码里直接写grid[x][y] ! HARD_WALL结果炸弹放下去之后玩家还能从炸弹上走过去逻辑就乱了。统一走isWalkable后面加炸弹阻挡只需要改这一个函数。2.2 玩家与炸弹实体的类设计地图是静态的玩家和炸弹是动态的这两类东西要分开管。玩家需要知道自己的坐标、生命值、当前炸弹威力炸弹需要知道倒计时、威力范围、以及是谁放的防止自己刚放完就被自己炸死。class Player { public: int x, y; int bombPower; // 爆炸范围单位是格 int bombCount; // 同时可放置的炸弹数 bool alive; Player(int startX, int startY) : x(startX), y(startY), bombPower(2), bombCount(1), alive(true) {} void move(int dx, int dy, const GameMap map) { int nx x dx, ny y dy; if (map.isWalkable(nx, ny)) { x nx; y ny; } } }; class Bomb { public: int x, y; int ownerId; // 放置者的编号 int timer; // 剩余倒计时单位是帧或毫秒 int power; // 爆炸范围 Bomb(int bx, int by, int owner, int p) : x(bx), y(by), ownerId(owner), timer(180), power(p) {} };timer初始值180是我习惯用的数字按 60 帧每秒算正好 3 秒和原版泡泡堂手感接近。你如果觉得太慢可以改成 120但别低于 60否则玩家来不及跑出爆炸范围体验会很差。bombPower默认给 2 意味着爆炸向四个方向各延伸 2 格这个值后面可以通过吃道具增加。这里有个设计上的取舍炸弹的timer我放在Bomb类里自己倒数而不是用一个全局计时器统一管理。好处是每个炸弹独立加新炸弹不用改全局逻辑坏处是炸弹多了之后每帧要遍历所有炸弹做减法。泡泡堂同屏炸弹通常不超过 20 个这点开销可以忽略所以选简单的方案。3. 移动、放泡与爆炸判定泡泡堂核心交互的实现细节地图和实体搭好之后真正让游戏「活」起来的是三件事玩家按键移动、按空格放炸弹、炸弹倒计时结束后炸开并影响地图。这三件事的触发时机和判定顺序如果搞错就会出现「人穿墙」「炸弹炸不掉箱子」「连锁爆炸漏格」这些经典 bug。下面按执行顺序拆开讲。3.1 键盘输入与逐帧移动循环控制台程序没有事件循环我一般用一个while主循环加_kbhit()做非阻塞检测。如果你用 EasyX 图形库逻辑一样只是输入函数换成peekmessage。核心思路是每帧只处理一次输入然后更新所有炸弹计时器最后重绘。#include conio.h #include windows.h void gameLoop(GameMap map, Player p1, Player p2, std::vectorBomb bombs) { bool running true; while (running) { // 1. 处理输入 if (_kbhit()) { int ch _getch(); if (ch w) p1.move(-1, 0, map); if (ch s) p1.move(1, 0, map); if (ch a) p1.move(0, -1, map); if (ch d) p1.move(0, 1, map); if (ch ) { // 放炸弹检查当前格没有炸弹且数量未超限 bool occupied false; for (auto b : bombs) if (b.x p1.x b.y p1.y) occupied true; if (!occupied (int)bombs.size() p1.bombCount) { bombs.emplace_back(p1.x, p1.y, 0, p1.bombPower); map.grid[p1.x][p1.y] BOMB; } } if (ch 27) running false; // ESC 退出 } // 2. 更新炸弹倒计时 for (auto it bombs.begin(); it ! bombs.end(); ) { it-timer--; if (it-timer 0) { explode(map, *it, bombs); it bombs.erase(it); } else { it; } } Sleep(16); // 约 60 帧每秒 } }Sleep(16)这个数字决定了游戏节奏16 毫秒对应约 62 帧每秒是 Windows 下比较稳的值。你如果设成Sleep(1)CPU 占用会飙上去但画面并不会更流畅因为控制台刷新本身有上限。放炸弹前检查occupied是必须的否则同一格会叠无数炸弹倒计时一起结束直接把自己炸死。3.2 爆炸范围计算与软箱摧毁爆炸逻辑是整个游戏最容易写错的地方。正确做法是从炸弹位置向上下左右四个方向逐格推进遇到硬墙立刻停止遇到软箱则摧毁该格并停止该方向遇到空地继续延伸直到达到power值。void explode(GameMap map, const Bomb b, std::vectorBomb bombs) { // 炸弹自身格子恢复为空地 map.grid[b.x][b.y] EMPTY; int dirs[4][2] {{-1,0},{1,0},{0,-1},{0,1}}; for (auto d : dirs) { for (int step 1; step b.power; step) { int nx b.x d[0] * step; int ny b.y d[1] * step; if (nx 0 || ny 0 || nx map.rows || ny map.cols) break; if (map.grid[nx][ny] HARD_WALL) break; // 硬墙挡住该方向结束 if (map.grid[nx][ny] SOFT_BOX) { map.grid[nx][ny] EMPTY; // 摧毁软箱 break; // 软箱也挡住不再延伸 } // 空地或道具标记为爆炸区域实际项目里加一个临时爆炸列表 } } }这里break和continue用错是高频 bug。遇到软箱必须break而不是continue因为爆炸不能穿过箱子遇到硬墙同理。只有空地和道具才继续往下一格走。另外注意炸弹自身格子要先恢复成EMPTY否则玩家放完炸弹后那一格永远走不回去。如果你要做连锁爆炸就在explode里检查爆炸路径上是否有其他炸弹有的话把那个炸弹的timer直接设为 0下一帧它就会自然触发。这样不用递归也能实现连锁逻辑更清晰。4. 避坑与排查泡泡堂小游戏开发中最容易翻车的 5 个地方写泡泡堂的过程中有五个问题几乎每个人都会遇到而且现象和原因往往对不上号查起来很费时间。我把它们按「现象 → 原因 → 解决」整理出来你遇到类似情况可以直接对照。现象一玩家能走进软箱和硬墙里面。原因通常是移动判定写成了grid[nx][ny] ! HARD_WALL漏掉了软箱。解决方法是统一用isWalkable函数里面把EMPTY和ITEM之外的所有类型都判为不可走。改完之后记得把炸弹也加进去否则放完炸弹自己能站上去。现象二炸弹爆炸后软箱没消失或者消失的格子不对。这多半是坐标顺序搞反了。grid[x][y]里 x 是行、y 是列而很多人在写方向数组时习惯按笛卡尔坐标(x, y)理解结果dirs里的{-1,0}被当成了列偏移。解决办法是固定一套命名行用row、列用col方向数组写成{dr, dc}从命名上杜绝混淆。现象三连锁爆炸时只炸了第一个后面的炸弹没反应。原因是你在explode里直接删除了炸弹而遍历bombs的循环还在用旧的迭代器。正确做法是爆炸时只把目标炸弹的timer置 0让主循环下一帧统一处理删除。这样既避免了迭代器失效连锁逻辑也变成自然的逐帧传播。现象四游戏跑一会儿就卡顿帧率越来越低。检查一下是不是每帧都在往bombs里push_back但从不清理已爆炸的炸弹。另一个常见原因是Sleep值设得太小导致 CPU 空转。用bombs.erase配合迭代器删除并把Sleep保持在 16 左右基本就能稳住。现象五两个玩家同时放炸弹后放的把先放的覆盖了。这是因为地图格子只有一个BOMB状态无法区分是谁的炸弹。解决办法是地图只负责标记「这里有炸弹」具体归属和倒计时全部由bombs容器管理。判断某格是否有炸弹时遍历bombs而不是查地图这样多个炸弹即使在同一格也能各自独立计时。提示调试爆炸逻辑时把power临时改成 10能一眼看出哪个方向提前断了比逐格打印快得多。5. 从能跑到好玩用随机数、道具和双人对战把原型变成完整小游戏原型跑通之后让它变得「像个游戏」的关键在于节奏和变化。泡泡堂原版之所以耐玩靠的是随机掉落的道具和双人对抗的博弈感。这两块用 C 标准库的随机数和简单的状态标记就能实现不需要额外依赖。5.1 用 C 随机数控制道具掉落软箱被炸掉时有一定概率掉落道具道具类型可以用一个简单的加权随机来决定。C11 之后的random比rand()更可控分布也更均匀。#include random std::mt19937 gen(std::random_device{}()); int rollItem() { std::uniform_int_distribution dis(1, 100); int r dis(gen); if (r 30) return 1; // 30% 增加炸弹威力 if (r 55) return 2; // 25% 增加炸弹数量 if (r 70) return 3; // 15% 增加移动速度 return 0; // 30% 不掉落 }把rollItem的返回值写进地图对应格子玩家走上去时根据类型修改bombPower或bombCount。注意bombPower建议设一个上限比如 8否则后期一炸全屏游戏就没法玩了。bombCount上限 5 左右比较合适再多的话同屏炸弹太多画面会乱。5.2 双人对战与胜负判定双人模式只需要把玩家 2 的按键映射到方向键然后在每帧更新后检查两个玩家的坐标是否落在爆炸区域内。爆炸区域可以在explode时写入一个临时的bool二维数组帧末统一判定。判定项玩家 1玩家 2移动键W/A/S/D方向键放泡键空格回车初始炸弹数11初始威力22生命值11生命值设 1 是为了让对局节奏快一炸就结束。如果你想要更长的对局可以改成 3 条命被炸后回到出生点并短暂无敌 2 秒。无敌的实现方式是在Player里加一个invincibleTimer每帧递减大于 0 时跳过爆炸判定。5.3 一个我常用的调试习惯最后分享一个我写这类小游戏时一直保持的习惯在屏幕角落用std::cout打印当前帧号、炸弹数量、两个玩家的坐标。这个「黑匣子」在排查连锁爆炸和移动卡位时特别有用比单步调试快得多。等游戏稳定了再把这几行注释掉不影响最终效果。写泡泡堂这件事最难的不是某个算法而是把地图、实体、输入、计时这四样东西的更新顺序理顺。顺序对了后面加道具、加 AI、加关卡都是顺水推舟。我自己的经验是第一版别追求画面用控制台字符把逻辑跑通再换 EasyX 或 SFML 做渲染返工成本最低。希望帮到你。本文还有配套的精品资源点击获取