Godot4.3类星露谷游戏开发之【昼夜循环】

news2025/5/10 22:31:40

千里之行，始于足下

文章目录

零、笔记
一、创造时间
二、产生颜色
三、搭建测试环境
四、测试
五、免费开源资产包

零、笔记

为了让游戏可以拥有白天和黑夜，我们需要像上帝一样，在游戏中创造时间的规则，并在不同的时间点产生不同的颜色。

一、创造时间

第一步，在 res://脚本/全局脚本/ 路径下，新建脚本 时间管理器.gd ；

时间管理器.gd
第二步，在项目设置 > 全局 下，添加该脚本为单例，并命名为 TimeManager ；

TimeManager
第三步，更新 时间管理器.gd 脚本代码；

extends Node
## 时间管理 

signal 游戏总时间更新(秒: float)
signal 游戏格式化时间更新(天:int, 时: int, 分: int, 秒: int)

const 每日秒数: int = 24 * 60 * 60
const 每时秒数: int = 60 * 60
const 每分秒数: int = 60
const 时间单元: Array[Array] = [
	[每日秒数, "天"],
	[每时秒数, "小时"],
	[每分秒数, "分钟"],
	[1, "秒"],
]

# 初始游戏时间，第1天6:00:00
var 初始游戏天数: int = 1
var 初始游戏小时数: int = 6
var 初始游戏分钟数: int = 0
var 初始游戏秒数: int = 0

# 累计游戏时间
var 累计游戏时间: float = 0.0

# 其他设置
var 时间流速: float = 1000.0
var 时间暂停: bool = false


# 初始化累计游戏时间
func _ready() -> void:
	累计游戏时间 = 计算初始总秒数()


# 产生时间
func _process(delta: float) -> void:
	if 时间暂停:
		return
	
	累计游戏时间 += delta * 时间流速
	#print_debug("累计游戏时间:", 累计游戏时间)
	
	# 发送时间信号
	游戏总时间更新.emit(累计游戏时间)

	# 转换格式并发送时间信号
	var 格式化时间: Array[int] = 转换时间格式(int(累计游戏时间))
	游戏格式化时间更新.emit(格式化时间)


# 计算初始时间总秒数
func 计算初始总秒数() ->float:
	return (
		初始游戏天数 * 每日秒数 +
		初始游戏小时数 * 每时秒数 +
		初始游戏分钟数 * 每分秒数 +
		初始游戏秒数
	)


# 格式转换：总秒数 -> 日/时/分/秒
func 转换时间格式(总秒数: int) ->Array[int]:
	# 异常处理
	if 总秒数 < 0:
		push_error("无效的时间参数")
		return [0, 0, 0, 0]
	
	# 格式转换
	var 剩余秒数 = int(总秒数)
	var 结果:Array[int] = []
	for 单元 in 时间单元:
		var 值 = 剩余秒数 / 单元[0]
		剩余秒数 %= 单元[0]
		结果.append(值)
	print_debug(结果)	
	
	return 结果

二、产生颜色

第一步，以 昼夜循环组件（CanvasModulate） 为根节点，在 res://场景/组件/ 路径下，创建新场景；

第二步，选中 昼夜循环组件 节点，附加脚本；

class_name 昼夜循环组件
extends CanvasModulate

@export var 昼夜渐变纹理: GradientTexture1D


func _ready() -> void:
	TimeManager.游戏总时间更新.connect(昼夜更替)
	
	
func 昼夜更替(秒: float) ->void:
	var 每日秒数: int = 24 * 60 * 60
	
	# 从正弦函数中获取在 0和1 之间来回变动的采样值：y = 1/2(sin2πx + 1),y ∈ [0,1]
	var 采样值: float = sin(秒 / 每日秒数 * 2 * PI - (0.5 * PI) ) * 0.5 + 0.5
	
	# 根据采样值产生纹理变化，形成昼夜更替的效果
	color = 昼夜渐变纹理.gradient.sample(采样值)  # 昼夜渐变纹理
	#print("采样值：", 采样值)