Java手搓超级马里奥：从零实现横版小游戏

简介这是一份基于Java实现的超级马里奥小游戏源码资源面向Java初学者、进阶学习者以及需要课程设计、大作业或毕设项目的学生。项目综合运用了Swing组件、JFrame窗体、事件监听器与多线程等技术通过WASD键控制角色上下左右移动帮助读者在实践中理解图形界面编程与游戏循环的基本思路。压缩包共76个文件约6.93MB包含52个png图片、8个java源码、8个class文件、2个wav音效、2个jar包及2个jpg图片等图片与音频用于游戏素材源码与jar包便于直接运行和二次开发。已有109人学习下载。下载后可在Zhangai类中自定义修改关卡样貌自由度较高适合作为入门练手或项目立项的参考模板帮助读者快速掌握Java桌面游戏开发的核心流程。1. 用 Java 手搓超级马里奥从一张地图到能跑能跳的横版小游戏很多人第一次动念头写超级马里奥不是因为想做大项目而是想搞明白一件事一个能跑、能跳、能踩蘑菇的横版游戏到底是怎么被拆出来的。标题里这三个词——Java、超级马里奥、小游戏——组合起来指向的其实是一个非常适合练手的工程它不依赖引擎纯 Java 就能跑它把面向对象编程、游戏循环、碰撞检测、瓦片地图这些概念全串了一遍它体量可控一个人两三天能出原型一两周能出可玩版本。如果你正在学 Java 基础、想找个能看见画面的项目练手或者面试前想有个能讲清楚的小工程这个方向值得做。下面我按自己实际写过的路径把选型、结构、代码和坑一次讲透。2. 先想清楚技术选型为什么用 Java 而不是引擎2.1 纯 Java Swing/AWT 的边界在哪超级马里奥这类横版卷轴游戏核心需求只有四件事窗口渲染、键盘输入、定时更新、矩形碰撞。这四件事用 JDK 自带的 Swing/AWT 就能全部覆盖不需要引入任何第三方库。常见做法是继承JPanel做画布用Timer或独立线程驱动游戏循环用KeyListener收键盘事件碰撞检测直接退化成两个Rectangle的intersects判断。这套方案的边界也很清楚它适合 2D 像素风、精灵数量在几十到几百、分辨率不超过 1280×720 的场景。再往上比如要粒子特效、要几千个动态实体、要 GPU 加速Swing 的软件渲染就会吃力那时候才需要考虑 LWJGL 或迁移到引擎。但对超级马里奥这个体量Swing 完全够用而且好处是零依赖、零配置javac编译完java就能跑特别适合放进简历或课程设计。选 Java 而不是 Python 或 C理由也很实际Java 的强类型在写游戏实体时能帮你挡掉大量低级错误面向对象的继承体系天然适合表达「所有会动的东西都是 GameObject」这种结构而且 Java 的集合框架、线程模型都是现成的。热搜里常出现的「面向对象编程 java」「java 容器」这些词在这个项目里不是抽象概念是你每天都要用的东西。2.2 项目骨架五个包把职责切开我一般会把代码分成五个包职责边界清晰后面加功能不会乱包名职责典型类core游戏循环、窗口、主入口GameFrame、GamePanelentity所有游戏对象Mario、Goomba、Cointile瓦片地图与地形TileMap、Tileinput键盘状态管理KeyHandlerutil常量、资源加载Constants、ResourceLoader这样切的好处是entity里的类只关心自己的位置、速度和状态不关心怎么渲染到屏幕tile只负责地图数据core负责把两者串起来。等你后面要加新敌人只需要在entity里加一个类不用动其他包。2.3 游戏循环固定时间步长是稳定性的关键游戏循环是整个项目的心脏。新手最容易翻车的地方就是直接用while(true)里Thread.sleep(16)结果在不同机器上速度完全不一样。正确做法是固定时间步长fixed timestep逻辑更新和渲染解耦// GamePanel.java 核心循环片段 private static final double UPDATE_RATE 60.0; // 每秒逻辑更新次数 private static final double UPDATE_INTERVAL 1_000_000_000 / UPDATE_RATE; // 纳秒 Override public void run() { double delta 0; long lastTime System.nanoTime(); while (running) { long now System.nanoTime(); delta (now - lastTime) / UPDATE_INTERVAL; lastTime now; // 累积到一次完整更新才执行逻辑避免帧率波动影响速度 while (delta 1) { update(); // 更新马里奥、敌人、碰撞 delta--; } repaint(); // 渲染当前帧 } }这段代码的逻辑是用纳秒时间差累积delta只有累积够一个完整更新周期才执行一次update()。这样无论你的机器是 30 帧还是 144 帧马里奥的移动速度都是一致的。UPDATE_RATE设 60 是横版游戏的通用值低于 30 会明显卡顿高于 120 对像素游戏没有收益还浪费 CPU。注意update()和repaint()必须分开逻辑更新频率和渲染频率不是一回事。3. 把马里奥画出来精灵、瓦片地图与坐标系3.1 精灵图切分一张图里抠出所有角色超级马里奥的角色和地形通常来自一张精灵图sprite sheet。你需要写一个工具方法按行列把大图切成小图。常见做法是用BufferedImage.getSubimage(x, y, w, h)// ResourceLoader.java 精灵图切分 public static BufferedImage[] splitSprite(BufferedImage sheet, int tileW, int tileH, int rows, int cols) { BufferedImage[] frames new BufferedImage[rows * cols]; int idx 0; for (int r 0; r rows; r) { for (int c 0; c cols; c) { // 按行列坐标抠出单个精灵注意 x 是列方向y 是行方向 frames[idx] sheet.getSubimage(c * tileW, r * tileH, tileW, tileH); } } return frames; }参数说明tileW、tileH是单个精灵的像素尺寸经典马里奥是 16×16rows、cols是精灵图的行列数。切完之后每个BufferedImage就是一帧马里奥的跑动动画就是按顺序循环播放这几帧。注意getSubimage返回的是原图的视图不是拷贝如果你后面要缩放或修改记得先getRGB拷一份否则会污染原图。3.2 瓦片地图用二维数组描述整个世界横版游戏的地形不需要每个像素都存用瓦片tile拼就行。一张地图就是一个二维 int 数组每个数字代表一种地形// TileMap.java 地图数据与渲染 public class TileMap { // 0空 1地面 2砖块 3问号块 4管道 private final int[][] map { {0,0,0,0,0,0,0,0,0,0}, {0,0,0,0,0,0,0,0,0,0}, {0,0,3,0,0,0,0,0,0,0}, {1,1,1,1,1,1,1,1,1,1}, {1,1,1,1,1,1,1,1,1,1} }; private static final int TILE_SIZE 32; public void render(Graphics2D g, int cameraX) { for (int row 0; row map.length; row) { for (int col 0; col map[row].length; col) { int type map[row][col]; if (type 0) continue; // 空格不画 int worldX col * TILE_SIZE; int screenX worldX - cameraX; // 减去相机偏移 g.drawImage(TileSprites.get(type), screenX, row * TILE_SIZE, null); } } } }这里的关键是cameraX。横版卷轴的本质就是相机跟着马里奥移动所有世界坐标减去cameraX才是屏幕坐标。TILE_SIZE设 32 是常见选择16 像素的精灵放大两倍视觉上更清晰。地图数组的行列数决定了关卡大小我一般先手写一个 200 列左右的关卡够跑一段完整的「起步—跳跃—踩敌人—吃金币」流程。3.3 坐标系与相机跟随别让马里奥跑出屏幕相机逻辑很简单但有个细节容易忽略相机不应该无条件跟随而是当马里奥超过屏幕中线时才移动否则马里奥会一直贴在屏幕左边观感很差。// GamePanel.java 相机更新 private int cameraX 0; private void updateCamera() { int marioScreenX mario.getX() - cameraX; // 马里奥超过屏幕中线相机才跟进 if (marioScreenX SCREEN_WIDTH / 2) { cameraX mario.getX() - SCREEN_WIDTH / 2; } // 防止相机越过地图左边界 if (cameraX 0) cameraX 0; }SCREEN_WIDTH / 2是中线阈值你可以改成 0.4 或 0.6 调整手感。注意相机只跟右不跟左这是马里奥类游戏的经典设计往回走时相机不动避免画面来回抖动。4. 让马里奥动起来输入、物理与碰撞检测4.1 键盘状态管理为什么不能用 KeyListener 直接改坐标新手最常见的写法是在keyPressed里直接mario.x 5这样做的后果是按住方向键时由于操作系统的按键重复延迟马里奥会一顿一顿地走。正确做法是用一个布尔数组记录按键的按下/松开状态在游戏循环里根据状态更新// KeyHandler.java 按键状态记录 public class KeyHandler implements KeyListener { private final boolean[] keys new boolean[256]; public boolean isDown(int keyCode) { return keys[keyCode]; } Override public void keyPressed(KeyEvent e) { keys[e.getKeyCode()] true; // 只记录状态不改坐标 } Override public void keyReleased(KeyEvent e) { keys[e.getKeyCode()] false; } Override public void keyTyped(KeyEvent e) {} }然后在Mario.update()里读状态// Mario.java 根据按键状态更新速度 public void update(KeyHandler keys) { if (keys.isDown(KeyEvent.VK_LEFT)) { vx -MOVE_SPEED; facing LEFT; } else if (keys.isDown(KeyEvent.VK_RIGHT)) { vx MOVE_SPEED; facing RIGHT; } else { vx 0; // 没有输入时水平速度归零 } if (keys.isDown(KeyEvent.VK_SPACE) onGround) { vy JUMP_FORCE; // 只有站在地面才能跳 onGround false; } }MOVE_SPEED我一般设 4 到 6 像素每帧JUMP_FORCE设 -12 到 -15y 轴向下为正。这两个参数直接决定手感调的时候要有耐心改一个测一次。4.2 重力与跳跃一个容易调崩的参数重力逻辑就是每帧给vy加一个常量然后让y加上vy// Mario.java 重力与垂直运动 private static final double GRAVITY 0.6; private static final double MAX_FALL_SPEED 12; public void applyPhysics() { vy GRAVITY; if (vy MAX_FALL_SPEED) vy MAX_FALL_SPEED; // 限制最大下落速度 y vy; }GRAVITY设 0.6、JUMP_FORCE设 -13 是我试出来比较接近原版手感的组合。MAX_FALL_SPEED必须有否则从高处掉下来会瞬间穿过地面。这里有个血泪经验重力、跳跃力、最大下落速度这三个参数是联动的改一个必须重新测另外两个否则要么跳不起来要么跳起来像在月球。4.3 碰撞检测先分轴再判断别一次性算碰撞检测是横版游戏最容易翻车的地方。常见错误是同时更新 x 和 y 再判断碰撞结果马里奥会卡在墙里或者穿墙。正确做法是分轴处理先更新 x检测水平碰撞修正 x再更新 y检测垂直碰撞修正 y。// Mario.java 分轴碰撞 public void moveWithCollision(TileMap map) { // 先处理水平 x vx; Rectangle hb getBounds(); for (Tile t : map.getSolidTilesNear(hb)) { if (hb.intersects(t.getBounds())) { if (vx 0) x t.getX() - hb.width; // 向右撞墙 else if (vx 0) x t.getX() t.getWidth(); // 向左撞墙 vx 0; hb getBounds(); } } // 再处理垂直 y vy; onGround false; hb getBounds(); for (Tile t : map.getSolidTilesNear(hb)) { if (hb.intersects(t.getBounds())) { if (vy 0) { // 下落撞地 y t.getY() - hb.height; onGround true; } else if (vy 0) { // 上升撞头 y t.getY() t.getHeight(); } vy 0; hb getBounds(); } } }getSolidTilesNear只返回马里奥附近的实心瓦片不要遍历整张地图否则地图一大帧率就崩。onGround标志必须在垂直碰撞里重置它是判断能否跳跃的唯一依据。这套分轴逻辑写对之后马里奥贴墙走、踩地、顶砖块都不会出问题。4.4 敌人与踩踏判定用速度方向区分「踩」和「撞」踩蘑菇的判定不能只看相交还要看马里奥是不是从上方落下// GamePanel.java 马里奥与敌人碰撞 private void checkEnemyCollision() { Rectangle marioBox mario.getBounds(); for (Goomba g : enemies) { if (!g.isAlive()) continue; if (marioBox.intersects(g.getBounds())) { // 马里奥在下落且底部高于敌人中心判定为踩踏 if (mario.vy 0 mario.getBottom() g.getY() g.getHeight() / 2) { g.kill(); mario.vy -8; // 踩踏后小反弹 } else { mario.hurt(); // 否则马里奥受伤 } } } }mario.vy 0保证是下落状态getBottom() 敌人中心保证是从上方接触。这两个条件缺一个都会出现「侧面撞上去也被判定为踩死」的玄学 bug。5. 避坑与排查那些让我重写三遍的问题5.1 画面闪烁为什么 repaint 不能和 update 混在一起现象游戏跑起来画面一直闪精灵像在抽搐。原因在update()里调用了repaint()或者用了paint()而不是paintComponent()。解决所有渲染只在paintComponent(Graphics g)里做update()只改数据并且调用super.paintComponent(g)清屏或者用双缓冲Swing 默认开启但自定义paint会破坏它。5.2 按键失灵焦点问题现象窗口打开了但按方向键没反应。原因JPanel没有获得焦点键盘事件被窗口其他组件吃掉。解决在GamePanel构造里调用setFocusable(true)和requestFocusInWindow()并且确保KeyListener是加在GamePanel上而不是JFrame上。5.3 马里奥卡进砖块碰撞修正顺序错了现象跳到砖块边缘时马里奥会陷进去然后被弹出来。原因先更新了 y 再检测水平碰撞导致修正时坐标已经错位。解决严格按「水平→垂直」的顺序每次修正后重新计算碰撞盒getBounds()不要复用旧的Rectangle对象。5.4 敌人穿墙掉落瓦片查询范围太小现象蘑菇走到地图边缘直接掉出世界。原因getSolidTilesNear只查了马里奥附近的瓦片敌人用了同一套逻辑但范围没覆盖到脚下。解决给敌人单独写一个碰撞方法或者把查询范围按实体尺寸动态扩展确保脚下和前方各多查一格。5.5 帧率越高跳得越高物理没做时间归一化现象在高刷屏上马里奥跳得比 60Hz 屏幕高。原因update()每帧执行一次帧率越高单位时间内执行次数越多vy GRAVITY累积越快。解决要么用固定时间步长第 2 章那套要么把GRAVITY和vy都乘以deltaTime。我推荐固定时间步长简单可靠。6. 进阶技巧用状态机管动画用关卡数据管扩展写到能跑能跳之后真正拉开代码质量的是两件事动画状态机和关卡数据外置。动画状态机解决的是「马里奥什么时候播哪一帧」。我一般用一个枚举加一个计时器// Mario.java 动画状态机 private enum State { IDLE, RUN, JUMP, HURT } private State state State.IDLE; private int animTick 0; private int animFrame 0; private void updateAnimation() { State newState; if (!onGround) newState State.JUMP; else if (vx ! 0) newState State.RUN; else newState State.IDLE; if (newState ! state) { state newState; animTick 0; animFrame 0; // 状态切换时重置动画 } animTick; if (animTick 8) { // 每 8 帧换一帧动画 animTick 0; animFrame (animFrame 1) % getFrameCount(state); } }animTick 8这个阈值控制动画速度跑动一般 6 到 10 帧换一次跳跃可以固定一帧。状态切换时重置animFrame是关键否则从跑切换到跳会继承跑的帧号看起来像卡了一下。关卡数据外置则是把第 3 章那个硬编码的二维数组换成从文本文件读// TileMap.java 从文本加载关卡 public void loadFromFile(String path) throws IOException { Listint[] rows new ArrayList(); try (BufferedReader br new BufferedReader(new FileReader(path))) { String line; while ((line br.readLine()) ! null) { if (line.isBlank()) continue; int[] row new int[line.length()]; for (int i 0; i line.length(); i) { // 用字符表示地形#地面 ?问号块 空 row[i] charToTile(line.charAt(i)); } rows.add(row); } } map rows.toArray(new int[0][]); }这样你改关卡不用重新编译用记事本画地图就行。charToTile把#映射成 1、?映射成 3扩展新地形只需要加一个映射。验证方法也很直接写一个main方法加载地图后打印每一行的瓦片数量确认所有行等长再在游戏里跑一遍看马里奥能不能从起点走到终点、能不能踩死所有敌人、金币能不能吃干净。这三个检查过了基本就没有结构性 bug。最后说个我自己的习惯每次调完物理参数我都会用秒表测一次「从按下跳跃到落地」的时间原版大约是 0.6 到 0.7 秒。如果差太多说明重力或跳跃力该调了。这个项目我前后重写过三次碰撞逻辑最大的教训就是——先把游戏循环和坐标系定死再动任何实体代码。希望帮到你。本文还有配套的精品资源点击获取