Note
godot
godot笔记
节点
godot最核心的设定,它是最基本的构建块,每个节点有特定的作用。节点之间可以嵌套、堆叠,最终组合成一个具备强大功能的节点集合。脚本用于为节点添加自定义行为,非必须。
父子节点
把一个节点嵌套在一个节点下面,就构成了父子节点。调整父节点属性会影响子节点,子节点无法影响父节点。常见的传递情况如下:
-
变换关系:位置、旋转、缩放通常具有父子传递关系。
-
可见性:具有对应继承规则的可视节点通常会受到父节点可见性影响。
-
自定义变量:不会因为父子关系就自动继承。
-
信号:不会因为父子关系自动连接。
-
脚本行为:不会自动继承父节点脚本中的业务逻辑。
场景
以一个根节点为起点组织起来、可保存并重复实例化的节点树称之为 场景,就是只有一个根节点的节点集合,概念上类似vue的组件,保存为的后缀名为 tscn 文件。比如新建两个节点:角色,关卡。角色下面新建多个节点:头部,身体、腿部,手部,这些节点组成了角色节点,关卡下面新建多个节点:跳台、火焰、路标、怪物,这些节点组成了关卡节点。那么角色和关卡这两个节点集合就是所谓的场景。场景通常保存到 scenes 文件夹。
场景实例
Enemy.tscn
└── Enemy (CharacterBody3D)
├── Visual (Node3D)
├── CollisionShape3D
└── AttackArea (Area3D)
接着,在关卡中放置三个这个场景的实例:
Level01.tscn
└── Level01 (Node3D)
├── Ground
├── Player
├── Enemy01 → Enemy.tscn
├── Enemy02 → Enemy.tscn
└── Enemy03 → Enemy.tscn
这三个敌人不是三个独立编写的敌人系统,而是同一个场景模板创建的三个实例。所以它们:
- 共享同一种结构和行为逻辑。
- 可以分别拥有自己的位置、生命值和运行状态。
- 可以配置不同的属性。
- 当原始场景结构发生修改时,引用它的实例通常也会随之更新,但实例覆盖的属性可能保留。
类似开发中的类实例化对象,也可以理解为组件复用。
节点类型
2D节点
-
Node2D: 2D 空间节点的基础类型,提供位置、旋转、缩放等能力
-
Sprite2D: 显示 2D 纹理,如图片、角色贴图
-
Camera2D: 摄像机,用于展示画面。控制 2D 场景的观察范围和视角,挂载到指定节点可以使视角跟随该节点。如作为角色子节点时可以使画面跟随角色。
-
物理引擎,需要设置好CollisionShape2D才会生效:
-
StaticBody2D: 静态物理体,不会被物理引擎推动,适合墙壁、地面等不交互的环境物体。
-
CharacterBody2D: 由代码控制移动的物理体,适合玩家、敌人等。
-
RigidBody2D: 依赖物理引擎驱动运动,适合需要真实惯性、弹跳等效果的物体,如箭矢、炮弹。与CharacterBody2D的区别在于,RigidBody2D只在初始代码设置运动方向,后续全部交由物理引擎运算。而CharacterBody2D需要从代码持续接收更新指令。
-
Area2D: 区域物理对象,检测物体是否进入指定区域,不是用来阻挡物体的实体碰撞体。
-
-
AnimatedSprite2D: 实现动画,使用 SpriteFrames 播放多帧 2D 动画,本质是能够实现动画的sprite2D。
-
CanvasModulate: 为整个 2D 画布施加颜色调制效果
-
CanvasLayer: 画布层。创建独立的 2D 绘制层,常用于固定在屏幕上的 HUD
-
TileMapLayer: 通过 TileSet 瓦片资源构建 2D 地图
通用节点
- Timer: 计时器。到达设定时间时可以发出 timeout 信号
注意
- 角色最好不要通过position移动,正确做法是设置velocity速度,再由Godot自动计算坐标位置。
Control
是 Godot UI 系统的基础节点类型,包含界面布局、尺寸、锚点以及用户输入等相关功能。主要是用于制作UI界面。
-
Label:用于展示文本
-
Pnael:用于自定义样式的基础面板组件。
-
ColorRect:绘制纯色矩形,常用于遮罩、纯色背景
-
TextureRect:在指定矩形区域显示纹理,并支持缩放和拉伸设置
-
-
HFlowContainer:自动从左往右排列子节点,宽度不足时换行
音频节点
-
AudioStreamPlayer:音频流播放器,音量不受距离影响。常用于作背景音乐、UI 音效
-
AudioStreamPlaer2D/3D:音量会受距离的影响,离声源越远,音量越小。常用于做音效
音频总线
- Audio Bus
Node3D
3D节点,很多节点定位与作用跟2D节点类似,只不过是作用于3D空间。3D场景必须要有照明和摄像机才能展示。
-
Node3D 3D空间节点的基础类型。对应
Node2D。 -
MeshInstance3D: 显示 3D 网格模型,对应
Sprite2D。 -
Camera3D: 对应
Camera2D。 -
物理引擎,需要设置好CollisionShape3D才会生效:
- StaticBody3D: 对应
StaticBody2D。 - CharacterBody3D: 对应
CharacterBody2D。 - RigidBody3D: 对应
RigidBody2D。 - Area3D: 对应
Area2D。
- StaticBody3D: 对应
-
AnimationPlayer: 保存和播放动画。类似
AnimatedSprite2D。与AnimatedSprite2D的区别:AnimatedSprite2D主要通过连续切换图片帧实现动画。AnimationPlayer通过关键帧控制属性变化实现动画。 -
AnimationTree: 控制动画切换、混合和状态机。从
AnimationPlayer提供的动画中选择、混合和切换动画,例如从跑步过渡到待机,或者在移动时播放攻击动画 -
Skeleton3D: 设置骨骼如何控制角色模型。用于管理一个 3D 骨架,包括各根骨骼之间的父子关系及其变换信息。绑定了骨架的模型可以根据骨骼运动产生形变。例如当角色挥剑时,动画会改变肩膀、手臂等骨骼的旋转。
-
Light3D: 光源
- DirectionalLight3D: 平行光,模拟来自同一个方向的光照,例如太阳光。光线方向基本一致,不因物体与光源的距离变化而产生常规距离衰减
- OmniLight3D 点光源,从光源位置向周围发光,照亮一定范围内的物体,例如火把、灯泡
- SpotLight3D 聚光灯,沿指定方向发射锥形光束,例如手电筒、舞台聚光灯
-
RayCast3D: 射线检测,沿一条线检测物体,例如检测前方有没有障碍物,攻击射线是否命中敌人。
-
Marker3D: 保存一个参考位置,专门用于标记 3D 空间位置的节点,如武器发射位置、敌人出生点、特效生成位置。
-
GPUParticles3D: 批量生成和控制粒子,如火花、烟雾效果。如玩家挥剑时产生的火花,敌人被击中时产生的烟雾,技能释放时产生的魔法粒子,场景中的落叶、灰尘等。可以为粒子配置:
- 生成数量。
- 初始速度与方向。
- 生命周期。
- 颜色与透明度变化。
- 重力。
- 发射形状。
-
VisibleOnScreenNotifier3D: 屏幕可见检测节点,检测物体是否进入或离开屏幕可见范围,并发出信号。
-
BoneAttachment3D: 让物体跟随指定骨骼。如武器绑定在角色手部 角色手持武器。例如头顶跟随的装饰物,绑定在腰部的装备,骨骼上的粒子特效发射点。
-
GridMap: 用预制 3D 网格块拼装场景,是一种 3D 地图搭建工具,并非所有 3D 游戏都需要。也可以组合 Blender 模型制作地图。对应
TileMapLayer。
MeshInstance3D模型属性
godot引入的最常见的3D模型文件为 .glb。godot中,可以直接生成符合模型的碰撞体外形。
-
Mesh:定义模型的几何数据,设定模型的网格类型,如顶点、三角面等
-
Material:定义物体表面的渲染方式
-
Albedo:基础颜色,可以使用颜色值或贴图。
-
Metallic:金属度,以此控制物体对光线的反射效果。需要搭配光源使用。
-
roughness:粗糙度,影响高光清晰程度
-
-
geometry:模型几何设置
-
Material Override:替换原有材质
-
Material Overlay:在原有材质上叠加材质
-
Shaders
着色器,可修改物体表面的材质。用来控制物体如何被渲染。它可以处理顶点变换、表面颜色、光照效果以及屏幕画面效果等。
Shader 和 Material 的关系可以简单理解成:
- Shader:定义如何渲染。
- Material:配置渲染时使用的参数和资源。
例如: 让敌人被攻击时闪红光,可以通过材质参数或 Shader 实现。 让角色进入潜行状态时半透明,也可以通过材质实现。
CollisionShape2D/3D
为物理体或检测区域指定实际碰撞范围。可以使用矩形、圆形、胶囊、盒体等形状。没有正确配置碰撞形状,Layer/Mask 本身不能产生有效碰撞。
脚本
用于书写操纵节点,设置规则与资源交互的逻辑,简单来说就是用于书写游戏逻辑。文件后缀名为 .gd 。每个节点都可以增加脚本。
Resource
Godot 的资源数据对象,可存储贴图、材质、音频、动画或自定义数据。可以独立保存为 .tres 等文件,也可以嵌入场景。
信号
一种事件通知机制。节点或脚本可以在特定事件发生时发出信号,其他对象连接这个信号后,就能执行对应的处理函数。可以理解为js中的事件。每个节点都有信号,信号由节点自身功能决定。比如 Timer 计时器有 timeout() 信号,表示计时结束后触发该函数。可以使用内置信号,也可以自定义信号。
帧率与时间增量
帧率:F/S。每秒的帧数,会受设备配置、性能的影响而不同。
delta time:S/F,时间增量△t即生成每帧的耗时(S)。本帧位移 = 速度 * △t,假设角色每秒移动 6 米: 帧率 单帧 delta 单帧位移 一秒位移 30 FPS 约 0.0333 秒 0.2 米 6 米 60 FPS 约 0.0167 秒 0.1 米 6 米 120 FPS 约 0.0083 秒 0.05 米 6 米
delta 的作用,是将以「每秒」为单位的变化量转换成当前时间步对应的变化量。
碰撞分层
Collisions 碰撞分层。所有物理实体都拥有层级(layer)与掩码(mask)。layer:自身的碰撞层级,mask:允许与自身产生碰撞的物体的碰撞层级(即允许与自生发生碰撞关系的其他物体的layer值)。比如有三个物理实体A、B、C:
| 物理实体 | layer | mask |
|---|---|---|
| A | 1 | 2,3 |
| B | 3 | 1 |
| C | 2 |
A:自身层级为1,允许与层级为2,3的实体发生碰撞。即A可以与B、C物体发生碰撞
B:自身层级为3,允许与层级为1的实体发生碰撞。即B只可以与A发生碰撞
C:自身层级为2,只会与A发生碰撞(因为A的mask中包含了层级2)。
Ysort
在 2D Y 排序启用且满足相应排序条件时,Y 坐标较大的物体会绘制在 Y 坐标较小的物体前面。 例如:
- 角色站在树后面:角色可能被树遮挡。
- 角色走到树前面:角色应该显示在树的前方。
项目设置
-
input map:用于接收用户的输入并与事件绑定,包含键盘、鼠标、手柄的等设备输入。如把A键与left事件绑定,结合脚本运用到节点上,可以实现按下A键节点向左偏移。
-
物理实体层级命名
使用
- 3D模型使用最好是 “.glb”,blender可以把模型导出为 “.glb”。