godot-compatibility-checker
自动检测和修复Godot 3.x与4.x之间的API兼容性问题，基于实际项目经验提供针对性解决方案
When & Why to Use This Skill
The Godot Compatibility Checker is a specialized Claude skill designed to streamline the transition between Godot 3.x and 4.x. It automates the detection and repair of API breaking changes, offering targeted solutions for GDScript migrations. By leveraging real-world project experience, it identifies deprecated methods and provides instant refactoring for critical systems like Tweens and Particles, significantly reducing the manual effort required for game engine upgrades.
Use Cases
- Project Migration: Automatically scan entire Godot 3.x codebases to identify and fix compatibility issues when upgrading to Godot 4.x.
- API Refactoring: Resolve specific breaking changes in GDScript, such as converting legacy Tween interpolation methods to the modern 'tween_property' syntax.
- Visual System Updates: Detect and correct property changes in particle systems and materials to ensure visual consistency across engine versions.
- Cross-Version Debugging: Quickly troubleshoot and fix 'method not found' or 'invalid call' errors that arise from version-specific API differences.
| name | Godot Compatibility Checker |
|---|---|
| description | 自动检测和修复Godot 3.x与4.x之间的API兼容性问题，基于实际项目经验提供针对性解决方案 |
| version | 1.0.0 |
Godot版本兼容性检查技能
指令
当用户遇到Godot版本相关问题或需要进行版本升级时，自动进行兼容性检查和修复。
触发条件
- 提及Godot版本升级或迁移
- 遇到API兼容性错误
- 需要在不同Godot版本间运行代码
核心修复案例
粒子系统修复
# ❌ 错误: material.emission_amount = 50
# ✅ 正确: particles.amount = 50
Tween系统修复
# ❌ 错误: tween.interpolate_property()
# ✅ 正确: tween.tween_property()
执行步骤
- 检测Godot版本
- 扫描代码问题
- 提供修复方案
- 验证修复效果