用途:在 Defold 项目中准备依赖上下文。当 .deps/ 目录不存在或为空时,应在任何其他任务之前先运行;在 game.project 中增删改 [project] dependencies#N 条目后也需重新运行。
主要能力:读取 game.project 并解析所有 [project] dependencies#N 的 URL;将每个依赖 zip 下载到临时目录;检查各 zip 内 game.project 的 [library] include_dirs;仅把声明的 include 目录解压到 .deps/;并从最新稳定版下载 Defold 引擎 builtins 到 .deps/builtins/。运行后 .deps/ 即可作为只读 include 目录使用。
使用方式:在项目根目录执行脚本。Windows(PowerShell):python .agents/skills/defold-project-setup/scripts/fetch_deps.py;Linux/macOS:python3 .agents/skills/defold-project-setup/scripts/fetch_deps.py。加 --dry-run 可只打印将要执行的操作,不下载或解压。
推荐 game.project 设置:新建或审查项目时可套用以下基线。[html5] 中 scale_mode = Stretch(画布铺满浏览器窗口)、heap_size = 64(多数游戏够用,引擎会按需扩容)、cssfile = /builtins/manifests/web/dark_theme.css、retry_count = 1000(网络问题时最多重试 1000 次)。[engine] 中 fixed_update_frequency = 60、max_time_step = 0.05(低至 20 FPS 不减速,更低则减速而非跳过大段时间)。[physics] 中 gravity_y = -1000.0(乘以 physics.scale 后为 -10 m/s²)、scale = 0.01(2D 常用,3D 用 1.0)、velocity_threshold = 100.0(仅 2D,取 1.0 / physics.scale)、use_fixed_timestep = 1(物理固定步长,对象插值可用 object_interpolation 扩展)、max_fixed_timesteps = 0(仅 3D,直接把固定 dt 传给 Bullet3D 并禁用其内部累加器)。
限制:资料未提供脚本的依赖环境、失败处理、缓存策略及版本兼容性等细节,暂未提供。