godot-tres-format

SKILL.md 节选

# Godot .tres 资源文件格式规范

> **用途**：让 AI 能够直接读写 Godot 资源文件  
> **版本**：v1.0 · 2026-04-24  
> **适用引擎**：Godot 4.x

---

## 核心原则

**Godot 资源文件是纯文本**，AI 可以直接通过 `write_to_file` 创建材质、形状、环境等资源。

---

## 一、文件结构

```
[gd_resource type="ResourceType" format=3 uid="uid://xxx"]

[resource]
property1 = value1
property2 = value2
```

---

## 二、材质资源 (StandardMaterial3D)

### 2.1 基础材质

```
[gd_resource type="StandardMaterial3D" format=3]

[resource]
albedo_color = Color(0.8, 0.2, 0.2, 1)
roughness = 0.8
metallic = 0.0
```

### 2.2 金属材质

```
[gd_resource type="StandardMaterial3D" format=3]

[resource]
albedo_color = Color(0.9, 0.9, 0.9, 1)
roughness = 0.3
metallic = 0.9
metallic_specular = 0.5
```

### 2.3 发光材质

```
[gd_resource type="StandardMaterial3D" format=3]

[resource]
albedo_color = Color(1, 0.8, 0, 1)
emission_enabled = true
emission = Color(1, 0.8, 0, 1)
emission_energy_multiplier = 3.0
```

### 2.4 透明材质

```
[gd_resource type="StandardMaterial3D" format=3]

[resource]
transparency = 1
albedo_color = Color(0.2, 0.5, 1, 0.5)
```

### 2.5 无光照材质

```
[gd_resource type="StandardMaterial3D" format=3]

[resource]
shading_mode = 0
albedo_color = Color(1, 1, 1, 1)
```

### 2.6 带纹理材质

```
[gd_resource type="StandardMaterial3D" load_steps=2 format=3]

[ext_resource type="Texture2D" path="res://textures/brick.png" id="1_albedo"]

[resource]
albedo_texture = ExtResource("1_albedo")
roughness = 0.9
```

---

## 三、常用材质属性参考

| 属性 | 类型 | 说明 |
|------|------|------|
| `albedo_color` | Color | 基础颜色 |
| `albedo_texture` | Texture2D | 颜色贴图 |
| `roughness` | float (0-1) | 粗糙度，0=光滑，1=粗糙 |
| `metallic` | float (0-1) | 金属度 |
| `metallic_specular` | float (0-1) | 金属高光 |
| `emission_enabled` | bool | 启用发光 |
| `emission` | Color | 发光颜色 |
| `emission_energy_multiplier` | float | 发光强度倍数 |
| `transparency` | int | 0=不透明, 1=Alpha, 2=预乘Alpha |
| `cull_mode` | int | 0=背面剔除, 1=正面剔除, 2=不剔除 |
| `shading_mode` | int | 0=无光照, 1=逐顶点, 2=逐像素(默认) |
| `normal_enabled` | bool | 启用法线贴图 |
| `normal_texture` | Texture2D | 法线贴图 |
| `normal_scale` | float | 法线强度 |

---

## 四、环境资源 (Environment)

### 4.1 基础室外环境

```
[gd_resource type="Environment" format=3]

[resource]
background_mode = 1
background_color = Color(0.4, 0.6, 0.9, 1)
ambient_light_source = 2
ambient_light_color = Color(0.5, 0.5, 0.6, 1)
ambient_light_energy = 0.5
tonemap_mode = 2
tonemap_white = 6.0
ssao_enabled = true
ssil_enabled = true
glow_enabled = true
```

### 4.2 室内环境

```
[gd_resource type="Environment" format=3]

[resource]
background_mode = 1
background_color = Color(0.1, 0.1, 0.15, 1)
ambient_light_source = 1
ambient_light_color = Color(0.3, 0.3, 0.35, 1)
ambient_light_energy = 0.3
ssao_enabled = true
ssao_intensity = 2.0
```

### 4.3 带天空盒环境

```
[gd_resource type="Environment" load_steps=2 format=3]

[sub_resource type="Sky" id="Sky_001"]
sky_material = SubResource("ProceduralSkyMaterial_001")

[sub_resource type="ProceduralSkyMaterial" id="ProceduralSkyMaterial_001"]
sky_top_color = Color(0.3, 0.5, 0.9, 1)
sky_horizon_color = Color(0.7, 0.8, 0.95, 1)
ground_bottom_color = Color(0.2, 0.2, 0.2, 1)
ground_horizon_color = Color(0.5, 0.5, 0.5, 1)
sun_angle_max = 30.0

[resource]
background_mode = 2
sky = SubResource("Sky_001")
ambient_light_source = 3
tonemap_mode = 2
```

---

## 五、物理材质 (PhysicsMaterial)

```
[gd_resource type="PhysicsMaterial" format=3]

[resource]
friction = 0.8
rough = true
bounce = 0.2
absorbent = false
```

| 属性 | 说明 |
|------|------|
| `friction` | 摩擦力 (0-1) |
| `rough` | 粗糙模式 |
| `bounce` | 弹性 (0-1) |
| `absorbent` | 吸收模式 |

---

## 六、渐变资源 (Gradient)

### 6.1 线性渐变

```

SKILL.md 不止这些内容，安装后可阅读全文。

技能包内容

共 1 个文件，合计 10.3 KiB