企业官网建设流程全解析

这次我们来看一个可以直接抄作业的实战项目：用 Claude Fable 5.1 作为 AI 辅助编程层，配合 Ziva 插件和 Godot 引擎，从零做出一款 3D 星球跑酷游戏。

先说结论：这套方案不是拿 AI 拼一个“看起来能跑”的 Demo，而是把完整的游戏开发流程拆给 AI 做——场景搭建、角色控制、障碍物生成、碰撞逻辑、UI 循环，每一步都可以让 Claude 生成对应脚本，你只负责组织节点、填参数、验证手感。Ziva 插件在这条工作流里扮演的是“Godot 侧辅助管理”的角色，把 AI 生成的脚本和资源有序接入编辑器。整个过程不需要专业 3D 建模基础，跑酷场景全部用 Godot 原生几何体加少量程序化纹理完成。

硬件门槛可以放心。如果你只是用 Claude 的云端能力写代码、做逻辑，本机只需要一台能运行 Godot 的电脑，核显也能跑；只有当你把本地 AI 图像/3D 模型生成接进来出素材时，才开始关注显存。也就是说，这篇内容对显卡一般、想试 AI 辅助游戏开发的同学非常友好。

本文会带你完整走一遍：游戏结构设计、Godot 4 环境准备、Claude Code 命令行接入、3D 星球场景搭建、玩家角色控制脚本、障碍物批量生成、游戏循环与 UI、性能观察、常见问题排查。看完你不仅能把这款星球跑酷跑起来，还能把“AI 辅助做游戏”的流程复制到自己的项目里。

1. 核心能力速览

这套组合的优势是“写代码的部分几乎全部外包”。跑酷游戏逻辑本身不算复杂，但代码量大且琐碎：角色移动、跳跃手感、障碍物生成、碰撞检测、分数刷新、死亡重开，每一项都需要细心调。Claude Fable 5.1 处理这类结构化需求非常合适，它能给出完整 GDScript 脚本，并且能根据你的报错信息反复修改，直到游戏跑通。

2. 游戏结构设计先想清楚，再让 AI 动手

很多人在 AI 辅助游戏开发时容易犯一个错：安装完 Godot 就直接打开 Clude，说“帮我写个跑酷游戏”，然后得到一堆孤立脚本，完全接不上。正确的顺序应该是先把游戏拆成模块，再每个模块单独让 AI 生成。

3D 星球跑酷游戏的最小闭环如下：

1. 角色在一条星球表面的跑道上不停前进。
2. 玩家控制角色跳跃、左右切换、下蹲，躲避障碍。
3. 障碍物随机生成，越往后刷得越快。
4. 碰到障碍物则游戏结束，显示分数。
5. 按 R 键或点击按钮重新开始。

把这个闭环拆成技术模块：

我的建议是，先写好一份game_design.md，把这个表格和核心玩法写进去。Ziva 插件的作用在这里体现：你可以把这份设计文档直接交给 AI 对话，让 AI 对着需求产出脚本，插件再把脚本挂到对应 Node 上。这样每一步都有据可查，不会出现 AI 写完脚本不知道挂到哪里的尴尬。

模块划分完，就可以让 Claude 先生成关卡配置数据。下面是一份很基础的 JSON 配置模板，它决定了不同难度阶段障碍物的刷新间隔和生成速度，后面可以直接由 AI 批量扩展：

{ "levels": [ { "level": 1, "distance_min": 0, "distance_max": 500, "spawn_interval": 1.2, "obstacle_speed": 10.0, "obstacle_types": ["box", "pillar"] }, { "level": 2, "distance_min": 500, "distance_max": 1200, "spawn_interval": 0.9, "obstacle_speed": 13.0, "obstacle_types": ["box", "pillar", "spinner"] }, { "level": 3, "distance_min": 1200, "distance_max": 99999, "spawn_interval": 0.7, "obstacle_speed": 16.0, "obstacle_types": ["box", "pillar", "spinner", "wall"] } ] }

