游戏引擎 / 系统课时

让能量条与流动纹理保持同步

让能量条与流动纹理保持同步

能量条一边缩减、一边显示流动纹理时,常见问题是纹理越过剩余能量边界,或条形变化后流速与显示区域错位。本课在 Godot 4 中让游戏状态决定填充遮罩,让 TIME 驱动纹理 UV,并在同一个 Shader 内合成两者。

学习目标

  • 区分能量数值、填充遮罩与纹理滚动各自的职责。
  • 用 UV 平移和采样制作仅在已填充区域可见的流动材质。
  • 将 GDScript 中的能量值同步到实例级 Shader 参数。

把数值边界与纹理运动分开

能量条需要两种输入:fill_ratio 表示当前能量占最大能量的比例,范围为 0~1;TIME 与 UV 则负责让纹理持续向右滚动。遮罩由像素横坐标和 fill_ratio 比较得出:边界左侧显示流动颜色,右侧显示静态空槽颜色。

这样纹理可以持续滚动,能量消耗也可以随时改变,两者不会争夺同一套 UV 坐标。尤其不要用改变整个 ColorRect 宽度的方法顺带压缩纹理,否则纹理花纹会被挤变形。

在 Shader 中同时采样和遮罩

创建一个 Control 节点作为能量条,添加子节点 ColorRect 并命名为 FlowBar,将它调整为所需条形尺寸。给 FlowBar 添加 ShaderMaterial,创建以下 energy_flow.gdshader 并绑定。随后在材质参数 flow_texture 中指定一张可水平无缝重复的灰度纹理;也可以使用 Godot 内置的 NoiseTexture2D,配置合适的 Noise 并开启 Seamless。

glsl
shader_type canvas_item;

uniform sampler2D flow_texture : source_color, repeat_enable, filter_linear;
uniform vec4 filled_color : source_color = vec4(0.1, 0.8, 0.9, 1.0);
uniform vec4 empty_color : source_color = vec4(0.07, 0.11, 0.16, 1.0);
instance uniform float fill_ratio : hint_range(0.0, 1.0) = 0.75;
uniform float scroll_speed : hint_range(-3.0, 3.0) = 0.4;
uniform float repeat_count : hint_range(1.0, 10.0) = 4.0;

void fragment() {
    // 平移采样坐标,不改变能量条本身的几何尺寸
    vec2 moving_uv = vec2(UV.x * repeat_count - TIME * scroll_speed, UV.y);
    vec3 pattern = texture(flow_texture, moving_uv).rgb;
    vec3 flowing = filled_color.rgb * (0.65 + 0.35 * pattern);
    // 仅在能量边界左侧显示流动纹理
    float mask = step(UV.x, clamp(fill_ratio, 0.0, 1.0));
    COLOR = vec4(mix(empty_color.rgb, flowing, mask), 1.0);
}

预期结果:填充比例为 0.75 时,条形左侧约 75% 区域内的亮暗纹理向右移动,右侧 25% 始终显示暗色空槽;把比例改为 0 或 1 时分别近似全空或全满。repeat_count 决定横向纹理重复次数,scroll_speed 的正负决定移动方向。

用游戏状态更新填充比例

将脚本挂到能量条父节点 Control。示例中的 current_energy 是演示数据;在实际游戏中,应由角色能量组件持有唯一真实数值,变化时通知 HUD 调用 set_energy(),而不是让 Shader 自己计算能量损耗。

gdscript
extends Control

@export_range(1.0, 1000.0, 1.0) var max_energy: float = 100.0
@export_range(0.0, 1000.0, 1.0) var current_energy: float = 75.0
@onready var flow_bar: ColorRect = $FlowBar

func _ready() -> void:
    set_energy(current_energy)

func set_energy(value: float) -> void:
    # 先限制数值,再归一化,防止遮罩超出0~1
    current_energy = clampf(value, 0.0, max_energy)
    flow_bar.set_instance_shader_parameter(
        "fill_ratio", current_energy / max_energy
    )

func _input(event: InputEvent) -> void:
    # 仅作本课测试:左右方向键按25点修改能量
    if event.is_action_pressed("ui_left"):
        set_energy(current_energy - 25.0)
    elif event.is_action_pressed("ui_right"):
        set_energy(current_energy + 25.0)

预期结果:初始显示 75% 能量;按左方向键依次变为 50%、25%、0%,按右方向键可恢复。纹理始终只在当前填充区域内运动,空槽不流动;按键实际行为以项目输入映射为准。

能量值驱动遮罩与流动纹理合成的数据流

验证边界与共享材质

测试 0、50、100 和超出范围的输入,确认数值会被约束在合法区间。若纹理没有流动,先确认 flow_texture 已指定且内容存在明显亮暗变化,再检查 scroll_speed 是否为零;若花纹接缝明显,检查纹理是否可无缝重复。

本例使用 instance uniform fill_ratio,允许多个 FlowBar 共享材质而各自显示不同能量。需要注意,Godot 的 Shader 内置 TIME 不会因暂停场景树而自动停止;若游戏要求暂停时纹理也冻结,应改用由脚本按游戏时钟更新的时间参数,而不是直接依赖内置 TIME。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

让能量条与流动纹理保持同步

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通