Search, download, and automatically import PBR materials and HDRI environments directly from ambientCG.com into the Godot Engine.
Note
This project was forked from VenitStudios/AmbientCG.
| Asset Browser |
|---|
 |
| Plugin Settings |
|---|
 |
- Godot Engine 4.4+ (Standard or .NET)
- Active Internet Connection (for asset fetching)
- Download or clone this repository.
- Copy the
addons/ambientcgfolder into your project'saddons/directory. - Navigate to Project Settings > Plugins and enable AmbientCG.
- Launch: Click the AmbientCG button at the top-center of the Godot editor.
- Search: Filter assets by keywords (e.g., "stone", "sky").
- Download: Select a resolution and format. The plugin handles ZIP extraction and cleanup automatically.
- Integration: Find your new
.tresresources in the configuredres://ambientcg/directories.
Adjust paths and behaviors in Project Settings under the ambientcg/ section:
| Setting | Default Value | Description |
|---|---|---|
extract_path |
res://ambientcg/extracted |
Destination for raw asset files. |
material_file_directory |
res://ambientcg/materials |
Where .tres materials are generated. |
environment_file_directory |
res://ambientcg/environments |
Where HDRI environments are saved. |
download_path |
res://ambientcg/temp |
Temporary storage for ZIP archives. |
This project uses uv for development task management.
- Linting:
uv run task lint - Formatting:
uv run task format - Testing:
uv run task test(Requires Godot in PATH)
Warning
The automated test pipeline and local testing scripts are currently optimized for Linux/Unix environments only. Running tests on Windows is not supported at this time.
Contributions are welcome! See CONTRIBUTING.md to get started.
Important
When submitting PRs, ensure you test in both a 3D scene and an empty project to verify path creation logic.
Made with ◈ by AzPepoze