关卡数据单独放一个文件的好处是，难度调整不需要改代码。你以后想让 AI 生成 20 个关卡，直接给它这个文件的格式模板就行。

3. 环境准备与本地部署

3.1 安装 Godot 4.x

Godot 官网提供了标准版和 Mono 版。这次项目不需要 C#，直接用标准版即可。安装过程非常简单，下载解压后打开Godot.exe（Windows）或Godot.app（macOS）就能启动。

建议版本选择 Godot 4.x 的最新稳定版，因为本项目的 3D 物理、光照、材质系统都以 4.x 为准。打开项目管理器后，选择“新建项目”，渲染器选Forward+（如果你的电脑比较老，选 Mobile 或 Compatibility 也能跑，但光照效果会有差别）。项目记得勾选“创建文件夹”。

3.2 安装 Claude Code 命令行工具

Claude Code 是这次工作流里最常用的工具。它的安装方式很简单：

npm install -g @anthropic-ai/claude-code

安装完成后，在终端输入：

claude --version

看到版本号就说明装好了。这一步最常见的问题是系统提示“无法将 claude 项识别为 cmdlet、函数、脚本文件或可运行程序的名称”，这大概率是 npm 的全局 bin 目录没有加到系统 PATH 里。解决方法是找到 npm 全局目录，把它加入 PATH，或者在 PowerShell 里用 npx 方式运行：

npx @anthropic-ai/claude-code

首次运行 Claude Code 会要求登录授权，按终端提示完成即可。请关闭当前终端后重新打开一个新的终端窗口，有时候 PATH 更新不会自动生效。

3.3 安装 Ziva 插件

Ziva 插件在本次工作流中负责把 AI 生成的脚本和资源组织进 Godot 场景。安装方式遵循 Godot 插件通用流程：

1. 将插件文件夹复制到项目的addons目录下。
2. 打开 Godot，进入项目设置 -> 插件（Plugins）。
3. 找到 Ziva 插件并启用。
4. 启用后，编辑器顶部会多出对应工具按钮，具体功能以插件版本为准。

如果你拿到的插件包没有明确说明安装位置，标准做法就是在项目根目录新建addons文件夹，把解压后的插件目录整个放进去，再回编辑器刷新启用。

4. 用 AI 辅助搭建 3D 星球场景

游戏名里有“星球”，场景氛围就围绕一个低多边形风格的星球表面展开。跑酷跑道可以做成一条环绕星球表面的环形路径，也可以做成平面道路加上星球背景。从原型验证角度看，后者更省事，效果也不差。

先创建基础场景：

1. 在场景根节点新建Node3D，命名为World。
2. 创建一个DirectionalLight3D，开启阴影。
3. 创建一个WorldEnvironment，Environment 选择带天空背景的预设。
4. 添加三个MeshInstance3D：一个大球体做星球背景、一个扁平长方体做跑道、若干长方体做障碍物。

星球背景的球体要使用无光照或者不受阴影影响的材质。可以让 Claude 生成一个程序化纹理脚本，给球体表面叠加类似地表颜色的噪声，做成“星球”效果：

extends MeshInstance3D # 让星球缓慢自转，营造跑酷发生在星球表面的氛围 @export var rotation_speed: float = 0.05 func _process(delta: float) -> void: rotate_y(rotation_speed * delta)

这段脚本挂在星球 MeshInstance3D 上即可。如果想省事，干脆在 Godot 的材质属性里新建一个NoiseTexture2D作为 Albedo 纹理，一样能得到地表纹理效果，不需要额外写代码。

接着把跑道做出来。跑道可以使用StaticBody3D加BoxShape3D碰撞盒，确保角色不会掉下去。为了让玩家有移动速度感，可以在跑道上贴一个强对比度的网格纹理，或者在两侧放置连续排列的柱子，跑起来视觉反馈会更明显。

