Python + Ursina设计一个有趣的3D小游戏-智慧文博士

Python + Ursina设计一个有趣的3D小游戏

Ursina使用基础知识可见 https://blog.csdn.net/cnds123/article/details/155709276

Python + Ursina设计一个有趣的3D小游戏：《天空跑酷：寻找金立方》

项目文件夹结构是这样的：

你的文件夹/
├── main.py (下面的代码)
├── SimHei.ttf (必须有！用于显示中文)
└── sounds/ (文件夹)
├── jump.wav (跳跃音效，可选)
└── win.wav (胜利音效，可选)

运行截图：

完整代码如下：

## 玩法说明 ## 脚踩 灰色 起点（出生地）。 ## 一路跳过 绿色 方块（稳扎稳打）。绿色块是安全踏板。 ## 小心应对 蓝色 方块（看准时机）。左右摆动的蓝色块是给游戏增加难度的“拦路虎”。 ## 绝对不要碰 红色 地面（碰了就重来）。红色区域是万丈深渊的底部。 ## 最终摸到 黄色 小方块（通关胜利）。 ## 鼠标移动：转动视角（看天、看地、看路）。注意：进入游戏后鼠标光标会消失，这是正常的 FPS 模式。 ## 在所有绿色平台的尽头，悬浮着一个金黄色的大方块（还会旋转）。 ## W 键：向前走。S 键：向后退。A 键：向左移。D 键：向右移。空格键 (Space)：跳跃。 ## 按住W冲刺，看准时机按空格，飞向下一个绿色方块；有的平台离得远，需要按住 W 助跑再按空格；有的离得近，原地起跳就行。 ## ESC 键：直接强制退出游戏。 from ursina import * from ursina.prefabs.first_person_controller import FirstPersonController import random import os # os._exit(0) 用到 # 初始化引擎 app = Ursina() # --- 1. 设置中文字体 (必须！) --- Text.default_font = 'SimHei.ttf' # --- 2. 音频设置 (运用你刚学的知识) --- # 即使文件不存在，Ursina 通常只是报警告而不会崩溃，但建议你放进去体验更好 jump_sound_path = 'sounds/jump.wav' # 显式路径写法，稳定可靠 win_sound_path = 'sounds/win.wav' def play_audio_if_exists(path): # 一个安全播放音频的小函数 if os.path.exists(path): Audio(path, autoplay=True) # --- 3. 场景搭建 --- # 天空盒 (给游戏一个背景) Sky() # 地面 (Death Zone) - 用红色表示危险，掉在上面会重置 death_zone = Entity( model='plane', scale=(100, 1, 100), color=color.red, y=-10, collider='box', texture='white_cube' # 内置纹理 ) # 起点平台 start_platform = Entity( model='cube', color=color.gray, scale=(5, 1, 5), position=(0, 0, 0), collider='box', texture='white_cube' ) # --- 4. 关卡生成算法 --- # 我们运用左手坐标系：Y是高，Z是前 platforms = [] z_pos = 0 y_pos = 0 # 生成 15 个随机跳跃平台 for i in range(15): # 每次往前(Z)走 4~6米，往上(Y)走 -1~2米 (可能高也可能低) z_pos += random.uniform(4, 7) # Z-Forward（向前是Z+）。降低难度修改：改成 3~5：z_pos += random.uniform(3, 5)，缩小平台之间的缝隙 y_pos += random.uniform(-1, 2) # Y-Up（向上是Y+） # 随机左右偏移(X) x_pos = random.uniform(-3, 3) # 创建平台 p = Entity( model='cube', color=color.green, scale=(3, 0.5, 3), # 稍微扁一点。降低难度修改：改成 5或者更大 scale=(5, 0.5, 5) position=(x_pos, y_pos, z_pos), collider='box', texture='brick' ) platforms.append(p) # 给第 5 个和第 10 个平台加特效：它们是会移动的！ if i == 5 or i == 10: p.color = color.azure p.is_moving = True # 自定义属性标记 else: p.is_moving = False # --- 5. 终点目标 --- goal_block = Entity( model='cube', color=color.gold, scale=(2, 2, 2), position=(0, y_pos + 1, z_pos + 6), # 在最后一个平台前面一点 collider='box', texture='white_cube' ) # --- 6. 玩家设置 --- player = FirstPersonController( model='cube', collider='box', gravity=0.8 # 重力参数。降低难度修改：降低到 0.5 或 0.4 ) player.cursor.visible = False # 隐藏鼠标 # --- 7. UI 文本 --- msg_text = Text( text='按 WASD 移动，空格跳跃\n目标：找到金色方块！', origin=(0, 0), y=0.3, scale=2, color=color.yellow ) # 胜利状态标记 game_won = False # --- 8. 游戏主逻辑 (Update) --- def update(): global game_won if game_won: return # 如果赢了，就不运行后面的逻辑了 # 1. 检测是否掉落 (Y轴判定) if player.y < -5: player.position = (0, 1, 0) # 回到起点 msg_text.text = '你掉下去了！\n已重置位置' msg_text.color = color.red invoke(reset_text, delay=2) # 2秒后重置文字 # 2. 检测移动平台逻辑 # time.time() 返回当前时间，sin 函数让数值在 -1 到 1 之间波动 for p in platforms: if hasattr(p, 'is_moving') and p.is_moving: # 让平台在 X 轴方向左右摇摆 p.x += math.sin(time.time() * 2) * 0.05 # 产生平滑左右摇摆的平台。降低难度修改：* 0.05 改成 * 0.01 # 3. 检测胜利 (检测玩家和金块的距离) # distance(a, b) 是 Ursina 内置函数 if distance(player.position, goal_block.position) < 2: win_game() # --- 9. 输入控制 (Input) --- def input(key): # 【调试大法】打印当前按下的键 print(f"检测到按键: {key}") if key == 'space': # 简单的跳跃音效逻辑 # 只有当玩家在地上时才播放声音（Userina的player.grounded属性） if player.grounded: play_audio_if_exists(jump_sound_path) # 用 ESC 退出 if key == 'escape': print("按下了 ESC") #application.quit() # 不用——不起效，它太温柔了 os._exit(0) # 重点！ # 辅助函数 def reset_text(): if not game_won: msg_text.text = '加油！往 Z 轴正方向前进！' msg_text.color = color.white def win_game(): global game_won game_won = True msg_text.text = '恭喜！挑战成功！\n按 ESC 退出' msg_text.color = color.green msg_text.scale = 3 msg_text.background = True play_audio_if_exists(win_sound_path) # 一个小彩蛋：让金块旋转起来 goal_block.animate_rotation_y(360, duration=1, loop=True) app.run()

