@tool
class_name VibeGroup
extends Resource

## VibeGroup.gd
## 定义一个“音轨组”的数据结构。
## 这是一个核心资源，包含了完整的环境音效配置方案。
## 你可以创建如 "forest_day.tres", "dungeon_terror.tres" 等资源文件。
@export var group_name := ""

# 该音轨组的全局音量调整（dB）。会影响到其下所有的声音。
@export_range(-60, 6, 0.1, "dB") var group_db: float = 0.0


@export_group("Base Ambience", "base_")
# 基础环境音（白噪音），要求是无缝循环的音频文件。
@export var base_sound: AudioStream

# 基础环境音的独立音量调整（dB）。
@export_range(-60, 6, 0.1, "dB") var base_sound_db: float = 0.0


@export_group("Embellishments", "embellishment_")
# 点缀音效列表。可以从库中拖入预设好的 Embellishment.tres 资源。
# 你也可以直接在这里新建 Embellishment 资源，实现“特制wav”的需求。
@export var embellishments: Array[Embellishment]