Python 制作 Flappy Bird 游戏源码深度解析

Python 制作 Flappy Bird 游戏源码深度解析

项目简介

基于 Python + Pygame 的 Flappy Bird 练习项目，覆盖游戏循环、精灵管理、碰撞检测、资源加载与帧率控制等机制。

开发环境

• Python ==3.10
• pygame>=2.5.0
• IDE：建议 PyCharm / VSCode

项目结构

FlappyBird/
├── cfg.py                 # 配置文件（常量、路径等）
├── FlappyBird.py          # 游戏主程序入口
├── modules/               # 游戏模块
│   ├── interfaces/        # 游戏界面（开始、结束）
│   │   ├── startGame.py
│   │   └── endGame.py
│   └── sprites/           # 游戏精灵（小鸟、管道）
│       ├── Bird.py
│       └── Pipe.py
└── resources/             # 游戏资源（图片、音频）
    ├── audios/
    └── images/

操作与玩法

• 按键：Space 或 ↑ 上升；Esc 退出
• 目标：穿过不断生成的管道，尽量获得更高分数

核心代码片段

初始化与主循环

import pygame, sys
clock = pygame.time.Clock()
screen = pygame.display.set_mode((288, 512))
while True:
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            pygame.quit()
            sys.exit()
        elif event.type == pygame.KEYDOWN:
            if event.key in (pygame.K_SPACE, pygame.K_UP):
                pass
    pygame.display.update()
    clock.tick(60)

资源加载（数字图片）

import pygame, cfg
number_images = {k: pygame.image.load(v).convert_alpha() for k, v in cfg.NUMBER_IMAGE_PATHS.items()}

像素级碰撞检测

if pygame.sprite.collide_mask(bird, pipe):
    is_game_running = False

管道生成与加入精灵组

from modules.sprites.Pipe import Pipe
pos = Pipe.randomPipe(cfg, top_image)
pipe_sprites.add(Pipe(image=top_image, position=pos['top']))
pipe_sprites.add(Pipe(image=bottom_image, position=pos['bottom']))

计分逻辑

if pipe.rect.centerx < bird.rect.centerx and not pipe.used_for_score:
    pipe.used_for_score = True
    score += 0.5

帧率控制

clock.tick(cfg.FPS)

详细机制解析

配置文件 (cfg.py)

cfg.py 文件主要用于存储游戏中的常量配置和资源路径，方便统一管理。

• 屏幕设置：定义了屏幕的宽高 (SCREENWIDTH, SCREENHEIGHT) 和帧率 (FPS)。
• 资源路径：使用 os.path.join 拼接路径获取图片和音频文件。
• 游戏参数：如管道之间的空隙大小 (PIPE_GAP_SIZE)。

小鸟类 (modules/sprites/Bird.py)

Bird 类继承自 pygame.sprite.Sprite，是游戏的主角。

• 初始化 (__init__)：
  • 加载小鸟的三种状态图片（翅膀上扬、平展、下压）。
  • 初始化位置、速度（up_speed, down_speed）和状态标志（is_flapped）。
  • 利用 itertools.cycle 实现翅膀扇动的循环动画。
• 更新状态 (update)：
  • 物理模拟：根据 is_flapped 状态处理上升和下落。上升时速度递减，下落时速度递增（模拟重力）。
  • 边界检测：检查小鸟是否撞到天花板或地面。
  • 动画更新：通过计数器控制图片切换频率，实现扇翅膀的动画效果。
• 动作控制：
  • setFlapped()：玩家点击时调用，给予小鸟向上的速度。
  • unsetFlapped()：上升动力耗尽时调用，转为自由落体。

管道类 (modules/sprites/Pipe.py)

Pipe 类同样继承自 pygame.sprite.Sprite，负责管道的生成和属性。

• 随机生成 (randomPipe)：
  • 这是一个静态方法，计算管道的垂直位置。
  • 保证上下管道之间留有固定的空隙 (PIPE_GAP_SIZE)。
  • 返回上管道和下管道的坐标字典。

游戏界面 (modules/interfaces/)

• 开始界面 (startGame.py)：
  • 显示背景、地面、小鸟（带动画）和提示信息。
  • 通过 while True 循环等待玩家按下空格键或向上键开始游戏。
  • 地面会不断滚动，营造动态感。
• 结束界面 (endGame.py)：
  • 小鸟死亡后调用。
  • 显示最终得分和游戏画面。
  • 等待玩家按键重新开始或退出。

主程序 (FlappyBird.py)

这是游戏的入口，负责组装各个模块并运行主循环。

1. 初始化 (initGame)：初始化 Pygame 和音频混合器，设置屏幕大小。
2. 资源加载：读取 cfg.py 中的路径，加载所有图片和声音资源。
3. 游戏主循环 (main)：
   • 事件处理：监听退出事件 (QUIT) 和按键事件 (KEYDOWN)。空格键触发小鸟飞翔。
   • 碰撞检测：使用 pygame.sprite.collide_mask 进行像素级精确碰撞检测（小鸟撞管道）。同时检测小鸟是否落地。
   • 游戏逻辑更新：
     • 调用 bird.update() 更新小鸟位置。
     • 移动地面和管道，实现向左移动的效果。
     • 管道管理：
       • 当管道移出屏幕左侧时移除。
       • 当管道移动到一定位置时生成新管道。
       • 计分：当小鸟通过管道（pipe.rect.centerx < bird.rect.centerx）且该管道未被计分过时，增加分数。
   • 画面渲染：按照背景 -> 管道 -> 地面 -> 分数 -> 小鸟 的顺序绘制画面 (screen.blit)。
   • 帧率控制：使用 clock.tick(cfg.FPS) 锁定游戏帧率。