说明

1.在代码的input(key)函数里只写了Space播放声音，没写if key == 'w': move_forward()，为什么它自己就会走呢？

因为使用了一个“现成的超级零件” ——FirstPersonController。这个零件（类）是 Ursina 官方帮你写好的，它内部封装了复杂的数学运算和物理逻辑。

from ursina.prefabs.first_person_controller import FirstPersonController 这行代码导入了 Ursina 的一个预制的第一人称控制器，它是一个已经封装好的、功能完整的角色控制器。也可以说，FirstPersonController是 Ursina 引擎中用于快速创建第一人称视角玩家控制器的预制组件（prefab）。FirstPersonController的作用包含以下功能：

• 鼠标控制视角（左右/上下看）

• WASD 移动

• 空格键跳跃

• 重力与地面碰撞检测

• 自动站在地面上（不会掉下去）

• 可调节速度、跳跃高度、视角灵敏度等参数

简单示例：

from ursina import * from ursina.prefabs.first_person_controller import FirstPersonController # 设置窗口大小（宽, 高） window.size = (1280, 720) app = Ursina() # 创建地面 ground = Entity(model='plane', scale=10, color=color.green, collider='box') # 创建第一人称玩家 player = FirstPersonController() app.run()

现在你可以试试这个简单的示例是否正常运行：

• 移动鼠标：视角应该会转动（即使窗口小，也能看到地面颜色变化）。

• 按 WASD：角色会移动（虽然看不到自己，但相机位置在变）。

• 按空格：会跳起（可配合向下看观察地面距离变化）。

如果想用箭头键取代WASD键控制角色移动怎么办？

在内置函数update()中使用held_keys字典映射是最简便的方式

update()是Ursina 引擎中内置函数，一个每帧自动调用的函数，用于实现持续更新的游戏逻辑，比如角色移动、动画、物理、AI 行为等。

示例代码：

from ursina import * from ursina.prefabs.first_person_controller import FirstPersonController # 设置窗口大小（宽, 高） window.size = (1280, 720) app = Ursina() # 创建地面 ground = Entity(model='plane', scale=10, color=color.green, collider='box') # 创建第一人称玩家 player = FirstPersonController() # 将方向键映射到 WASD def update(): held_keys['w'] = held_keys['up arrow'] held_keys['s'] = held_keys['down arrow'] held_keys['a'] = held_keys['left arrow'] held_keys['d'] = held_keys['right arrow'] app.run()

你可以运行试试看。

2.如何调整游戏的难度？

可以通过调整几个关键参数，如想降低游戏的难度：

①调整引力

原代码

gravity=0.8

修改为：降低到 0.5 或 0.4

gravity=0.5

②踏板变大 (增大落脚面积)

原代码 (3米宽)

scale=(3, 0.5, 3)

修改为：改成 5米或者更大