这块内容全部完成后，让 Claude 帮你做一次检查。你可以直接把项目结构和场景 Node 树截图发给 Claude，或者把 tscn 文件内容贴给它，让它指出哪些节点缺材质、缺碰撞、缺脚本。这一步能省下大量排查问题的时间。

5. 玩家角色与移动控制（GDScript）

玩家角色是跑酷游戏的核心。这里使用 Godot 的CharacterBody3D类型，它自带移动和碰撞检测接口，非常适合做平台类游戏。

新建一个场景，根节点为CharacterBody3D，重命名为Player，挂上CollisionShape3D并用球体或胶囊体作为碰撞形状。视觉上可以放一个小球或一个小机器人模型，本文直接用球体加两个小方体做眼睛，非常像“星球跑酷者”。

下面是一段基础的角色控制脚本，包含前进、跳跃、左右切换和重力：

extends CharacterBody3D @export var move_speed: float = 10.0 @export var jump_velocity: float = 8.0 @export var gravity: float = 20.0 @export var lane_change_speed: float = 8.0 @export var lane_offsets: Array[float] = [-2.0, 0.0, 2.0] var current_lane: int = 1 func _physics_process(delta: float) -> void: # 重力 if not is_on_floor(): velocity.y -= gravity * delta else: velocity.y = 0.0 # 跳跃 if Input.is_action_just_pressed("ui_up") and is_on_floor(): velocity.y = jump_velocity # 左右切换 if Input.is_action_just_pressed("ui_left"): current_lane = max(current_lane - 1, 0) if Input.is_action_just_pressed("ui_right"): current_lane = min(current_lane + 1, lane_offsets.size() - 1) # 计算目标 X 位置 var target_x: float = lane_offsets[current_lane] var current_x: float = global_position.x var new_x: float = move_toward(current_x, target_x, lane_change_speed * delta) global_position.x = new_x # 前进速度沿 Z 轴 velocity.z = -move_speed move_and_slide()

这段代码的思路是所有角色始终沿 Z 轴负方向前进，玩家只能在 X 轴方向切换三条跑道。lane_offsets定义了三条跑道的 X 坐标，通过左右按键切换current_lane，角色就会平滑移动到对应位置。

跑酷手感的重点参数：

• move_speed决定整体速度，默认 10 偏慢，实际跑起来可以调到 14 到 18。
• jump_velocity控制跳跃高度，8 到 10 之间比较舒服。
• lane_change_speed是换道速度，太大会瞬移，太小会手感黏滞，建议 6 到 10。

输入映射需要在项目设置 -> 输入映射里配置ui_left、ui_right、ui_up。跑酷游戏通常还会把空格的物理键映射到跳跃，方便玩家操作。

AI 在生成这段脚本的时候通常会给你基础版本，你只需要把参数改到自己舒服的数值。如果跳跃落地后总是滑一下，就在_physics_process里把 Y 轴速度落地面后的值强制清零，这一步已经写在上面代码里了。

6. 障碍物生成与碰撞处理

跑酷游戏的第二关键模块是障碍物生成器。障碍物不能手动在编辑器里摆几百个，必须靠脚本按距离或时间生成。为了提高性能，还需要做对象池，而不是每次new一个新节点。

下面是一段基础的ObstacleSpawner.gd，挂在World下的一个空节点上：

extends Node @export var obstacle_scene: PackedScene @export var spawn_interval: float = 1.0 @export var spawn_distance: float = -30.0 var timer: float = 0.0 func _ready() -> void: # 初始生成几个障碍物 spawn_obstacle() func _physics_process(delta: float) -> void: timer += delta if timer >= spawn_interval: timer = 0.0 spawn_obstacle() func spawn_obstacle() -> void: if obstacle_scene == null: return var obstacle: Node3D = obstacle_scene.instantiate() add_child(obstacle) obstacle.global_position = Vector3(randf_range(-2.0, 2.0), 0.5, spawn_distance)

