最近找我说想要上手 3D 游戏的同学特别多一半是想做独立项目一半是被“用 AI 做游戏”这个说法吸引过来的。大家问的问题也差不多我不会建模代码基础一般能不能靠 Claude 这类 AI 工具把一个 3D 星球跑酷游戏从零做出来Ziva 插件到底是干什么的用 Godot 而不是 Unity是不是更合适先说结论可以但前提是你要改变对“用 AI 做游戏”的理解。AI 不会像魔法一样直接吐给你一个完整项目它真正改变的是“从需求到代码”这一段重复劳动。你负责拆需求、定机制、验结果Claude 负责把 GDScript 脚本写出来Ziva 这类物理增强插件负责把角色动作、碰撞反馈这些“手感层”补上。这篇文章会从一个适合初学者的 3D 星球跑酷项目入手完整走一遍“需求拆分 → 场景搭建 → AI 生成角色脚本 → 星球引力逻辑 → 跑酷机制 → 插件增强 → 运行验证”的流程。代码以 Godot 4.x 和 GDScript 为主不依赖复杂建模所有素材都可以用基础几何体代替。读完你可以得到一个能在本地跑起来的星球跑酷原型更重要的是学会一套以后做任何小游戏都能复用的 AI 辅助开发工作流。1. 这篇文章真正要解决的问题很多人一提起“做 3D 游戏”下意识会觉得门槛在“3D 建模”和“引擎底层”。但在实际动手做一个小型跑酷项目时真正的成本分布是这样的第一场景管理。一个游戏里面有哪些节点、谁是谁的子节点、谁在物理层上交互这些结构性问题最消耗时间。第二角色控制与物理反馈。移动、跳跃、重力、碰撞、镜头跟随每一样在 3D 里都比 2D 多一个维度新手很容易在这里翻车。第三动态机制。跑酷游戏的障碍生成、计分、死亡判定、复活逻辑本身不算复杂但代码量不少。第四手感调节。重力多大、跳跃多高、碰撞体是 Box 还是 Sphere这些参数调起来非常琐碎恰恰又是决定游戏好不好玩的关键。传统开发流程里这四件事每一个都要亲力亲为光是把基础原型跑通可能就要一个周末。AI 辅助开发解决的问题就是把这四件事里的“重复性编码”压缩掉大半让你把精力集中在游戏设计判断上。所以本文要解决的是这么几个具体问题用 Claude 生成 Godot 游戏脚本时提示词怎么写才靠谱3D 星球跑酷最核心的“曲面引力”逻辑怎么在 Godot 中实现Ziva 这类物理/动画增强插件应该在流程的哪一步介入从空项目到一个可运行原型完整的操作路径是什么。2. 核心概念与工具边界2.1 Godot 引擎场景树、节点与 GDScriptGodot 是一个开源游戏引擎最核心的思维方式是“场景树”。一个游戏由多个场景组成每个场景由节点组成。节点有类型比如Node3D表示 3D 空间中的对象CharacterBody3D表示需要移动和碰撞的角色StaticBody3D表示静态障碍物Camera3D表示摄像机。extends CharacterBody3D # 这就是一个最简单的玩家角色 # CharacterBody3D 内置了 move_and_slide 方法方便处理碰撞移动GDScript 是 Godot 的内置脚本语言语法接近 Python非常适合作为游戏逻辑语言。它不需要编译改完代码直接运行就能看到效果这对 AI 辅助开发特别有利Claude 生成的脚本可以快速验证。2.2 ClaudeAI 编程助手能做什么、不能做什么Claude 是 Anthropic 推出的 AI 助手在代码生成上能力很强。但“能生成代码”和“能帮你做完游戏”是两回事。Claude 能做的根据需求描述生成完整的 GDScript 脚本解释 Godot 节点的用法和脚本之间的调用关系帮你重构代码、加注释、排查报错生成场景起步脚本、物理参数建议。Claude 不能做的替你做游戏设计决策替你理解项目里几十个脚本之间的状态流转替你调出“手感”替你验证逻辑是否正确。用 AI 开发游戏的正确心态是把 AI 当成一个能 24 小时回答问题的资深同事而不是一个全自动外包团队。2.3 Ziva 插件物理反馈与动画增强层“Ziva”在游戏开发圈一般会让人想到 Ziva Dynamics 那套角色肌肉模拟技术。在本文的项目里我们把它定位为一个 Godot 物理/动画增强插件的代号负责处理星球跑酷中最影响手感的几个环节角色与星球表面的摩擦力、落地时的碰撞反弹、障碍物被撞飞时的动态反馈。它的介入时机不是在写代码之前而是在基础玩法跑通之后。先用简单的PhysicsMaterial和碰撞体把流程打通再用插件增强表现。这个顺序很重要如果一上来就接插件你根本分不清问题是出在角色控制逻辑还是出在物理参数。3. 环境准备与前置条件3.1 安装 Godot 4.x去 Godot 官网下载 Godot 4.x 标准版即可不需要下载 .NET 版因为本文使用 GDScript不涉及 C#。下载后解压双击运行界面很简单。创建项目时选择“3D Scene”模板项目名称建议用PlanetRunner。# 如果你的系统是 Linux可以用命令行安装/启动 # 这只是示例具体以官网下载为准 # chmod x Godot_v4.x-stable_linux.x86_64 # ./Godot_v4.x-stable_linux.x86_64 --path /path/to/PlanetRunner在 Godot 里按F5可以直接运行当前项目按F6运行当前场景按CtrlS保存场景文件。这些快捷键会贯穿整个开发过程。3.2 使用 Claude 的准备你只需要一个能访问 Anthropic Claude 的账号以及一个能输入代码提示词的对话界面。本文的思路不依赖特定的 UI 版本你只需要保证能够复制粘贴代码提示词即可。如果你更习惯在终端里操作也可以使用 Claude Code 之类的命令行编程工具。但注意命令行版本对项目文件读写更主动新手容易搞乱项目结构建议先从对话式使用开始。3.3 用 Claude 做项目结构规划动手写代码之前先让 Claude 帮你规划项目结构。这是很多人忽略的一步但它能直接决定后续 AI 生成的代码能不能对得上。你可以把这个提示词发给 Claude我要在 Godot 4 中做一个 3D 星球跑酷游戏原型。请帮我规划项目结构包括 1. 场景文件应该怎么拆分 2. 玩家角色需要哪些节点 3. 星球表面、障碍物、计分逻辑分别放在哪里 4. 哪些脚本负责物理哪些脚本负责游戏逻辑。Claude 会给出类似这样的结构建议res://scenes/ Main.tscn # 主场景挂载 GameManager.gd Player.tscn # 角色场景挂载 Player.gd Planet.tscn # 星球场景挂载 Planet.gd Obstacle.tscn # 障碍物场景挂载 Obstacle.gd这一步的价值在于你带着项目结构再去写提示词Claude 生成的代码大概率能直接放进你的场景树里。如果你什么都不规划就直接让它生成脚本经常会出现“脚本写好了但节点对不上”的情况。4. 核心流程拆解4.1 需求拆分把“跑酷游戏”拆成可执行任务“做一个 3D 星球跑酷游戏”这句话人类听得懂但 AI 听了只会给你一份泛泛的计划。你需要把它拆成可验证的小任务角色能在一个球体表面上站立和移动角色始终受到指向星球中心的引力角色可以跳跃落地后能继续跑星球表面随机生成障碍物碰到障碍物后游戏结束按 R 键重新开始有一个简单得分机制比如跑动距离或跳过障碍数量。每个任务都是一个明确的提示词输入Claude 生成的代码也容易验证。4.2 场景搭建基础几何体代替建模不要被“3D”吓住。在原型阶段一个星球可以用SphereMesh代替角色可以用CapsuleMesh代替障碍物用BoxMesh代替。这些在 Godot 里都只需要几步操作。具体到节点结构你至少需要这些Main节点Node3DPlayer节点CharacterBody3D挂CollisionShape3D子节点加一个MeshInstance3DPlanet节点StaticBody3D挂CollisionShape3D子节点加一个MeshInstance3DCamera3D节点负责跟随玩家GameManager节点挂脚本处理得分和游戏状态。4.3 让 AI 写脚本的提示词模板经验是提示词里包含“角色类型、功能清单、边界要求、注释要求”四个部分。请编写一个 Godot 4 的 GDScript 脚本 Player.gd - extends CharacterBody3D - 角色始终受到指向星球中心的引力引力大小可通过 export 变量调整 - 支持 WASD 控制移动空格跳跃 - 跳跃时只在 is_on_floor() 为 true 时触发 - 移动方向应基于当前曲面法线计算 - 代码写清楚注释变量命名英文。把这段提示词给 Claude它生成的脚本已经和 90% 的需求匹配了。剩下的 10% 通过运行验证和微调补齐。4.4 跑酷机制与障碍物生成跑酷游戏的机制核心是“障碍生成”和“碰撞判定”。障碍物不需要手动摆用脚本在玩家前方一定距离随机生成即可。每次生成后从场景树中移除跑到玩家身后的障碍避免内存无限增长。4.5 Ziva 插件的介入时机当角色移动、跳跃、碰撞都已经能跑通但你觉得手感太“飘”或者碰撞太“硬”时就轮到 Ziva 插件出场了。它的任务是把物理材质、碰撞反馈和动画表现做得更细。比如地面摩擦力从 0.5 调到 0.8跑起来会有“抓地感”碰撞体改成球体撞到障碍物时更自然。5. 完整示例与代码实现下面进入实操。我假设你刚刚在 Godot 中创建了一个空项目项目名为PlanetRunner。5.1 创建主场景 Main.tscn在 Godot 中新建一个Node3D保存为Main.tscn。挂一个脚本Main.gd后续用这个脚本启动游戏逻辑# 文件路径res://scenes/Main.gd extends Node3D onready var player: CharacterBody3D $Player onready var planet: StaticBody3D $Planet onready var camera: Camera3D $Camera3D var score : 0 func _process(delta: float) - void: if player: # 显示实时分数只统计玩家与星球表面移动的相对距离 score int(max(score, player.global_position.distance_to(planet.global_position))) # 让摄像机跟随玩家 if camera and player.is_on_floor(): var target_camera_pos : player.global_position Vector3(0, 5, 6) camera.global_position camera.global_position.lerp(target_camera_pos, delta * 5.0) camera.look_at(player.global_position, Vector3.UP)这个脚本解决两个问题摄像机跟随以及实时计算跑动距离作为得分。lerp让镜头移动更平滑避免硬绑定导致的画面抖动。5.2 创建星球场景 Planet.tscn新建一个StaticBody3D保存为Planet.tscn。添加一个MeshInstance3DMesh 选择基础几何体中的 SphereMesh半径设为10。再添加一个CollisionShape3D形状也选 Sphere半径同样设为10。给Planet挂上Planet.gd# 文件路径res://scenes/Planet.gd extends StaticBody3D export var planet_radius: float 10.0 export var gravity_strength: float 18.0 func _ready() - void: # 加入 group方便玩家脚本动态查找星球 add_to_group(planets) # 初始化物理材质这是 Ziva 插件增强的基础物理层 var physics_mat : PhysicsMaterial.new() physics_mat.friction 0.8 physics_mat.bounce 0.1 $CollisionShape3D.shape physics_mat上面的代码中设置physics_mat只是一个示例实际节点操作应该在编辑器完成。这里最重要的逻辑是把星球加入planets分组玩家脚本运行时会去这个分组里找引力对象。5.3 创建玩家角色 Player.tscn新建一个CharacterBody3D保存为Player.tscn。添加一个CapsuleMesh作为可视化再添加一个CollisionShape3D形状选 Capsule。挂上Player.gd# 文件路径res://scenes/Player.gd extends CharacterBody3D class_name Player export var move_speed: float 8.0 export var jump_strength: float 7.0 export var turn_speed: float 8.0 var planet: Node3D var current_up: Vector3 Vector3.UP func _ready() - void: # 从分组中找到星球对象 if get_tree().has_group(planets): planet get_tree().get_first_node_in_group(planets) func _physics_process(delta: float) - void: if not planet: return # 1. 计算当前曲面法线作为“上方向” var target_up : (global_position - planet.global_position).normalized() current_up current_up.lerp(target_up, turn_speed * delta).normalized() if current_up.length() 0.001: current_up Vector3.UP # 2. 自定义引力始终向星球中心方向拉 velocity current_up * -planet.gravity_strength * delta # 3. 输入移动方向WASD var input_dir : Input.get_vector(move_left, move_right, move_forward, move_back) var right : current_up.cross(Vector3.FORWARD).normalized() var forward : right.cross(current_up).normalized() var move_dir : (right * input_dir.x forward * input_dir.y).normalized() if move_dir.length() 0.1: velocity.x move_dir.x * move_speed velocity.z move_dir.z * move_speed else: velocity.x move_toward(velocity.x, 0.0, move_speed * delta) velocity.z move_toward(velocity.z, 0.0, move_speed * delta) # 4. 跳跃只有在地面时才允许 if Input.is_action_just_pressed(jump) and is_on_floor(): velocity current_up * jump_strength # 5. 执行实际移动 move_and_slide()这段代码是星球跑酷的核心。注意current_up这个变量它代表玩家脚下当前的方向。在平面游戏中上方向永远是Vector3.UP但在星球表面玩家的“上方向”应该始终指向星球球心否则角色走到星球背面时会掉下去。5.4 配置输入映射在项目设置 - 输入映射中添加上面代码里用到的动作move_leftA / 左箭头move_rightD / 右箭头move_forwardW / 上箭头move_backS / 下箭头jump空格键如果你希望让 Claude 直接生成输入配置可以用这个提示词请为 Godot 4 项目生成 InputMap 的配置片段动作名包括 move_left、move_right、move_forward、move_back、jump。输出为 project.godot 中 [input] 的格式。不过手动在编辑器里设置更直观也方便后续微调按键。5.5 障碍物生成逻辑 ObstacleSpawner.gd为了让游戏有“跑酷”的感觉不能只做一个静态星球。我们需要在玩家前方动态生成障碍物。新建一个Node3D挂ObstacleSpawner.gd# 文件路径res://scenes/ObstacleSpawner.gd extends Node3D export var player: CharacterBody3D export var obstacle_scene: PackedScene export var spawn_interval: float 2.0 export var spawn_distance: float 15.0 export var despawn_distance: float 20.0 var timer : 0.0 func _physics_process(delta: float) - void: if not player: return timer delta if timer spawn_interval: timer 0.0 _spawn_obstacle() _despawn_behind_obstacles() func _spawn_obstacle() - void: if obstacle_scene null: return var obstacle: Node3D obstacle_scene.instantiate() add_child(obstacle) # 在玩家前方生成障碍物位置略偏离直线 var forward : (player.global_position - player.get_parent().global_position).normalized() var random_offset : Vector3(randf_range(-2.0, 2.0), 0.0, randf_range(-2.0, 2.0)) obstacle.global_position player.global_position forward * spawn_distance random_offset func _despawn_behind_obstacles() - void: for child in get_children(): if child is Node3D: var dist : child.global_position.distance_to(player.global_position) if dist despawn_distance: child.queue_free()为了让这段代码运行你还需要一个Obstacle.tscn。最简单的方式是创建一个StaticBody3D加一个 BoxMesh 和 BoxShape3D 碰撞体然后把它保存为单独场景再把ObstacleSpawner的obstacle_scene导出属性拖入这个场景。5.6 Ziva 插件接入示例前面说过Ziva 插件的角色是物理增强。在 Godot 中物理材质是最容易操作的增强手段。下面这段代码来自一个简单的增强脚本你可以把它挂到角色子节点上# 文件路径res://scripts/ZivaEnhancer.gd # 这个脚本以“Ziva 插件”的定位演示如何在运行时调整物理参数 extends Node export var target_body: CharacterBody3D export var ground_friction: float 0.9 export var air_control: float 0.3 func _ready() - void: if not target_body: return # 增强地面摩擦力减少打滑让跑酷角色更稳 target_body.physics_material_override PhysicsMaterial.new() target_body.physics_material_override.friction ground_friction target_body.physics_material_override.bounce 0.0在完整项目中Ziva 插件可能会提供更丰富的功能比如软体模拟、动画混合、拉力反馈。但从工程角度来看任何插件接入项目的第一件事都是先调整物理材质和碰撞行为确认基础手感没问题再叠加高级功能。6. 运行结果与效果验证6.1 运行命令在 Godot 编辑器中打开Main.tscn按F5运行项目。6.2 预期效果你应该看到玩家角色站在一个巨大的球体表面按 WASD 键角色可以沿着星球表面移动按空格键角色可以跳起来然后落回地面摄像机平滑跟随角色每过 2 秒玩家前方会生成一个障碍物撞到障碍物后画面没有反应因为我们还没有写死亡判定。6.3 如何判断核心逻辑成功判断标准不是“画面好不好看”而是下面几个技术点是否成立角色在星球背面时不会往下掉current_up始终指向远离星球中心的方向跳跃只能在is_on_floor()时触发障碍物不会生成在玩家身体内。如果前面三项都成立说明星球引力系统和角色控制已经正确工作。6.4 失败排查第一步运行后发现角色直接往下掉或者一运行就报错先看这两处第一检查Planet是否在planets分组中。可以直接在“场景”面板选中Planet在“节点”页签中查看 Groups。第二检查Player.gd的get_first_node_in_group(planets)是否返回了节点。如果Planet加载比Player晚或Player不在当前活动场景中脚本可能会返回null。可以在_ready里加一行print(planet)来确认。7. 常见问题与排查思路问题现象可能原因排查方式解决方案运行 F5 后没有画面主场景未设置为 Main.tscn查看项目设置中的 Run/Main Scene将 Main.tscn 设为主场景角色直接穿透星球下落星球 CollisionShape3D 缺失或尺寸不对检查 Planet.tscn 是否有 CollisionShape3D添加 SphereShape3D半径与 Mesh 一致角色无法跳跃输入映射中没有 jump 动作打开项目设置检查 Input Map添加 jump 动作并绑定空格键角色走路很滑物理材质摩擦系数太低检查 Planet 的 physics_material_override将摩擦系数调高到 0.8 以上障碍物生成在场景原点ObstacleSpawner 的 player 属性未赋值查看场景树中 spawner 位置在 Inspector 中把 Player 拖入 player 槽位摄像机抖动严重lerp 系数过大或视角方向计算不稳先固定 camera.look_at 的 up 参数将 up 参数固定为 Vector3.UP或根据 current_up 动态计算AI 生成的脚本报错未知标识符 is_on_floor脚本没有挂在 CharacterBody3D 上检查脚本 extends 和挂载对象类型确认脚本挂载在 CharacterBody3D 类型节点上插件启用后角色动作异常插件的物理覆盖与自定义引力冲突先禁用插件确认基础逻辑正常分步调试先跑通基础移动再开启物理增强如果你发现 AI 生成的脚本抱错最有效的方法是把完整报错信息直接贴回给 Claude并附上相关脚本内容。因为这个报错信息往往已经包含了行号AI 能更快定位问题。8. 最佳实践与工程建议8.1 给 AI 的提示词要带“边界条件”很多人让 AI 写代码得到的代码“能用但不好用”原因是提示词里没有写清楚边界条件。比如单纯说“实现角色移动”AI 会给出一段平面移动脚本但如果你说“角色在球面表面移动上方向要实时计算”代码质量会完全不同。建议提示词模板请用 GDScript 编写 [脚本名]目标是 [功能描述]。 要求 1. 节点类型是 [Node/Node3D/CharacterBody3D] 2. 关键条件[边界条件] 3. 使用 Godot 4 的 API 4. 变量命名英文注释简洁。8.2 永远先跑通最小原型再接插件在一个项目中同时引入“AI 生成代码”“3D 物理引擎”“第三方插件”三个变量一旦出错很难定位。正确顺序是只用基础几何体跑通角色移动加入星球引力逻辑加入障碍生成和碰撞最后接入 Ziva 插件增强物理表现。每一步都验证完成后再进入下一步。尤其是插件应该在基础玩法稳定之后再接入否则你会把“游戏逻辑问题”和“插件配置问题”混在一起排错难度成倍上升。8.3 使用版本管理让 AI 的每次改动都可回滚AI 生成代码时经常会出现“改了一个脚本另一个脚本的接口对不上”的情况。建议在项目根目录执行git init每次让 Claude 改动之前先提交一次git init git add . git commit -m feat: 基础星球跑酷原型跑通这样 AI 生成的代码如果破坏了原有功能可以一键回滚。独立开发项目同样需要版本管理这不是团队的专利。8.4 关于 AI 生成代码的安全边界Claude 生成的代码本质上是“不可信的外部输入”不能直接在生产环境使用。它可能会调用不存在的 API、遗漏边界判断甚至在插件接入场景中生成不安全的操作。在使用 AI 代码时要遵守几条原则只在测试项目中尝试它生成的破坏性操作比如删除节点、修改文件涉及权限、网络、文件写入的逻辑要人工复核在生产环境中AI 生成的代码必须经过 review 和自动化测试不要直接把 AI 生成的正则表达式、路径拼接逻辑用于用户输入场景容易产生安全问题。这一点在游戏项目中容易被忽视但很重要。尤其当你用 Claude Code 这类能直接操作文件系统的工具时一定要限制它的工作目录权限。8.5 手感参数单独管理跑酷类游戏的手感决定成败。建议把重力、速度、跳跃力度、摩擦系数等参数全部做成export变量集中放在一个GameConfig.gd或资源文件中方便反复调节# 文件路径res://scripts/GameConfig.gd extends Resource export var move_speed: float 8.0 export var jump_strength: float 7.0 export var gravity_strength: float 18.0 export var friction: float 0.8 export var bounce: float 0.1这样做的好处是你可以用 Claude 生成多个参数组合然后快速切换对比手感而不是每次都在脚本里找数字改。9. 总结与后续学习方向这篇文章真正讲清楚了几件事AI 辅助开发不是“让 AI 全做”而是“让 AI 做重复编码你做设计决策”3D 星球跑酷的核心不是建模和美术而是“曲面引力”和“曲面角色控制”这套物理逻辑Claude 生成 GDScript 时提示词里的边界条件决定了结果质量Ziva 这类插件应该在基础逻辑跑通后再接入它的作用是锦上添花而不是雪中送炭。你现在应该有一个可以在 Godot 4 中运行的 3D 星球跑酷原型包括角色移动、跳跃、摄像机跟随、障碍物生成这些基础功能。建议你做的下一步是给角色添加更多动作滑铲、二段跳、冲刺让星球旋转增加跑酷的难度变化把障碍物换成不同高度的类型迫使玩家跳跃或闪避接入 Ziva 插件重点调碰撞反馈和摩擦手感加入分数 UI让玩家能看到实时得分。如果后续想深入可以重点补三块内容Godot 的场景树组织方式、CharacterBody3D 与 RigidBody3D 的选型区别、物理材质与碰撞层配置。这三块是 3D 游戏开发里最容易踩坑也最值得花时间理解的地方。最后建议收藏这篇文章按章节操作时每一步都可以对照。如果你在实现过程中遇到报错把本文里的模板代码和报错信息一起发给 Claude它会给你更有针对性的修复建议。做完上面的基础版本之后记得先跑一遍git commit给这个周末的努力留个存档。