Java炸弹人游戏课程设计实战：拆解源码、游戏循环与碰撞检测

简介一份基于Java经典炸弹人玩法的完整源码包定位为计算机相关专业课程设计或毕业设计项目也适合Java初学者在Swing游戏开发中进阶学习。项目覆盖游戏启动、地图构建、玩家移动、怪物AI、炸弹爆炸与道具交互等核心逻辑整体结构按src源码、bin编译结果与游戏素材划分运行后即可体验完整对局流程。压缩包共37个文件包含9个Java源文件、12个编译后的class文件、jpg/png/gif格式的界面素材以及README.md说明文档和Eclipse工程配置整体仅394KB轻量小巧、易于查看。目前已有102人下载学习项目代码经过测试运行成功答辩评审平均分达96分可直接参考其界面布局、碰撞检测与多线程处理思路并在此基础上扩展关卡、音效或联机模式是动手实践与毕业答辩准备的实用示例。1. 拿到java炸弹人游戏.zip之后先确认它在你的课程设计里值多少分很多同学接触java炸弹人游戏.zip是在课程设计或期末大作业的节点解压、跑通然后就觉得完事了。答辩时老师问“地图怎么加载”“炸弹爆炸范围怎么算”“为什么用线程不用Timer”一旦答不上来分数就锁死在及格线附近。这个标题看着是个现成游戏实际是一份典型的java课程设计案例源码覆盖面向对象、事件分发、线程循环和资源打包四个考点。下面按拿到源码后的路径来拆先拆结构再复刻核心循环处理高频翻车点最后讲验证和扩展。适合正在写Java课程设计、准备Java基础面试题复盘或想把Swing游戏写规范的人。2. 拆解炸弹人的代码骨架先画类图再动手改很多拿到手的包会把逻辑全写进一个JPanel类里类名可能叫GamePanel或者BombmanPanel。这种写法不是不能跑而是后续加道具、加敌人时一个文件会被改到上千行。我一般会建议把整个项目按三个角色切地图数据负责“在哪能走”玩家和敌人负责“在动”炸弹链负责“爆炸后改变地图”。地图是炸弹人游戏的根基常用二维int数组存储数组下标就是行列坐标值代表格子类型。值含义行为0空地玩家和敌人可以走1固定墙体不可摧毁、不可穿越2可毁砖块被炸弹炸毁后变03敌人出生点关卡开始时生成敌人4终点/出口可触发过关逻辑地图文件通常放在resources/maps/level1.txt这比在代码里用二维数组字面量写灵活太多换关只换文件不用改源码。第5章会专门讲关卡文本的解析这里先记住一个原则凡是会改的数据都进文件代码只负责解析和渲染。这个分层在答辩时很好用因为老师会问“如果要做10个关卡怎么办”答案就是“加文件不改代码”。2.1 从Main到GamePanel窗口初始化与事件分发一个炸弹人程序的最小入口其实很短难的是后面的状态更新。核心主类通常负责创建JFrame并把GamePanel塞进去。下面这个BombmanMain是很多版本包的常见形态public class BombmanMain { public static void main(String[] args) { JFrame frame new JFrame(炸弹人); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setResizable(false); GamePanel panel new GamePanel(); frame.add(panel); frame.pack(); frame.setLocationRelativeTo(null); frame.setVisible(true); panel.start(); } }逻辑说明frame.add(panel)之后先pack()再setVisible(true)这样面板在首次绘制时尺寸已经确定不会出现白屏或元素错位。setResizable(false)是Swing 2D游戏的常见选择因为地图按固定tileSize绘制窗口大小变了碰撞检测会乱与其做缩放适配不如直接锁死尺寸。setLocationRelativeTo(null)让窗口居中这在答辩演示时观感好很多。最后panel.start()是启动游戏循环的入口不是构造函数里启动是为了保证窗口可见后再跑线程避免线程已经跑起来而绘制目标还没显示。注意如果GamePanel没有重写getPreferredSize()pack()会把窗口缩成最小。很多包会在构造函数里写setPreferredSize(new Dimension(cols * TILE_SIZE, rows * TILE_SIZE))这个方法和JFrame.pack配合使用才能得到正确窗口大小。2.2 把炸弹和玩家拆成对象后面少改一半代码Player类在课程设计里不必做得很重但至少把坐标、方向、速度、可放置炸弹数拆成独立字段。典型的核心代码长这样public class Player { private int x, y; // 像素坐标左上角 private int direction; // 0上 1下 2左 3右 private int speed 2; // 每帧移动像素 private int maxBomb 1; // 同时最多放置数量 private boolean alive true; public Rectangle getBounds() { return new Rectangle(x, y, TILE_SIZE, TILE_SIZE); } public void knockBack() { alive false; } }参数说明x和y用像素坐标地图数组用行列坐标两套坐标通过TILE_SIZE换算不要混用。speed2表示每次更新移动2像素如果tileSize是48像素从一块格子中间走到另一块格子中间大约需要24帧整体手感偏稳。maxBomb设为1是为了前期关卡控制难度后期通过拾取道具增加。direction不只是画朝向还决定放置炸弹后玩家能跑开的初始方向很多迟缓手感都是这个值没处理好。Bomb对象要做的事比Player多一些还要记录归属玩家、放置时间、爆炸范围。对象化之后道具“炸弹数量1”只需要改maxBomb字段敌人“踩到火焰陷阱”只需监听Bomb爆炸事件。如果你在存档或暂停功能里要复制玩家状态记得用对象深度拷贝而不是直接赋值引用否则复活道具改了一个对象另一个也会跟着变。把这个结构理顺后后续加功能基本只是加类不重写已有逻辑这也是面向对象编程java里最常被考察的“开闭原则”的落地形态。2.3 键盘事件在GamePanel里做状态标记而不是直接移动很多初版包的翻车点就在这里在keyPressed里直接改player.x结果按键一松开角色就停还容易出现连按跳变。正确做法是把按键状态存成布尔数组真正的移动留给游戏循环里的update方法处理。下面这段放在GamePanel里private final boolean[] keys new boolean[256]; public void initKeyListener() { setFocusable(true); addKeyListener(new KeyAdapter() { Override public void keyPressed(KeyEvent e) { keys[e.getKeyCode()] true; } Override public void keyReleased(KeyEvent e) { keys[e.getKeyCode()] false; } }); } public void update() { int dx 0, dy 0; if (keys[KeyEvent.VK_UP]) dy -player.getSpeed(); if (keys[KeyEvent.VK_DOWN]) dy player.getSpeed(); if (keys[KeyEvent.VK_LEFT]) dx -player.getSpeed(); if (keys[KeyEvent.VK_RIGHT]) dx player.getSpeed(); player.move(dx, dy, map, TILE_SIZE); }逻辑说明keys数组用键码做下标按下置true松开置false。update每帧读取状态而不是依赖按键事件精确对齐移动节奏这样即使键盘事件频率和帧率不一致角色移动也是平滑的。把移动逻辑写进Player.move而不是在GamePanel里直接改坐标是为了下一节碰撞检测能统一收口。参数上speed如果设成2按住方向键时每帧移动2像素如果设成4移动变快但碰撞检测的步长变大容易在高速下穿墙。一般建议固定帧率下speed不超过tileSize/12这样贴墙时不会出现肉眼可见的瞬移。这个点也常出现在java基础面试题里事件源、事件对象和监听器分别是谁答一遍比背八股文管用。3. 复刻游戏循环与碰撞检测把“能跑”变成“跑得稳”代码能跑之后下一步就是回答“为什么角色移动不跟手”。这是炸弹人游戏里体感最直接的部分。常见做法是用一个后台线程每帧调用一次面板更新和重绘或者用javax.swing.Timer定时触发。两种方式在课程设计级别都可行但我更推荐后台线程理由下面细讲。3.1 游戏循环线程Thread.sleep和Swing Timer的差别Swing Timer适合做闹钟式的UI任务比如倒计时闪烁、道具闪烁提示因为它天然跑在EDT事件线程上刷新界面不需要额外同步。而炸弹人这种需要精确控制移动速度和帧率的循环更适合用后台线程。如果放在EDT里做耗时计算界面会在计算期间卡住行动作一快就出现掉帧。下面是一个最小可用的循环线程实现public class GameEngine implements Runnable { private final GamePanel panel; private volatile boolean running true; public GameEngine(GamePanel panel) { this.panel panel; } Override public void run() { final int FRAME_INTERVAL 16; // 约60帧 long last System.nanoTime(); while (running) { long now System.nanoTime(); panel.update(); panel.repaint(); long used (now - last) / 1_000_000L; long delay FRAME_INTERVAL - used; if (delay 0) { try { Thread.sleep(delay); } catch (InterruptedException e) { Thread.currentThread().interrupt(); return; } } last now; } } public void stop() { running false; } }逻辑说明FRAME_INTERVAL取16毫秒换算约60帧。每次更新后计算实际耗时used用delay补足剩下的时间而不是每一帧都sleep固定16ms这样能避免系统时钟漂移带来的误差。running用volatile修饰是因为它在另一个线程比如窗口关闭监听里被改成false主循环线程需要及时看到变化。面板的update方法里做真正的逻辑更新玩家移动、炸弹计时、敌人AIrepaint只管把最新状态画上去。需要注意update和repaint都不能做重活图片缩放这类操作尽量在初始化时完成。3.2 碰撞检测的顺序先算目标格再给玩家留一像素人情炸弹人的碰撞只发生在玩家和墙体/砖块之间不像动作游戏要考虑弹性碰撞。实现思路有两种一种是先算出新坐标再看新坐标所在格子是否可进入另一种是把体形简化成矩形用Rectangle.intersects判断。课程设计里我喜欢先用格子判断因为地图本身是网格格子判断简单且不容易出边界错乱。但只检测左上角一个点会让玩家半个身子卡进墙里所以要把玩家占的格子范围全查一遍private boolean isBlocked(int newX, int newY, int[][] map, int tileSize) { if (newX 0 || newY 0) { return true; } int maxRow map.length - 1; int maxCol map[0].length - 1; int left newX / tileSize; int right (newX Player.SIZE - 1) / tileSize; int top newY / tileSize; int bottom (newY Player.SIZE - 1) / tileSize; if (left 0 || right maxCol || top 0 || bottom maxRow) { return true; } for (int r top; r bottom; r) { for (int c left; c right; c) { int v map[r][c]; if (v 1 || v 2) { return true; } } } return false; }参数说明Player.SIZE是玩家的像素边长这里按完整占满一个格子处理简化计算。newX和newY是移动后的左上角坐标除以tileSize得到行列。检测范围内的每个格子值是1固定墙或2可毁砖块都算阻挡。这样玩家每次移动前先把目标位置做一次碰撞判定只有不阻挡才更新坐标。一个容易忽略的小坑是speed不能取得比tileSize小很多否则玩家贴近墙时会出现隔墙移动的观感一般取tileSize的四分之一左右比如tileSize48时speed设为2配合边界对齐。3.3 炸弹爆炸范围计算四个方向各自走几格爆炸范围看起来复杂本质是从炸弹所在格子出发沿上下左右四个方向各自检查可波及格子碰到墙体就停。下面是炸开一个方向的最小逻辑private void explodeDirection(int row, int col, int dr, int dc, int range, int[][] map) { for (int i 1; i range; i) { int nr row dr * i; int nc col dc * i; if (nr 0 || nc 0 || nr map.length || nc map[0].length) break; if (map[nr][nc] 1) break; // 固定墙挡住 if (map[nr][nc] 2) { // 可毁砖块炸毁并停止 map[nr][nc] 0; break; } map[nr][nc] 9; // 9表示火焰 } }参数说明dr和dc取值组合(0,1)、(0,-1)、(1,0)、(-1,0)分别代表右、左、下、上四个方向。range来自炸弹的爆炸范围属性初始默认1或2吃到道具后加1。碰到固定墙直接停止遇到可毁砖块把砖块改成0并停止空地则继续向下一个格子传播。火焰标记为9在一段动画帧数后由主循环清回0。这个逻辑独立于渲染就算炸弹位置贴着墙也不会有爆炸穿墙的问题。调用时分别传入四次dr/dc组合即可火焰是否会同时伤害到玩家和敌人取决于爆炸后检查角色矩形是否与火焰格子相交这个判断放到主循环里统一做避免Bomb直接引用Player和Enemy导致耦合。4. 避坑Swing炸弹人的四个高频翻车点与修复方案这一章里全是血泪经验。下面四个问题几乎每个把java炸弹人游戏.zip跑起来的人都会撞上至少一个。有些在IDE里不会暴露换成打包后的jar就现出原形有些反过来IDE里卡成幻灯片打包到别的机器却好一点。按“现象 → 原因 → 解决”的顺序说。4.1 图片不显示路径大小写和资源目录的玄学现象窗口能正常弹出地图格子也在但玩家、砖块、炸弹全是空白方块。最常见的错误是代码里写ImageIcon(images/player.png)而实际目录叫resources/images/player.png或者文件名大小写不一致比如Png和png。原因在于Swing对资源加载有两种方式new File相对路径依赖“当前工作目录”IDE里设置对了就能跑换一台机器或打成jar就找不到而getResource是相对classpath搜索不依赖工作目录。解决方法是统一走资源流的加载方式public class ResourceLoader { public static Image loadImage(String path) { URL url ResourceLoader.class.getResource(path); if (url null) { throw new IllegalArgumentException(图片不存在: path); } return new ImageIcon(url).getImage(); } }参数说明path推荐写成“/images/player.png”这种以斜杠开头的格式表示从classpath根目录开始找。加载必须保证文件名大小写与实际完全一致Windows下大小写不敏感容易掩盖问题Linux服务器上跑打包jar时立刻暴露。这类坑不是逻辑错误属于路径玄学写一个ResourceLoader把所有加载都收口能少排查很多莫名其妙的问题。4.2 键盘没反应或一卡一卡先查Focus再查事件现象游戏窗口出来了鼠标也能点但按方向键角色不动或者能走但明显一顿一顿像按键没被及时处理。原因有两层第一层是JPanel默认不可聚焦KeyListener挂在panel上但焦点不在panel上按键事件根本没到监听器第二层是事件处理方式不对比如在keyPressed里直接改坐标按住方向键时系统键盘自动重复触发导致移动节奏忽快忽慢。解决在初始化里加两行代码。setFocusable(true); requestFocusInWindow();同时把按键处理改成第2章的keys数组方案不在keyPressed里直接改坐标。如果是更复杂的UI比如暂停菜单里有JButton按钮抢走焦点后方向键会失效一种更稳妥的做法是改用KeyBindingsInputMap/ActionMap把“向上”这种动作绑定到组件上不需要手动管焦点。但课程设计用到这个程度的不多先保证setFocusable和requestFocusInWindow不丢即可。4.3 窗口关闭后进程还在跑线程忘了停现象游戏里点右上角红叉窗口消失了但IDE控制台里程序还在运行进度条不结束需要手动点停止按钮。原因JFrame.EXIT_ON_CLOSE只能让JVM在“没有其他非守护线程”的情况下退出。你的GameEngine游戏循环线程是普通线程窗口关闭并不会自动把它结束于是线程在后台继续跑update和repaint。解决不要只依赖EXIT_ON_CLOSE在窗口关闭事件里手动调用线程的stop方法。frame.addWindowListener(new WindowAdapter() { Override public void windowClosing(WindowEvent e) { engine.stop(); } });engine.stop()里会设置runningfalse游戏循环的while条件不满足后自然退出。注意stop不能写成Thread.stop()那个方法已经废弃强制终止线程可能让地图数据或玩家状态停留在半更新状态下次启动读到脏数据。用volatile标志位协停是最稳妥的做法。如果你在程序里还开了Swing Timer也要在stop里把Timer停掉否则事件线程会一直排队。4.4 环境变量和编译版本导致“找不到主类”现象双击打包好的jar提示“找不到主类”或“Failed to load Main-Class manifest attribute”或者在命令行执行javac时报“源发行版17需要目标发行版17”这类提示。原因前者是MANIFEST.MF里的Main-Class没写对或者入口类名带了package但写成了简单类名后者是机器上的JAVA_HOME指向JDK 17而项目的代码是按Java 8或11写的编译时默认使用当前JDK的release版本。解决先检查环境变量配置在命令行分别执行java -version和javac -version确认两个命令来自同一个JDK如果版本不匹配把JAVA_HOME和PATH指到实际想用的JDK目录。编译时建议直接指定向后兼容版本javac --release 11 -encoding UTF-8 -d out src/com/bombman/Main.java参数说明--release 11既指定了源版本也指定了目标版本避免“源发行版”和“目标发行版”不一致的报错-encoding UTF-8防止源码里的中文注释在Windows默认GBK下编译乱码。双击jar前先确认MANIFEST里的Main-Class是全限定名比如com.bombman.Main而不是Main。这件事是java基础面试题里的老面孔但很多人真的到了打包这天才会想起来查。5. 资源与打包把源码zip变成对方双击就能跑的样子拿到源码zip的最终目标是交付不是自己在IDE里玩通。搬到另一台电脑、换一个JDK版本、不再依赖IDE的运行配置还能正常跑才算真的做完。这一章解决两件事关卡和图片资源怎么放以及怎么打出一个双击就能跑的jar。5.1 关卡文本格式用txt当关卡编辑器地图做成文本的好处前面提过改关卡不用重写代码。常见的格式是每行代表一行地图数字用空格隔开支持#注释。示例片段如下# level1 1 1 1 1 1 1 1 1 0 3 0 2 4 1 1 2 0 2 0 2 1 1 0 2 2 2 0 1解析代码放在一个单独的工具方法里资源路径统一走classpathprivate int[][] loadMap(String path) { Listint[] rows new ArrayList(); try (BufferedReader br new BufferedReader( new InputStreamReader( ResourceLoader.class.getResourceAsStream(path), StandardCharsets.UTF_8))) { String line; while ((line br.readLine()) ! null) { if (line.isBlank() || line.startsWith(#)) { continue; } String[] parts line.trim().split(\\s); int[] row new int[parts.length]; for (int i 0; i parts.length; i) { row[i] Integer.parseInt(parts[i]); } rows.add(row); } } catch (IOException e) { throw new RuntimeException(地图加载失败: path, e); } return rows.toArray(new int[0][]); }逻辑说明getResourceAsStream按classpath根找文件路径写成“/maps/level1.txt”。BufferedReader按行读isBlank跳过空行startsWith(#)跳过注释行按空白字符拆分后转成int数组并汇入List最后转二维数组。这个解析方法的地图行列数不固定只要所有行宽度一致即可。参数说明split(\s)而不是split( )可以处理行首空格、多个连续空格和Tab混用指定UTF-8是为了防止Windows记事本保存的GBK编码在Linux打包环境下乱码。5.2 统一资源加载工具类让图片加载不在jar里翻车在IDE里跑得好好的打包成jar后图片消失十有八九是用了new File读取图片。jar包内部根本没有独立的图片文件所有资源都以条目形式存在必须通过getResourceAsStream读取。统一收口到ResourceLoader里后续所有类都从这里取资源。public class ResourceLoader { private ResourceLoader() {} public static Image loadImage(String path) { URL url ResourceLoader.class.getResource(path); if (url null) throw new IllegalArgumentException(图片不存在: path); return new ImageIcon(url).getImage(); } public static String loadText(String path) { try (InputStream in ResourceLoader.class.getResourceAsStream(path)) { if (in null) throw new IllegalArgumentException(文本不存在: path); return new String(in.readAllBytes(), StandardCharsets.UTF_8); } catch (IOException e) { throw new RuntimeException(e); } } }逻辑说明loadImage返回java.awt.Image可以直接交给drawImage方法绘制。loadText适合小尺寸文本文件比如地图、存档、说明调用方拿到字符串后自行按行解析。参数说明如果项目要求Java 8readAllBytes这个方法不存在需要改成ByteArrayOutputStream循环读取的写法。路径上注意getResource和getResourceAsStream的区别getResource通常在图片加载时需要URLgetResourceAsStream适合读文本流。课程设计里图片资源量通常不大统一走这个工具类后打包jar基本不会再出图片路径问题。5.3 编译打包命令从源码目录到可运行JAR我习惯在项目根目录用命令行手动打一次jar因为IDE的导出功能有时会悄悄丢掉资源文件。以下命令假设源码在src/com/bombman下资源在resources下javac --release 11 -encoding UTF-8 -d out \ src/com/bombman/Main.java \ src/com/bombman/GamePanel.java \ src/com/bombman/model/*.java jar cfe bombman.jar com.bombman.Main \ -C out . \ -C resources .参数说明cfe里的c表示创建新jarf指定输出文件名bombman.jare指定入口类全限定名com.bombman.Main。后面用两个-C参数切换目录先把out目录下的编译产物加入jar根再把resources目录下的图片和地图加入jar根这样代码里的“/images/player.png”和“/maps/level1.txt”路径在jar内依然有效。最后运行验证java -jar bombman.jar注意jar包里的资源路径没有“当前工作目录”这个概念所有资源必须从classpath根开始找。如果你在代码里写了new File(images/player.png)打出来的jar十有八九缺图片。如果在打包后遇到“找不到主类”多半是入口类名写成了不带package的Main或者在jar命令的e参数里把包名写错了。检查的方法是在jar文件上用jar tf bombman.jar查看条目路径确认class文件在com/bombman目录下并且resources里的图片被打进了根目录。5.4 打包前值得补的课程设计亮点如果这是要交的课程设计我建议在打包前补三个最简单但加分明显的点新的关卡多做一两个level地图文件并在通关后切换证明你的关卡加载是数据驱动的。道具效果炸毁砖块后掉落加速道具玩家拾取后speed1直观展示对象化设计。分数统计炸一个砖加10分击败敌人加50分在面板角落实时显示。这三个点都不涉及复杂算法但每加一个都要重新跑一遍完整流程验证别只测“能启动”就交差。下一章就讲一个比较稳的验证思路。6. 进阶验证给炸弹人加新功能前如何先证明老功能没坏在扩展功能前先把“能跑”变成一个可重复验证的事。游戏不像业务系统有清晰接口很容易出现“改了一个敌人数值结果炸弹爆炸判定跟着变了”的连锁翻车。所以我的习惯是每个新功能都留一个最小验证入口。6.1 道具系统怎么接先定接口再写概率道具可以先定义一个空接口后续所有道具都实现它public interface ItemEffect { void apply(Player player); }生成道具的逻辑放在砖块被炸毁的位置。概率值不要写死在代码里做成GamePanel的字段方便测试时调整。public Item spawnItem(int row, int col) { double p itemDropRate; // 默认0.25测试时按需调整 if (Math.random() p !items.containsKey(row , col)) { SpeedUpItem item new SpeedUpItem(row, col); items.put(row , col, item); return item; } return null; }验证逻辑写一个测试入口把地图初始化好连续炸200块砖统计实际生成的道具数量。如果掉率设0.25200次结果落在45到55之间基本正常如果只有10个说明生成的逻辑里被别的地方拦截了或是items这个Map的key与后续清理逻辑不一致。用统计验证代替“多玩几局看手感”能更快定位问题。6.2 AI敌人加点“威胁感”朝玩家移动的简单算法大多数课程设计里的敌人只会四处乱走和玩家的交互感很弱。一个简单但有效的升级是敌人每隔一段时间切换一次状态在“随机漫游”和“追踪玩家”之间交替。追踪时只沿水平或垂直方向移动避免斜穿墙体public void moveToward(Player target) { int dx target.getX() - x; int dy target.getY() - y; if (Math.abs(dx) Math.abs(dy)) { move(dx 0 ? 1 : -1, 0); } else { move(0, dy 0 ? 1 : -1); } }逻辑说明比较水平距离和垂直距离的绝对值哪个大就优先沿哪个方向走每帧只移动一步这样敌人不会走斜线穿过墙体。move内部复用第3章的isBlocked遇到障碍就返回false敌人在原位置等待下一帧重新决策。参数说明追踪状态的持续时长建议控制在2到3秒用变量记录切换时间戳如果全程追踪第一关的难度就过高了。我以前做过一个很蠢的事把道具掉率设成100%方便测试结果每块砖都被炸掉时掉一个道具玩家根本不用规划路线游戏完全失去节奏。后来我把掉率改成可配置参数加一个简单的统计函数每次改完跑200次看数据再交付。这个习惯救了我好几次希望帮到你。本文还有配套的精品资源点击获取