手把手教你godot的第一个项目：自由落体方块

构建框架

使用Godot 4.x 标准版本 windows11系统

新建项目

• 运行 Godot

• 点击右侧的 "新建项目"

• 选择项目位置和名称

• 选择渲染器为 "Forward+"（默认选项）

• 点击 "创建并编辑"

创建游戏场景：

• 在场景面板中，点击 "+" 号添加根节点

• 选择 "Node2D" 作为根节点

• 重命名根节点为 "Game"

• 保存场景（按 Ctrl+S），命名为 "game.tscn"

添加球体

• 右键点击 "Game" 节点，选择 "添加子节点"

• 搜索并选择 "CharacterBody2D"

• 重命名为 "Ball"

• 再次右键 "Ball" 节点，添加 "CollisionShape2D" 子节点

• 添加 "Sprite2D" 子节点到 "Ball" 下 （这里需要后续操作！）

设置球体的外观和碰撞：

• 选择 "CollisionShape2D" 节点

• 在检查器中，设置 "Shape" 属性

• 选择 "新建CircleShape2D"

• 鼠标拖动并调整球的大小

添加简单的脚本

extends CharacterBody2D

var gravity = 980
var bounce_strength = -400

#func _ready():
	## 设置ball的初始位置
	#position = Vector2(352, 100)

func _physics_process(delta: float) -> void:
	velocity.y += gravity * delta
	
	var collision = move_and_collide(velocity * delta)
	if collision:
		velocity = velocity.bounce(collision.get_normal()) * 0.8

添加地面

Game (Node2D)
├── Ball (CharacterBody2D)
│   ├── CollisionShape2D
│   └── Sprite2D
└── Ground (StaticBody2D)
    └── CollisionShape2D
    └── Sprite2D

为1.3步骤中的球体添加纹理：

为 Sprite2D 添加纹理：

• - 选择 Ball 节点下的 Sprite2D
• - 在右侧检查器中，找到 Texture 属性
• - 点击右侧的下拉箭头，选择 "新建 GradientTexture2D"- 设置尺寸为 96x96（与碰撞形状大小匹配）
• - 选择一个颜色（比如蓝色）

基础知识

Node2D

• 这是一个基础的 2D 节点类型

• 用于在 2D 空间中组织和管理其他节点

• 具有位置、旋转、缩放等基本 2D 变换属性

• 在您的项目中，它作为根节点用来组织整个场景

CharacterBody2D

• 这是一个专门用于制作可控制角色的物理节点

• 具有内置的物理属性（如速度、碰撞检测等）

• 适合制作受物理影响的游戏对象

• 在您的项目中，用它来实现小球的物理运动和碰撞

GradientTexture2D

• 这是一个用于生成渐变纹理的资源

• 可以创建简单的纯色或渐变效果

• 在您的项目中用于：

  • 给小球一个可见的外观

  • 给地面一个可见的外观

• 可以通过设置 width 和 height 来控制纹理大小

Sprite2D ：

• 用于显示 2D 图像的节点

• 可以显示纹理（比如您使用的 GradientTexture2D）

• 支持缩放、旋转等变换

StaticBody2D ：

• 用于创建静态的物理物体

• 不会移动但可以与其他物体发生碰撞

• 在您的项目中用作地面

脚本代码解释

extends CharacterBody2D

var gravity = 980
var bounce_strength = -400

func _physics_process(delta):
    velocity.y += gravity * delta
    
    var collision = move_and_collide(velocity * delta)
    if collision:
        velocity = velocity.bounce(collision.get_normal()) * 0.8

1. extends CharacterBody2D

   • 这行表示我们的脚本继承自 CharacterBody2D 节点

   • CharacterBody2D 是 Godot 中用于制作可移动物体的节点类型

2. var gravity = 980和var bounce_strength = -400

   • 定义了两个变量

   • gravity 表示重力加速度，数值 980 模拟现实世界的重力

   • bounce_strength 定义了弹跳力度（虽然在这个代码中暂时没有使用）

3. func _physics_process(delta):

   • 这是一个特殊的函数，每个物理帧都会自动执行

   • delta 参数表示两帧之间的时间间隔（秒）

   • 用于处理物理相关的更新

4. velocity.y += gravity * delta

   • velocity 是 CharacterBody2D 内置的速度属性

   • 这行代码让球体受重力影响

   • 每帧都增加向下的速度（y 轴正方向是向下的）

5. var collision = move_and_collide(velocity * delta)

   • move_and_collide 是移动物体并检测碰撞的函数

   • 返回碰撞信息（如果发生碰撞）

   • velocity * delta 计算这一帧中物体应该移动的距离

6. if collision:

   • 检查是否发生碰撞

   • 如果 collision 不为 null，说明发生了碰撞

7. velocity = velocity.bounce(collision.get_normal()) * 0.8

   • 当发生碰撞时，计算反弹后的速度

   • collision.get_normal() 获取碰撞表面的法线方向

   • bounce() 根据法线计算反弹方向

   • x 0.8 是能量损失系数，使每次弹跳的高度逐渐降低

这个代码实现了一个简单的物理系统，让球体：

• 受重力影响下落

• 检测碰撞

• 在碰撞时反弹

• 每次反弹都损失一些能量（弹得没那么高）