Skillshub defold-project-setup

Downloads Defold project dependencies into .deps/ folder. Also provides recommended game.project settings. Use FIRST before any other task when .deps/ folder is missing or empty, or after editing dependency URLs in game.project. Also use when creating a new project, configuring game.project, or asking about recommended project settings.

install

source · Clone the upstream repo

git clone https://github.com/ComeOnOliver/skillshub

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/ComeOnOliver/skillshub "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/indiesoftby/defold-agent-config/defold-project-setup" ~/.claude/skills/comeonoliver-skillshub-defold-project-setup && rm -rf "$T"

manifest: skills/indiesoftby/defold-agent-config/defold-project-setup/SKILL.md

source content

Setup Defold Project

Downloads and extracts Defold library dependencies and engine builtins into the

.deps/

directory, which is used as read-only context for resolving module references. Also provides recommended

game.project

settings for new projects.

When to Run

Before any task if the
```
.deps/
```
folder does not exist or is empty.
After editing dependencies in
```
game.project
```
(any
```
[project] dependencies#N
```
entry was added, removed, or changed).

How to Run

Execute the setup script from the project root:

Windows (PowerShell):

python .agents/skills/defold-project-setup/scripts/fetch_deps.py

Linux/macOS:

python3 .agents/skills/defold-project-setup/scripts/fetch_deps.py

Use

--dry-run

to print what would be done without downloading or extracting anything.

What It Does

Reads
```
game.project
```
and parses all
```
[project] dependencies#N
```
URLs.
Downloads each dependency zip to a temporary directory.
Inspects each zip's
```
game.project
```
for
```
[library] include_dirs
```
.
Extracts only the declared include directories into
```
.deps/
```
.
Downloads Defold engine builtins into
```
.deps/builtins/
```
(from the latest stable release).

After Running

The
```
.deps/
```
folder is ready for use as a read-only include directory.

Recommended game.project settings

When creating a new project or reviewing

game.project

, apply these recommended baseline settings. They provide sensible defaults for most Defold games.

[html5]

[html5]
scale_mode = Stretch
heap_size = 64
cssfile = /builtins/manifests/web/dark_theme.css
retry_count = 1000

```
scale_mode = Stretch
```
— the HTML5 canvas fills the entire browser window.
```
heap_size = 64
```
— 64 MB is enough for most games; the engine will allocate more if needed.

cssfile = /builtins/manifests/web/dark_theme.css

— dark theme is a better default than white.

```
retry_count = 1000
```
— the engine retries loading game files up to 1000 times on network issues, preventing failures on slow connections.

[engine]

[engine]
fixed_update_frequency = 60
max_time_step = 0.05

```
fixed_update_frequency = 60
```
— fixed update runs at 60 FPS (this is the Defold default).
```
max_time_step = 0.05
```
— the game runs without slowdowns down to 20 FPS. Below that, the game slows down instead of skipping large time chunks.

[physics]

[physics]
gravity_y = -1000.0
scale = 0.01
velocity_threshold = 100.0
use_fixed_timestep = 1
max_fixed_timesteps = 0

```
gravity_y = -1000.0
```
— this value is multiplied by
```
physics.scale
```
, so internally the physics engine sees -10 m/s² (Earth gravity).
```
scale = 0.01
```
— for 2D games this is typically
```
0.01
```
(1 pixel = 0.01 m). For 3D games use
```
1.0
```
(1 unit = 1 m).
```
velocity_threshold = 100.0
```
— (2D physics only) for stable physics this should be
```
1.0 / physics.scale
```
, so
```
100.0
```
when scale is
```
0.01
```
.
```
use_fixed_timestep = 1
```
— physics runs in fixed timestep mode. Move object interpolation between physics steps via the
```
object_interpolation
```
extension.
```
max_fixed_timesteps = 0
```
— (3D physics only) passes fixed dt directly from the Defold engine to Bullet3D and disables Bullet3D's internal accumulator.