╔══════════════════════════════════════════════════════════════╗
║     CGHEVEN Asset Library — Blender Addon  v1.0.0            ║
║     Windows Edition                                           ║
╚══════════════════════════════════════════════════════════════╝

WHAT THIS ADDON DOES
─────────────────────────────────────────────────────────────
  Browse VFX / 3D assets from cgheven.com inside Blender, preview
  them, and download + import (FBX, GLB, textures, VDB, video
  strips, flipbooks, etc.) directly into your scene.

─────────────────────────────────────────────────────────────
1. INSTALLATION  (Windows)
─────────────────────────────────────────────────────────────

■ DRAG & DROP (recommended — Blender 4.2 or newer)
  1. Keep the addon as the CGHEVEN .zip file (do NOT extract it).
  2. Open Blender.
  3. Drag the CGHEVEN .zip onto the Blender window.
  4. In the dialog that appears, confirm to install + enable.
  5. In the 3D Viewport press N → sidebar → tab "CGHEVEN".

■ ALTERNATIVE (from Preferences)
  1. Edit → Preferences → Add-ons.
  2. Click the ▾ arrow (top-right) → "Install from Disk…".
  3. Select the CGHEVEN .zip file.
  4. Make sure the "CGHEVEN" add-on checkbox is enabled.

─────────────────────────────────────────────────────────────
2. LICENSE — FIRST TIME (REQUIRED)
─────────────────────────────────────────────────────────────
  • Open the CGHEVEN panel (N sidebar) → BROWSE area.
  • Enter your license key → click ACTIVATE.
    (Use RESTORE if you already activated on this machine.)

  After activation the full catalog loads automatically.
  Internet is required for activation and periodic session refresh.

  • LICENSE tab: view plan / expiry and LOGOUT when needed.

─────────────────────────────────────────────────────────────
3. BROWSE TAB — FIND ASSETS
─────────────────────────────────────────────────────────────
  • Choose category, sort order, optional search, "Free only".
  • Click "Apply Filter" to load the grid.
  • Use pagination at the bottom for more pages.
  • Click "Details & Import" on any card to open the detail screen.
  • BACK returns to the grid.

─────────────────────────────────────────────────────────────
4. ASSET DETAIL — PREVIEW & DOWNLOAD
─────────────────────────────────────────────────────────────
  PREVIEW
  • Video / GIF previews need FFmpeg (see Tips below).
  • Static image preview shown if no video is available.

  DOWNLOAD
  • Pick FORMAT (FBX, MP4, EXR, etc.) and RESOLUTION.
  • Click "Download" — progress shows in the DOWNLOADS tab.
  • Meshes, images, VDBs and flipbooks auto-import when done.

─────────────────────────────────────────────────────────────
5. DOWNLOADS TAB
─────────────────────────────────────────────────────────────
  • Lists active and finished downloads.
  • Pause / cancel supported where applicable.
  • Open downloads folder via the folder button.

─────────────────────────────────────────────────────────────
6. AUTO-UPDATE
─────────────────────────────────────────────────────────────
  • When a new version is available a banner appears in the panel.
  • Click "Install Update" — Blender restart required after.

─────────────────────────────────────────────────────────────
7. TIPS & TROUBLESHOOTING
─────────────────────────────────────────────────────────────
  • Restart Blender after installing or updating the addon.
  • Empty catalog or errors: check internet, re-activate license.
  • Install didn't work: make sure you dropped the .zip (not an
    extracted folder), and that you are on Blender 4.2 or newer.
  • FFmpeg (for animated previews):
      The addon can auto-download FFmpeg on first use — click
      "Enable Preview" when prompted. Or install manually:
        https://ffmpeg.org/download.html
  • RAR assets: install 7-Zip (free) from https://7-zip.org
      or WinRAR — the addon auto-downloads UnRAR once if needed.

─────────────────────────────────────────────────────────────
macOS USERS
─────────────────────────────────────────────────────────────
  This package is for Windows only.
  A separate macOS edition of this addon is available with full
  native Mac support and Homebrew FFmpeg detection.

  Please use the macOS repository instead:
    CGHEVEN Asset Library — Blender Addon (macOS Edition)

─────────────────────────────────────────────────────────────
WEB
  https://cgheven.com

╚══════════════════════════════════════════════════════════════╝
