## 1. 为什么用Python做3D射击游戏？你可能想错了 很多朋友一听到“用Python做3D第一人称射击游戏”，第一反应可能是：“Python？那个写脚本、搞数据分析的语言？能做3D游戏？还是FPS？开玩笑吧！” 我刚开始也是这么想的。作为一个玩了十几年《反恐精英》、《使命召唤》的老玩家，同时又是个写了多年Python的程序员，我一直觉得这两件事是两条平行线，永远不会相交。游戏开发，尤其是3D游戏，那不该是C++、C#的天下吗？Unity、Unreal Engine这些大家伙，才是正途。 直到有一次，我想给一个编程入门课的学生们做个有趣的项目，让他们能直观地看到自己代码的“威力”。用Unity？门槛太高，光是安装配置和界面就能劝退一大半初学者。用纯2D的Pygame做个小游戏？又觉得不够酷，激发不了他们的兴趣。就在我纠结的时候，我忽然想：为什么不试试用Python挑战一下3D FPS的底线呢？不追求《战地》级别的画面，只做一个能跑、能看、能开枪打怪的“玩具”级别的3D游戏，行不行？ 实测下来，**不仅行，而且出乎意料地有趣和具有启发性**。Python做3D游戏，核心优势不在于性能（这点我们必须承认），而在于**极低的入门门槛和快速的反馈循环**。你不需要理解复杂的图形学API（比如OpenGL或DirectX），不需要被庞大的游戏引擎编辑器吓到。你只需要一个Python解释器，几个轻量级的库，就能从零开始，亲手“捏”出一个属于你自己的3D世界。这个过程，就像用乐高积木搭建城堡，每一块砖（每一行代码）都是你自己放上去的，那种成就感和对底层机制的理解，是使用现成引擎无法比拟的。 所以，这篇文章不是教你做一个能上架Steam的商业游戏，而是带你进行一次**充满乐趣的编程探险**。目标读者就是像当年的我一样的Python初学者，或者对游戏开发好奇但被传统路径吓退的朋友。我们会用最直白的语言，从画出一个3D的方块开始，一步步让你的人物动起来，让视角跟随鼠标，最后扣动扳机，击中迎面飞来的怪物。相信我，当你看到自己写的代码让一个3D角色在屏幕上奔跑射击时，那种感觉，绝对比通关任何一个3A大作都来得爽快。 ## 2. 搭建你的3D游戏开发环境：别在第一步就放弃 万事开头难，但咱们把这个“难”降到最低。你不需要安装几个G的软件，也不需要配置复杂的环境变量。跟着我做，五分钟内让你进入状态。 ### 2.1 核心三件套：Python、Pygame和Panda3D 首先，确保你安装了Python。我推荐使用**Python 3.8或以上版本**，太老的版本可能会遇到库兼容性问题。去Python官网下载安装就行，记得勾选“Add Python to PATH”，这是避免后续各种“命令找不到”问题的关键。 接下来是重头戏：游戏库。原始文章提到了`sprites`模块，这很可能是一个教学用的自定义库。为了更通用、更贴近真实的3D开发，我强烈推荐一个组合：**Pygame + PyOpenGL**，或者一个更全能的选项：**Panda3D**。这里我主要介绍Panda3D路线，因为它对3D的支持更原生、文档更完善，且完全免费开源。 - **Pygame**：这是我们处理2D图像、声音、键盘鼠标输入的基础层。虽然它本身对3D支持很弱，但它的易用性无可替代，我们将用它来捕获输入和管理窗口。 - **Panda3D**：一个功能强大的3D游戏引擎，由迪士尼和卡内基梅隆大学共同开发。它用C++编写核心，但提供了完美的Python接口。**它的强大之处在于，你无需接触底层OpenGL，就能加载3D模型、设置灯光、摄像机，管理场景图**。 安装它们非常简单，打开你的命令行（CMD或终端），输入以下命令： ```bash pip install pygame pip install panda3d ``` 如果安装速度慢，可以在后面加上 `-i https://pypi.tuna.tsinghua.edu.cn/simple` 来使用国内镜像加速。 ### 2.2 验证安装与第一个“Hello, 3D World” 安装完成后，我们写一个最简单的程序来验证一切是否正常。创建一个新文件，比如叫 `my_first_3d.py`，输入以下代码： ```python import direct.directbase.DirectStart from panda3d.core import * # 加载一个自带的茶壶模型（经典3D测试模型） teapot = loader.loadModel("models/teapot") teapot.reparentTo(render) # 将茶壶放入渲染场景 teapot.setPos(0, 10, 0) # 设置位置 (x, y, z) # 设置摄像机位置 base.cam.setPos(0, -20, 5) base.cam.lookAt(teapot) # 开始主循环 run() ``` 保存后运行这个Python脚本。如果一切顺利，你应该会看到一个窗口，里面有一个灰色的3D茶壶在缓缓旋转（Panda3D默认会给场景一个旋转动画）。恭喜你！你的第一个3D程序已经跑起来了。如果报错，最常见的原因是Panda3D的模型路径问题，你可以尝试将 `"models/teapot"` 替换为 `"panda3d/models/box.egg"` 来加载一个更简单的方块模型。 这个简单的例子揭示了Panda3D工作的核心流程：**加载模型（Load） -> 放入场景（Reparent） -> 设置变换（Position/Rotation） -> 运行主循环（Run）**。我们后续所有复杂的游戏逻辑，都是在这个框架上添砖加瓦。 ## 3. 构建游戏世界的基石：地图、玩家与摄像机 现在茶壶会转了，但我们想要的是一个第一人称视角的游戏世界。这意味着我们需要一个可以行走的地面，一个代表玩家的视点（摄像机），以及让这个视点能受我们控制。 ### 3.1 创建地面和简单的围墙 在3D游戏中，地面通常就是一个巨大的、铺平的立方体（或者一个平面）。我们用Panda3D创建一个地面，并给它贴上简单的纹理，让它看起来不像一个光秃秃的灰色方块。 ```python from direct.showbase.ShowBase import ShowBase from panda3d.core import * class MyGame(ShowBase): def __init__(self): super().__init__() # 初始化Panda3D引擎 # 1. 创建地面 self.ground = loader.loadModel("models/box") self.ground.reparentTo(render) self.ground.setScale(50, 50, 0.5) # 把它压扁，变成一个厚地板 self.ground.setPos(0, 0, -1) # 放在Z轴-1的位置 # 我们可以加载一个草地纹理图片（需要你自己准备一个grass.jpg放在代码同级目录） ground_tex = loader.loadTexture("grass.jpg") self.ground.setTexture(ground_tex, 1) # 2. 创建几面墙，围成一个简单的房间 self.wall1 = loader.loadModel("models/box") self.wall1.reparentTo(render) self.wall1.setScale(20, 1, 5) self.wall1.setPos(0, 25, 2) # 远处的墙 wall_tex = loader.loadTexture("brick.jpg") # 砖墙纹理 self.wall1.setTexture(wall_tex, 1) # 类似的，可以再创建左、右、近处的墙，这里省略... ``` 通过调整`setScale`和`setPos`，你就能像搭积木一样构建出游戏场景的雏形。`setScale`的三个参数分别代表X（宽）、Y（长）、Z（高）方向的缩放。在3D坐标系中，通常X是左右，Y是前后，Z是上下。 ### 3.2 实现第一人称摄像机控制 这是FPS游戏的灵魂。在Panda3D中，我们不需要创建一个“玩家模型”，**摄像机（Camera）就是玩家的眼睛**。我们需要做两件事：让摄像机的位置能通过键盘（WASD）移动，让摄像机的朝向能通过鼠标控制。 Panda3D提供了一个非常方便的组件叫 `FirstPersonWalker`，但为了更透彻地理解原理，我们手动实现一个。 ```python class MyGame(ShowBase): def __init__(self): # ... 之前的初始化代码 ... # 初始化玩家变量 self.player_speed = 5.0 self.mouse_sensitivity = 0.2 self.heading = 0 # 左右旋转角度（偏航角Yaw） self.pitch = 0 # 上下旋转角度（俯仰角Pitch） # 禁用默认的鼠标控制，让我们自己来 self.disableMouse() # 隐藏鼠标光标 props = WindowProperties() props.setCursorHidden(True) self.win.requestProperties(props) # 设置任务管理器，在每一帧都调用我们的更新函数 self.taskMgr.add(self.update, "update") def update(self, task): dt = globalClock.getDt() # 获取上一帧到这一帧的时间差，保证移动速度与帧率无关 # --- 键盘控制移动 --- is_moving = False move_vector = Vec3(0, 0, 0) # 移动方向向量 if self.mouseWatcherNode.is_button_down(KeyboardButton.ascii_key('w')): move_vector.y += 1 # 向前 is_moving = True if self.mouseWatcherNode.is_button_down(KeyboardButton.ascii_key('s')): move_vector.y -= 1 # 向后 is_moving = True if self.mouseWatcherNode.is_button_down(KeyboardButton.ascii_key('a')): move_vector.x -= 1 # 向左 is_moving = True if self.mouseWatcherNode.is_button_down(KeyboardButton.ascii_key('d')): move_vector.x += 1 # 向右 is_moving = True if is_moving: # 将移动向量归一化（防止斜向移动更快），然后根据摄像机的朝向旋转这个向量 move_vector.normalize() move_vector *= self.player_speed * dt # 根据当前的偏航角（heading）旋转移动方向，使其与摄像机朝向对齐 move_vector.rotateXZ(self.heading) # 应用移动 self.camera.setPos(self.camera.getPos() + move_vector) # --- 鼠标控制视角 --- if self.mouseWatcherNode.hasMouse(): # 获取鼠标自上一帧以来的移动量 md = self.win.getPointer(0) x = md.getX() - self.win.getXSize() // 2 y = md.getY() - self.win.getYSize() // 2 if x != 0 or y != 0: # 根据鼠标移动更新旋转角度 self.heading -= x * self.mouse_sensitivity * dt self.pitch -= y * self.mouse_sensitivity * dt # 限制上下看的幅度，避免脖子拧断 self.pitch = max(min(self.pitch, 90), -90) # 应用旋转：先上下看（pitch），再左右转（heading） self.camera.setHpr(self.heading, self.pitch, 0) # 将鼠标指针重置到窗口中心，实现“无限移动” self.win.movePointer(0, self.win.getXSize() // 2, self.win.getYSize() // 2) return task.cont # 告诉任务管理器继续执行这个任务 ``` 这段代码是**第一人称控制的核心**。它做了以下几件事： 1. **键盘输入**：检测WASD键，计算出一个移动方向向量。 2. **帧时间独立**：使用 `globalClock.getDt()` 乘以速度，确保无论电脑快慢，移动速度是恒定的。 3. **鼠标输入**：获取鼠标相对窗口中心的偏移量，转换成摄像机的左右旋转（`heading`）和上下旋转（`pitch`）。 4. **视角变换**：通过 `setHpr`（Heading, Pitch, Roll）方法设置摄像机的朝向。 5. **鼠标重置**：将鼠标指针移回窗口中心，模拟FPS游戏中鼠标可以无限拖动视角的效果。 现在运行代码，你应该能使用WASD在一个简单的房间内移动，并用鼠标环顾四周了！一个3D FPS的雏形已经诞生。 ## 4. 注入灵魂：怪物、射击与碰撞检测 有了世界和移动能力，接下来就需要有互动的对象——怪物，以及和它们互动的方式——射击。 ### 4.1 创建并让怪物动起来 我们不会用复杂的怪物AI，先做一个沿着固定路径飞行的“蝙蝠”或者“无人机”。我们可以用Panda3D加载一个简单的模型（比如一个球体或一个自带的熊猫模型）作为怪物。 ```python def __init__(self): # ... 之前的初始化代码 ... # 加载怪物模型 self.enemy = loader.loadModel("models/panda-model") self.enemy.reparentTo(render) self.enemy.setScale(0.5, 0.5, 0.5) self.enemy.setPos(10, 10, 2) # 初始位置 self.enemy.setColor(1, 0, 0, 1) # 给它染成红色，显得有敌意 # 怪物属性 self.enemy_speed = 3.0 self.enemy_path_index = 0 # 定义怪物巡逻路径点 self.enemy_path = [Vec3(10, 10, 2), Vec3(-10, 10, 2), Vec3(-10, -10, 2), Vec3(10, -10, 2)] def update(self, task): dt = globalClock.getDt() # ... 之前的玩家控制代码 ... # --- 更新怪物行为 --- target_pos = self.enemy_path[self.enemy_path_index] current_pos = self.enemy.getPos() # 计算朝向目标点的方向 direction = target_pos - current_pos distance = direction.length() # 到目标点的距离 if distance > 0.1: # 如果还没到达目标点，就朝它移动 direction.normalize() self.enemy.setPos(current_pos + direction * self.enemy_speed * dt) # 让怪物面朝移动方向（可选） self.enemy.lookAt(target_pos) else: # 到达目标点，切换到下一个点 self.enemy_path_index = (self.enemy_path_index + 1) % len(self.enemy_path) return task.cont ``` 现在你的世界里就有一个红色的熊猫在四个点之间来回巡逻了。虽然行为简单，但它已经是一个合格的“靶子”了。 ### 4.2 实现射击机制：从射线检测到命中反馈 FPS游戏的射击，本质上是从摄像机中心发出一条看不见的射线（Ray），检测这条射线击中了场景中的哪个物体。Panda3D的碰撞系统让这个变得很简单。 ```python def __init__(self): # ... 之前的初始化代码 ... # 设置碰撞系统 from panda3d.core import CollisionTraverser, CollisionHandlerQueue, CollisionRay, CollisionNode self.cTrav = CollisionTraverser() # 碰撞遍历器 self.cHandler = CollisionHandlerQueue() # 碰撞处理器（队列） # 创建一条从摄像机发出的碰撞射线 self.ray = CollisionRay() self.rayNode = CollisionNode('mouseRay') self.rayNode.addSolid(self.ray) self.rayNP = self.camera.attachNewNode(self.rayNode) # 将射线节点附加到摄像机 self.rayNode.setFromCollideMask(BitMask32.bit(1)) # 设置从哪一层碰撞掩码发出 self.rayNode.setIntoCollideMask(BitMask32.allOff()) # 设置不与任何层碰撞（由被撞物体决定） # 为怪物设置碰撞体（一个包围球） enemy_col_node = CollisionNode('enemy') enemy_col_node.addSolid(CollisionSphere(0, 0, 0, 1.0)) # 半径为1的球体 enemy_col_node.setIntoCollideMask(BitMask32.bit(1)) # 设置怪物在第1层碰撞掩码 self.enemy_col_np = self.enemy.attachNewNode(enemy_col_node) # 将射线加入到碰撞遍历器中 self.cTrav.addCollider(self.rayNP, self.cHandler) # 射击相关 self.is_shooting = False self.mouse1 = MouseButton.one() self.accept('mouse1', self.start_shoot) # 按下鼠标左键 self.accept('mouse1-up', self.stop_shoot) # 松开鼠标左键 # 加载射击音效（需要准备一个fire.wav文件） self.fire_sound = loader.loadSfx("fire.wav") def start_shoot(self): self.is_shooting = True # 立即进行一次射击检测 self.do_shoot() def stop_shoot(self): self.is_shooting = False def do_shoot(self): # 播放音效 if self.fire_sound: self.fire_sound.play() # 更新射线起点为摄像机位置，方向为摄像机正前方 self.ray.setOrigin(self.camera.getPos()) self.ray.setDirection(self.camera.getQuat().getForward()) # 清空上一帧的碰撞结果，进行新的碰撞检测 self.cHandler.clearEntries() self.cTrav.traverse(render) if self.cHandler.getNumEntries() > 0: # 有碰撞发生！按距离排序，取第一个（最近的）碰撞点 self.cHandler.sortEntries() entry = self.cHandler.getEntry(0) hit_node = entry.getIntoNodePath() hit_pos = entry.getSurfacePoint(render) # 获取碰撞点的世界坐标 # 判断击中的是不是我们的怪物 if hit_node == self.enemy_col_np.node(): print("命中目标！") # 给怪物一个被击中的反馈，比如变色、播放死亡动画、消失 self.enemy.setColor(0.5, 0, 0, 1) # 变暗红色 # 可以在这里添加得分、怪物生命值减少等逻辑 ``` 这段代码实现了完整的射击逻辑： 1. **碰撞系统设置**：创建`CollisionRay`（射线）和`CollisionSphere`（怪物的碰撞球）。 2. **碰撞掩码**：这是一个过滤机制，确保射线只与我们关心的物体（设置了对应掩码的怪物）发生碰撞检测。 3. **实时检测**：在`do_shoot`函数中，我们将射线的起点和方向设置为当前摄像机的状态，然后调用`traverse`进行碰撞检测。 4. **命中处理**：从碰撞处理器中取出结果，判断击中了谁，并做出相应反应（如改变颜色、播放音效、减少血量）。 现在，运行游戏，移动，瞄准那个红色的熊猫，点击鼠标左键。如果你听到枪声，并且在控制台看到“命中目标！”，同时熊猫颜色变深，那么恭喜你，你的第一款Python 3D FPS游戏的核心玩法已经全部实现了！ ## 5. 打磨与优化：让游戏更像那么回事儿 基础功能都有了，但现在的游戏看起来还很粗糙。我们可以花点时间，做一些简单的打磨，体验会提升好几个档次。 ### 5.1 添加准星和简单的UI 没有准星的FPS是没有灵魂的。我们可以用Panda3D的2D绘制功能或者直接加载一张十字准星图片叠加在屏幕中央。 ```python def __init__(self): # ... 之前的初始化代码 ... # 创建一个2D准星节点（位于屏幕最上层） from panda3d.core import CardMaker, TextNode cm = CardMaker('crosshair') cm.setFrame(-0.02, 0.02, -0.02, 0.02) # 一个非常小的方形 self.crosshair = aspect2d.attachNewNode(cm.generate()) self.crosshair.setTransparency(TransparencyAttrib.MAlpha) # 加载准星纹理（一个简单的十字PNG，背景透明） crosshair_tex = loader.loadTexture("crosshair.png") self.crosshair.setTexture(crosshair_tex, 1) self.crosshair.setColor(1, 1, 1, 0.8) # 白色，带一点透明度 ``` `aspect2d`是一个特殊的渲染节点，它里面的物体不受3D摄像机影响，永远固定在屏幕上。把准星放在这里就对了。 ### 5.2 优化性能与资源管理 当游戏内容变多时，性能可能会成为问题。这里有几个小技巧： - **模型细节**：在原型阶段，使用Panda3D自带的简单模型（`models/box`, `models/sphere`）。等逻辑完善后，再使用Blender等工具制作或下载更精美的模型替换。 - **纹理尺寸**：纹理图片不要过大，512x512对于很多物体已经足够。 - **碰撞体简化**：就像我们之前做的，用简单的`CollisionSphere`或`CollisionBox`来代替复杂的模型网格进行碰撞检测，这被称为“简化碰撞体”，能极大提升碰撞检测效率。 - **帧率控制**：Panda3D的`run()`函数默认会尽可能快地运行。如果你发现CPU/GPU占用率很高，可以在主循环中通过`taskMgr`的延迟来控制帧率上限，比如固定在60帧。 ```python def update(self, task): dt = globalClock.getDt() # ... 所有更新逻辑 ... # 如果希望固定帧率，可以在这里判断dt，但通常不需要，Panda3D自己会处理 return task.cont ``` ### 5.3 下一步可以尝试的扩展 到这个阶段，你已经拥有了一个可玩的原型。接下来，你可以根据自己的兴趣，选择不同的方向进行深化： - **更多怪物与AI**：给怪物添加更复杂的AI状态机（巡逻、追击、攻击、逃跑）。 - **武器系统**：实现换枪、不同的射速、伤害、弹道下坠（高级）。 - **关卡设计**：用代码或外部工具（如Panda3D的场景编辑器）设计更复杂的地图。 - **粒子效果**：为射击和爆炸添加粒子系统，让画面更炫酷。 - **网络功能**：使用Panda3D内置的网络库，尝试制作一个多人对战游戏的雏形（这是一个非常大的挑战，但非常值得尝试）。 踩过几次坑之后，我最大的体会是：用Python做3D游戏，最重要的不是追求极致的画面和性能，而是享受那种“从无到有”的创造过程和快速迭代的乐趣。每一个你实现的小功能，都会带来实实在在的成就感。这个项目可能永远不会变成商业产品，但它作为你学习游戏开发、深入理解3D图形编程的敲门砖，价值是无限的。当你以后再打开那些用大型引擎制作的游戏时，你看到的将不再只是华丽的画面，而是背后一套套你曾经亲手实现过的、或简单或复杂的系统。这种视角的转变，才是学习开发游戏带给我们的最大财富。好了，代码就在那里，世界已经搭建，拿起你的“键盘枪”，开始创造和战斗吧。