godot-mcp: Skill for Claude Code

Godot 资源工作流程技能

本技能为Godot开发者提供完整的资源文件管理能力，支持.tres资源的创建、修改、批量处理、依赖解析和资源优化，构建高效的资源工作流。

触发条件

• 需要创建或修改资源文件（.tres, .res）
• 提及"资源管理"、"资源依赖"、"批量导入资源"
• 需要分析资源依赖关系或解决资源冲突
• 需要批量处理资源（如批量修改材质、纹理设置）
• 需要导入外部资源或优化现有资源

核心功能

1. 资源文件创建与管理

支持创建和编辑各种Godot资源类型：

• StandardMaterial3D / ShaderMaterial
• Texture2D / Texture3D / TextureArray
• Mesh 资源（ArrayMesh, PrimitiveMesh）
• Script 资源（GDScript）
• Scene 资源（PackedScene）
• Audio 资源（AudioStream）

2. 资源依赖关系管理

自动分析和处理资源间的依赖关系：

• 材质依赖纹理和Shader
• Script依赖其他脚本（继承）
• Scene依赖子场景和资源
• 依赖关系可视化
• 循环依赖检测和修复

3. 批量资源处理

支持批量操作多个资源：

• 批量修改资源属性
• 批量转换资源格式
• 批量重命名和整理
• 批量导入和导出

4. 资源优化与压缩

提供资源优化建议和实施：

• 纹理压缩（VRAM压缩、ETC2、S3TC）
• 网格优化（LOD、批量合并）
• 音频优化（压缩格式、比特率）
• 资源文件大小优化

执行步骤

创建资源文件

1. 规划资源类型

   • 确定需要的资源类型
   • 设计资源属性（PBR材质、纹理分辨率等）
   • 考虑性能影响（移动端vs桌面端）

2. 准备资源素材

   • 纹理图片（PNG, JPG, WebP）
   • 3D模型文件（GLTF, FBX, OBJ）
   • 音频文件（WAV, MP3, OGG）
   • Shader代码（.gdshader）

3. 执行资源创建

   • 使用 Godot 编辑器或 MCP 工具创建资源
   • 配置资源属性
   • 设置资源导入参数

4. 验证和测试

   • 在场景中测试资源
   • 检查视觉/音频效果
   • 验证性能

批量处理资源

1. 选择目标资源

   • 确定资源路径或通配符模式
   • 筛选符合条件的资源

2. 定义处理操作

   • 确定要执行的操作（修改属性、转换格式等）
   • 准备操作参数

3. 执行批量处理

   • 遍历所有目标资源
   • 应用操作
   • 记录处理结果

4. 验证结果

   • 检查处理后的资源
   • 验证项目仍然能正常运行

代码示例

示例 1: 创建标准材质资源

# 创建 StandardMaterial3D 资源
claude godot create_resource --project_path="/mnt/d/godot-projects/my-game" \
  --resource_type="StandardMaterial3D" \
  --resource_path="res://materials/ground.tres" \
  --properties='{
    "albedo_color": "Color(0.2, 0.5, 0.2, 1)",
    "metallic": 0.0,
    "roughness": 0.8
  }'

示例 2: 批量修改材质纹理

# 将所有材质的纹理过滤模式改为 Nearest
claude godot batch_update_resources --resource_pattern="res://materials/*.tres" \
  --property="texture_filter" \
  --value="BaseMaterial3D.TEXTURE_FILTER_NEAREST"

示例 3: 分析资源依赖关系

# 分析场景的资源依赖
claude godot analyze_dependencies --resource_path="res://scenes/main_level.tscn"

# 输出：列出所有依赖的纹理、材质、脚本等资源

示例 4: 批量导入纹理并设置参数