这里obstacle_scene是障碍物预制体，在 Godot 编辑器里把障碍物场景拖到该脚本的obstacle_scene属性即可。每次生成时把它放在玩家前方spawn_distance处，玩家前进后会主动撞上去。

障碍物的移动有两种做法。一种是障碍物自身沿 Z 轴正方向移动，玩家不动；但本文的玩家角色已经写了velocity.z = -move_speed，所以实际上玩家在前进，障碍物只需要静止等待撞上即可。当障碍物被玩家超过并远离摄像机后，应该回收或删除，避免场景里堆太多实例导致掉帧：

func _on_visible_on_screen_notifier_screen_exited() -> void: queue_free()

给每个障碍物挂一个VisibleOnScreenNotifier3D，当它离开屏幕时就自动释放。如果障碍物生成频率高、数量大，再进一步改成对象池。

碰撞检测可以直接在 Godot 编辑器里给障碍物的StaticBody3D加Area3D子节点，然后连接body_entered信号。下面是被碰撞后的处理代码：

extends Area3D signal game_over func _on_body_entered(body: Node3D) -> void: if body.name == "Player": game_over.emit()

把game_over信号传给游戏控制器，弹结束界面。

这部分代码非常适合让 AI 给你批量生成不同障碍物类型。你可以给 Claude 一个提示：

请生成一个墙型障碍物 WallObstacle.tscn，高度为 2 米、宽度 3 米，并挂上碰撞盒和 VisibleOnScreenNotifier3D 脚本。再生成另一个旋转障碍物 SpinnerObstacle.tscn，带一个绕 Y 轴旋转的叶片节点。两者都用 StaticBody3D。

使用 Claude Code 直接在项目目录里对话，它会直接创建对应的.tscn和.gd文件。生成后回到 Godot 编辑器刷新，就能在文件系统里看到新文件了。

7. 游戏循环、UI 与重新开始

没有 UI 和状态管理的跑酷游戏只能算技术演示。这一节补齐分数、结束界面、重新开始逻辑。

建议新建一个全局自动加载节点GameManager，用来保存得分、游戏状态和响应游戏结束。辅助开发过程中的节奏是：先让 Claude 设计状态管理，再生成 UI 脚本。

第一步，在项目设置 -> 自动加载中注册GameManager.gd：

extends Node signal score_changed(new_score: int) signal game_ended var score: int = 0 var is_running: bool = false func start_game() -> void: score = 0 is_running = true score_changed.emit(score) func add_score(points: int) -> void: if not is_running: return score += points score_changed.emit(score) func end_game() -> void: is_running = false game_ended.emit()

第二步，在玩家场景里加一个Area3D作为得分判定区，放在角色前方一点，碰撞后调用GameManager.add_score(1)：

func _on_score_area_body_entered(body: Node3D) -> void: if body.name == "Player": GameManager.add_score(1)

第三步，创建 UI。新建一个CanvasLayer，添加一个Label显示分数，和一个带“重新开始”按钮的Control面板，默认隐藏。UI 脚本如下：

extends CanvasLayer @onready var score_label: Label = $ScoreLabel @onready var end_panel: Control = $EndPanel @onready var final_score_label: Label = $EndPanel/FinalScoreLabel func _ready() -> void: GameManager.score_changed.connect(_on_score_changed) GameManager.game_ended.connect(_on_game_ended) func _on_score_changed(new_score: int) -> void: score_label.text = "Score: " + str(new_score) func _on_game_ended() -> void: end_panel.visible = true final_score_label.text = "Final Score: " + str(GameManager.score) get_tree().paused = true func _on_restart_button_pressed() -> void: get_tree().paused = false get_tree().reload_current_scene()

