用途:为 Godot 4 项目提供专业化的项目组织规范,涵盖按功能划分的目录结构、统一命名约定和版本控制规范,适用于新项目搭建与既有项目结构治理。
主要能力:提供四个脚本。project_bootstrapper.gd 用于自动生成功能文件夹和 .gitignore,新项目搭建前应先阅读;scene_naming_validator.gd 扫描全项目检查 snake_case/PascalCase 命名违规,建议提交 PR 前运行;dependency_auditor.gd 检测场景间的循环依赖与耦合问题,适合场景数超过 50 的大型项目,除非排查加载错误或审计大项目,否则不要加载;feature_scaffolder.gd 生成包含基础场景、脚本和子目录的完整功能文件夹。
使用方式:搭建新项目时先确保 project.godot 存在,创建 entities/、ui/、levels/、common/ 等核心文件夹,建立 .gitignore,并编写 README.md 说明结构。项目目录按功能而非文件类型划分,例如 /entities/player 下放置 player.tscn、player.gd 等。
命名与限制:文件与文件夹统一用 snake_case,C# 脚本例外用 PascalCase;节点名用 PascalCase;频繁访问的节点用 %SceneUniqueNames 代替硬编码 get_node() 路径。必须包含 Godot 专用 .gitignore,避免提交 .godot/ 目录造成体积膨胀和合并冲突;对原始设计文件(如 .psd、.blend)使用 .gdignore 排除导入。资料未提供具体收费、价格、平台支持信息。