godot-gdpm 0.0.3

A dependency package manager for Godot plugins, like uv/npm/cargo

GDPM — Godot Dependency Package Manager

A dependency package manager for Godot plugins, like uv/npm/cargo.

---

Features

• One command install — gdpm add limbo-ai instead of manual downloads
• Dependency management — Automatic dependency resolution
• Lock file — gdpm.lock ensures reproducible installs across team and CI
• Godot Asset Store — Direct integration with the official store API
• Version constraints — Support for ^, ~, >= semver syntax
• Template detection — Automatically identifies project templates vs addons
• Godot compatibility — Checks plugin compatibility with your Godot version

Installation

pip install godot-gdpm

Quick Start

# Initialize a project
gdpm init my-game --godot ">=4.2.0"

# Add plugins
gdpm add limbo-ai
gdpm add phantom-camera
gdpm add --dev gdunit4

# Check status
gdpm status

# Sync addons (e.g., after git clone)
gdpm sync

Commands

Project Management

Command	Description
gdpm init [name]	Initialize a new gdpm project
gdpm sync	Sync addons/ to lock file state
gdpm lock	Generate or update lock file
gdpm list	List installed plugins
gdpm status	Show plugin status and available updates

Dependencies

Command	Description
gdpm add <plugin>	Add plugins to the project
gdpm remove <plugin>	Remove plugins
gdpm update	Update plugins to newer versions
gdpm search <query>	Search Godot Asset Store
gdpm info <plugin>	Show plugin details

Configuration

gdproject.toml

[project]
name = "my-game"
version = "0.1.0"
godot = ">=4.2.0"
license = "MIT"

[dependencies]
limbo-ai = ">=1.5.0"
phantom-camera = "^4.3.0"

[dev-dependencies]
gdunit4 = "^1.0.0"

[scripts]
test = "godot --headless --script res://tests/run_tests.gd"

Version Constraints

Syntax	Meaning	Example
1.5.0	Exact version	limbo-ai = "1.5.0"
^1.5.0	Compatible update	>=1.5.0, <2.0.0
~1.5.0	Patch update	>=1.5.0, <1.6.0
>=1.0.0	Minimum version	>=1.0.0
*	Any version	limbo-ai = "*"

How It Works

gdpm uses the official Godot Asset Store API to discover and download plugins. It does not require a custom registry.

gdpm add limbo-ai
  → Search Godot Asset Store API
  → Download plugin zip
  → Extract to addons/
  → Write tag.gdpm for tracking
  → Update gdproject.toml + gdpm.lock

Plugin Tracking

gdpm uses tag.gdpm files to track which addon directories belong to which plugin. This handles bundled plugins that create multiple directories.

addons/
  cogito/
    tag.gdpm          → store+philip-drobar/cogito
    plugin.cfg
    ...
  input_helper/
    tag.gdpm          → store+philip-drobar/cogito
    ...

CI/CD Integration

# GitHub Actions
- name: Install Godot plugins
  run: |
    pip install godot-gdpm
    gdpm sync --frozen
    gdpm run test

Development

# Clone the repository
git clone https://github.com/Abyss-PlayerEG/godot-gdpm.git
cd godot-gdpm

# Install dependencies
uv sync

# Run tests
uv run mypy src/
uv run ruff check src/
uv run ruff format --check src/

# Install locally for testing
./scripts/install.sh --dev

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feat/new-feature)
3. Commit your changes (git commit -m "feat: add new feature")
4. Push to the branch (git push origin feat/new-feature)
5. Open a Pull Request

License

MIT License — see LICENSE for details.

Acknowledgments

• Godot Engine — The game engine
• Godot Asset Store — Official plugin store
• uv — Inspiration for the CLI design
• Rich — Terminal formatting
• Click — CLI framework