注意get_tree().paused = true之后，会自动暂停所有节点的处理。重新开始时先取消暂停，再重载当前场景，这是跑酷原型最省事的重开方式。

把“重新开始”按钮的pressed信号连接到_on_restart_button_pressed，整个游戏闭环就通了：开局、跑动、得分、碰撞结束、重开。

8. 接口 API 与批量任务：用 Claude 批量产出模块

很多读者会问，Claude Fable 5.1 在这套工作流里到底怎么批量干活？它确实不提供传统意义上的游戏运行时 API，但开发阶段的价值在于批量生成代码和配置。

最直接的批量方式是在项目根目录打开 Claude Code，进入交互式对话，然后一次性提出一组模块需求。例如：

cd your-godot-project claude

然后在对话里输入：

请帮我在 scripts/ 下完成以下任务： 1. 生成一个 PowerUp.gd，做一个简单的加速道具，玩家碰到后 move_speed 增加 2 持续 3 秒； 2. 生成一个 ScoreManager.gd，作为自动加载节点管理分数和最高分； 3. 检查我当前场景里所有脚本中与 Z 轴移动相关的代码，确保速度统一。

Claude 会逐个文件生成，并告诉你每个脚本应该挂载到哪个节点。遇到报错，直接把错误信息复制给它，让它重新修改。这就是“AI 驱动开发”的核心循环：需求 -> 生成 -> 报错 -> 修复 -> 验证。

对于关卡配置这类纯数据，可以做更夸张的批量操作。你只需要把第一个 JSON 关卡样本给它：

参照下面的关卡格式，为我生成 20 个不同难度档位的关卡配置，要求 5 米一档，障碍物类型可以组合，包括 box、pillar、spinner、wall，难度递增但不要出现必死组合。

它会输出一份完整的levels.json，你直接放进项目资源目录。相比手写 20 个关卡，这一步至少节省半小时。

执行批量生成任务时注意几个问题，否则很容易失败：

1. 一次任务只围绕一个模块。让 Claude 同时改角色脚本、生成 UI、又写敌人 AI，容易互相污染。
2. 每次生成前给足上下文。把当前文件的关键代码贴给它，或者明确说明 Godot 版本是 4.x。
3. 生成后马上在 Godot 里验证。等待时间越长，越难定位是 AI 代码的问题还是自己操作的问题。
4. 失败的脚本不要硬修。如果 Claude 连续两次改错同一段逻辑，直接让它重新生成整个文件，往往比修来修去更快。

9. 资源占用与性能观察

资源占用是游戏开发里绕不开的问题，但也要分清楚瓶颈在哪。

如果只跑 Godot 做游戏开发，瓶颈基本不在显存，而在 CPU 和内存。Godot 的 3D 场景如果实例数量过多、光照太复杂，CPU 会因为物理计算和渲染命令生成而吃紧。跑酷游戏最常见的性能问题是障碍物无限生成，几十分钟后场景里有成百上千个静态节点，编辑器都会卡。使用VisibleOnScreenNotifier3D回收节点，或者用对象池，能明显改善。

显存占用方面，Godot 编辑器预览一个中等复杂度 3D 场景，显存占用通常在几十到几百 MB 级别。如果你只是把 AI 生成的模型和材质放进去，这个数字不会突然飙升；真正吃显存的是高分辨率纹理、大量粒子、实时阴影和屏幕空间效果。如果你的电脑显存只有 2G 到 4G，建议在项目设置里把环境的光照和阴影质量调低，阴影贴图尺寸降为 4096，禁用 SSAO 和辉光。

性能观察的具体操作流程：

1. 在 Godot 编辑器中运行游戏。
2. 打开调试 -> 监视器（Monitors）面板。
3. 观察物理进程时间、渲染帧时间、节点数量、内存占用。
4. 大量生成障碍物之后，重点看节点数量是否线性增长，如果一直涨不回收，就是对象池没有生效。

