godot-gdscript-patterns

Godot GDScript 模式

面向 Godot 4.x 游戏开发的生产级模式，涵盖架构、信号、场景和优化。

适用场景

• 使用 Godot 4 开发游戏
• 使用 GDScript 实现游戏系统
• 设计场景架构
• 管理游戏状态
• 优化 GDScript 性能
• 学习 Godot 最佳实践

不适用场景

• 任务与 Godot GDScript 模式无关
• 需要使用此范围之外的其他领域知识或工具

说明

• 明确目标、约束和所需输入。
• 应用相关最佳实践并验证结果。
• 提供可执行的步骤和验证方法。
• 如需详细示例，请打开 resources/implementation-playbook.md。

资源

• resources/implementation-playbook.md：详细模式和示例。

限制

• 仅在任务明确符合上述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少所需输入、权限、安全边界或成功标准，请暂停并请求澄清。

Playbook 示例是独立文件中的代码片段；使用前请提供 Input Map 操作、场景节点、Player/State 子类、die() 和其他项目专用辅助函数。对象池要求场景根节点兼容 CanvasItem，并明确重置物理状态和碰撞状态：禁用处理或隐藏对象并不能阻止所有信号回调，因此非活动对象必须拒绝命中。验证初始状态，并防止异步场景加载或切换收到重复请求。存档文件需要进行架构、版本和范围验证，并采用原子替换；分发的游戏中硬编码的加密密钥可被提取，既不能保护机密，也不能建立反作弊信任。检查保存、打开和删除操作是否失败。固定 Godot 版本，并使用性能分析器验证收益后再做出相关声明。请参阅 Godot 暂停与处理模式。