Brachistochrone/addons/cgheven/README.md

CGHEVEN Asset Library — Godot Editor Plugin

Browse, download and import CGHEVEN CG/VFX assets — 3D models, HDRIs, materials and flipbook VFX — directly inside the Godot editor. Assets stream from api.cgheven.com using the same account, library and freemium access you get in the CGHEVEN addons for Blender, After Effects, Premiere Pro and DaVinci Resolve.

A dark dock styled to match the CGHEVEN desktop addons, written entirely in GDScript (@tool EditorPlugin) — no native builds, so the same install runs on Windows, macOS and Linux.

Requirements

• Godot 4.x (built and tested on 4.6; uses 4.2+ APIs)
• Internet access (asset CDN + api.cgheven.com)

Install

From the Godot Asset Library (recommended):

1. In the Godot editor, open the AssetLib tab.
2. Search "CGHEVEN" → open the asset → Download → Install.
3. Project → Project Settings → Plugins → enable CGHEVEN Asset Library.
4. The CGHEVEN dock appears on the right. No editor restart needed.

Manual: copy the addons/cgheven/ folder into your project's addons/ folder, then enable it in Project Settings → Plugins.

Godot plugins are per-project (there is no global install), so the addon lives inside each project's addons/ folder.

Features

• Dark UI matched to the CGHEVEN desktop addons
• Asset grid with responsive columns, cached thumbnails, category + subcategory filters, search and sort
• Categories: 3D Models, HDRI, Flipbooks
• Guest browsing + one-click account login (web broker) or license-key activation
• Live plan refresh via heartbeat (Free → Pro without re-login)
• Server-side freemium gating (Download vs Upgrade)
• Asset cards: NEW / Premium / resolution badges, downloaded tick, favourite, per-card format/resolution picker, on-card progress bar
• One-click download → auto-import: glTF/FBX → scene, HDRI → world environment, flipbook → AnimatedSprite3D (auto-unpacks .zip)
• Favourites (persisted) + Downloads history
• Settings: account details, plan/version, check for updates, upgrade, Discord
• Built-in self-update with changelog

Configuration (optional)

Environment variables, for development / self-hosting:

• CGHEVEN_API_BASE — API base (default https://api.cgheven.com)
• CGHEVEN_WEB_BASE — website base (default https://cgheven.com)
• CGHEVEN_POSTHOG_KEY — analytics key (empty = analytics off)

The addon ships no secrets — analytics run server-side and all endpoints are public.

Notes & limits

Godot is a game engine, so a few DCC-only asset types are intentionally surfaced as unavailable: VDB volumetrics, .mp4 video previews (Godot plays only Ogg Theora .ogv), and Blender node-shader graphs (only baked PBR imports). Auto-update applies after an editor restart.

License

See LICENSE. © CGHEVEN.

Links

• Website: https://cgheven.com
• Discord: https://discord.gg/cgheven