没有拿到你设备的具体配置前，任何“显存占用数字”都是参考值。更稳妥的判断标准是：游戏稳定运行时帧率是否保持在 60 FPS，编辑器和运行时的内存峰值是否在可接受范围内。如果帧率掉到 30 FPS 以下，优先检查场景节点数量和阴影设置，而不是盲目换显卡。

10. 常见问题与排查方法

排查原则：先看报错，再看场景树，最后看代码。AI 生成的脚本最常见问题不是语法错误，而是节点路径和场景结构对不上。遇到信号连不上、变量为 null 的情况，先检查@onready var后面的路径与实际编辑器场景树结构是否一致。

11. 最佳实践与合规建议

AI 辅助游戏开发不只是“让 Claude 写几个脚本”，它的正确打开方式是一套工程化流程。

第一，先写设计文档再写代码。哪怕只有一页纸，把玩法循环、技术模块、角色能力、难度参数写清楚，AI 生成的质量会差非常多。Claude Fable 5.1 对结构清晰的需求响应质量远高于一句“帮我做个游戏”。

第二，保留一套最小可运行配置。每次新增功能前，先确认当前游戏能跑。AI 生成了大量新脚本后，不要一次性全挂到场景里，而是逐个挂载、逐个验证。这样一旦出错，可以快速回退到上一个可运行版本。

第三，AI 代码必须人工审查。不是每个 AI 生成的脚本都能直接进项目。至少在挂载脚本后跑一次完整流程，检查是否有路径硬编码、魔法数字过多、queue_free()缺失等问题。特别是在多人协作项目里，AI 生成代码混入生产分支前，一定要做代码评审。

第四，素材与版权必须小心。跑酷游戏里如果用到了外部下载的 3D 模型、音乐、音效，要确认授权类型。建议优先使用 CC0 或自己生成的素材。AI 生成的纹理和模型也建议记录生成工具和参数，方便后续追溯。

第五，不要把敏感信息丢给云端 AI。游戏内若包含商业项目代码、玩家隐私数据、未公开的商业配置，不要直接粘贴给 Claude。可以把代码抽象为最小可运行 Demo，或者只粘贴关键函数片段。接口密钥、数据库地址、云服务凭据绝对不要出现在对话内容里。

第六，合规部署。如果后续要把游戏导出到 Steam、移动端或者网页端，需要确认 AI 辅助生成内容的合规性。不同平台对 AI 生成内容的上架披露要求可能不同，发布前查看对应平台政策。涉及玩家数据收集的功能，要遵守隐私和数据保护相关规定。

12. 总结与下一步

这套工作流最值得尝试的地方，是把“从零做 3D 游戏”的门槛从“会写代码”降到了“会描述需求 + 会组织场景”。你可以不精通 GDScript，但只要游戏设计拆得够细，Claude Fable 5.1 能在几分钟内把对应的脚本模块写完，Ziva 插件再帮你把这些模块接入 Godot 场景树。对整个项目来说，最快的一天内就能从一个空白工程推进到“能跑、能跳、能撞、能计分”的可玩原型。

拿到原型后，建议先验证三件事：跳跃手感是否舒服、障碍物刷新频率是否合理、游戏结束重开是否顺畅。最容易踩的坑是角色碰撞盒偏大导致“没碰到却死了”，以及障碍物生成频率过快导致新手无法反应。这两个问题通常调参数就能解决，不需要改代码结构。

等核心跑步循环稳定后，可以继续扩展：滑行动作、加速道具、金币收集、远景星球渐变、多个性格不同的角色皮肤、音效和 BGM、Android 导出。每个新功能都可以继续用这套“AI 生成 -> 人工挂载 -> 实测调参”的流程，节奏非常适合独立玩家。

建议先把本篇下载收藏，然后新建一个 Godot 项目，按第 3 章开始装环境。跑通第一个角色控制脚本后，你会直观感受到 AI 辅助游戏开发到底能省多少时间。