[Addon] Blender Asset Packer

[Addon] Blender Asset Packer

Tên Add‑on: Blender Asset Packer

Phiên bản: 1.9.0 • Blender 2.80+ & 4.2+ (Extensions)

Vị trí: View 3D → Sidebar (phím N) → tab "Asset Packer"

🚀 Cập nhật v1.9.0: Bổ sung hỗ trợ đầy đủ Linked Libraries (.blend) & Library Overrides, đóng gói Font chữ 3D (.ttf, .otf) & Âm thanh (Audio/Sounds), bộ lọc phạm vi Scene Scope (All / Active / Selected Scene), nhận diện texture UDIM Tiles, gom trọn bộ các thư mục Simulation Cache (Fluid, Cloth, Particles, Geo Nodes, Alembic, VDB) và chuẩn hóa định dạng Blender 4.2+ Extensions!

Tổng quan

Blender Asset Packer là add‑on giúp đóng gói toàn bộ tài nguyên (assets) bên ngoài của dự án Blender vào một thư mục độc lập, dễ dàng chia sẻ, gửi render farm hoặc lưu trữ dự án dài hạn. Khác với tính năng Pack Resources có sẵn trong Blender (nhúng file vào .blend), add‑on này tạo một cấu trúc thư mục bên ngoài với đường dẫn tương đối an toàn, giúp bạn kiểm soát và quản lý assets tối ưu hơn.

So sánh nhanh: Asset Packer vs. Pack Resources
Pack Resources (Blender built-in)
  • ✅ Nhúng file vào .blend
  • ✅ Đơn giản, 1 file duy nhất
  • ❌ File .blend rất nặng (GBs)
  • ❌ Khó chỉnh sửa assets bên ngoài
  • ❌ Không đóng gói add-ons
  • ❌ Không hỗ trợ Linked Libraries & Overrides
  • ❌ Không hỗ trợ thư mục Cache/Simulations ngoài
Asset Packer (Add-on)
  • ✅ File .blend nhẹ, độc lập
  • ✅ Assets tách biệt, dễ quản lý
  • ✅ Đường dẫn tương đối chuẩn xác 100%
  • ✅ Hỗ trợ Linked Libraries & Library Overrides
  • ✅ Hỗ trợ trọn vẹn Caches (VDB, Fluid, Geo Nodes)
  • ✅ Hỗ trợ Fonts 3D, Âm thanh & UDIM tiles
  • ✅ Đóng gói cả add-ons kèm installer

Tại sao nên dùng Asset Packer?

🚀 Tính năng nổi bật trong bản v1.9.0

Một nhấp là xong

Tự động quét và đóng gói: ảnh đơn, chuỗi ảnh, UDIM, video, HDRI, textures, font 3D, âm thanh, VSE strips, nút Compositor, video nền camera — tất cả trong một lần.

Hỗ trợ Linked Libraries

Tự động quét và sao chép các file .blend liên kết ngoài (bpy.data.libraries), cập nhật lại datablock giúp Library Overrides hoạt động liền mạch trên máy mới.

Gom bộ đệm Mô phỏng & Cache

Định vị và sao chép toàn bộ thư mục point cache cho Fluid Domains, Cloth/Physics, Alembic (.abc), OpenVDB (.vdb) và bakes Geometry Nodes.

Lọc theo Scene Scope

Linh hoạt chọn đóng gói toàn bộ file (All Scenes), chỉ scene đang mở (Active Scene) hoặc một scene bất kỳ được chỉ định (Selected Scene).

Relink cực chắc

Tự động chuyển sang đường dẫn tương đối (//...), có cơ chế fallback thông minh xử lý trường hợp trùng tên file ở các thư mục khác nhau.

Đóng gói Add-ons

Tùy chọn đóng gói các add‑on đang bật vào thư mục _addons/ kèm manifest và bảng installer khôi phục dễ dàng.

📊 So sánh chi tiết với Pack Resources

Tính năng Pack Resources
(Blender built-in)
Asset Packer
(v1.9.0)
Cách lưu trữ Nhúng vào file .blend Thư mục riêng, cấu trúc rõ ràng
Kích thước file .blend ❌ Rất nặng (GBs) ✅ Nhẹ (chỉ references)
Linked Libraries (.blend) ❌ Không hỗ trợ ✅ Copy & relink datablocks
Caches (VDB, Fluid, Geo Nodes) ❌ Không hỗ trợ ✅ Sao chép trọn vẹn folder cache
Fonts 3D & Âm thanh ⚠️ Hạn chế ✅ Nhận diện & đóng gói tự động
Chuỗi ảnh & UDIM tiles ⚠️ Nhúng từng frame ✅ Nhận diện pattern & pack tự động
Đóng gói Add-ons ❌ Không hỗ trợ ✅ Đóng gói kèm installer panel
Relink tự động ⚠️ Thủ công sau unpack ✅ Tự động với fallback thông minh

Những gì được đóng gói trong v1.9.0

  • Thư viện liên kết ngoài (Linked Libraries): Các file .blend được link (bpy.data.libraries), library overrides và linked collections/objects.
  • Hình ảnh đơn lẻ: Textures vật liệu, World HDRI, Camera background images, Compositor images.
  • Chuỗi ảnh & UDIM Tiles: Image sequences (phát hiện pattern đánh số), UDIM multi-tiles (1001, 1002…).
  • Video & Movie Clips: Movie clips, Camera background videos, VSE video strips, Compositor clips, Movie texture nodes.
  • Mô phỏng & Caches: Thư mục Fluid domains, Cloth & Softbody point caches, Alembic (.abc), OpenVDB volumes (.vdb), Geometry Nodes bakes.
  • Font chữ 3D & Âm thanh: File font 3D Text (.ttf, .otf) và file âm thanh (sound clips / VSE audio).
  • Đèn IES: Các file cấu hình quang phổ đèn IES photometric.
  • Tùy chọn Add-ons: Sao lưu toàn bộ add-on người dùng đang bật vào _addons/ kèm manifest cài đặt lại.

Cài đặt Add-on

Dành cho Blender 4.2+ (Định dạng Extensions)

  1. Tải file asset_packer.zip từ Releases GitHub.
  2. Mở Blender → Vào menu Edit > Preferences > Get Extensions.
  3. Bấm vào icon mũi tên trỏ xuống góc phải trên (hoặc chọn Install from Disk…).
  4. Chọn file asset_packer.zip và kích hoạt add-on.

Dành cho Blender 2.80+ tới 4.1 (Add-on truyền thống)

  1. Tải file asset_packer.zip.
  2. Mở Blender → Vào Edit > Preferences > Add-ons.
  3. Bấm nút Install…, chọn file asset_packer.zip.
  4. Đánh dấu tick vào ô Import-Export: Asset Packer để bật.
  • Vị trí thanh công cụ: Mở vùng làm việc 3D (3D Viewport) → Bấm phím N để mở thanh Sidebar → Chọn thẻ Asset Packer.

Bắt đầu nhanh

  1. Mở file Blender của bạn.
  2. Mở N‑panel → chọn thẻ Asset Packer.
  3. Bấm 📁 Select Output Directory để chọn thư mục lưu trữ gói xuất ra.
  4. Tùy chỉnh các cài đặt theo nhu cầu:
    • Include .blend File: Sao chép file .blend hiện tại vào thư mục Output.
    • Auto Save Before Pack: Tự động lưu file hiện tại trước khi pack.
    • Relink Assets: Mở file .blend đã sao chép và cập nhật toàn bộ đường dẫn thành tương đối (//...).
    • Include Linked Libraries: Sao chép và relink các file .blend liên kết ngoài.
    • Include Fonts & Sounds: Sao chép font 3D và file âm thanh.
    • Include Enabled Add‑ons: Gom các add-on đang bật vào _addons/.
    • Scene Scope: Chọn phạm vi quét (All Scenes, Active Scene Only, hoặc Selected Scene).
  5. Bấm 🚀 Scan & Pack Assets.
  6. Xem hộp thoại tổng kết và file log chi tiết (asset_pack_log_YYYY-MM-DD_HH-MM-SS.txt) sinh ra trong thư mục Output.

Trình cài đặt Add‑on (Add-on Installer)

Khi gửi thư mục đã pack cho đối tác hoặc render farm, họ có thể dễ dàng khôi phục các add-on cần thiết:

  1. Mở N‑panel → Thẻ Asset Packer → Mục Asset Packer: Add-on Installer.
  2. Bấm Install from folder… và chọn thư mục Output (chứa _addons/).
  3. Trình cài đặt sẽ tự động đọc addons_manifest.json và kích hoạt đầy đủ các add-on tương thích mà không làm trùng lặp cấu hình.

Nhật ký thay đổi (Changelog)

  • v1.9.0 (Mới nhất)
    • Hỗ trợ đóng gói và relink trọn vẹn Linked Libraries (.blend) và Library Overrides.
    • Hỗ trợ đóng gói Font chữ 3D (.ttf, .otf)File âm thanh (Audio/Sounds).
    • Thêm bộ lọc phạm vi Scene Scope (ALL, ACTIVE, SELECTED).
    • Hỗ trợ nhận diện texture UDIM multi-tiles.
    • Gom toàn bộ thư mục Simulation Cache (Fluid, Cloth, Particles, Geo Nodes, Alembic, VDB).
    • Đóng gói chuẩn tương thích hoàn toàn định dạng Blender 4.2+ Extensions (blender_manifest.toml).
  • v1.8.0
    • Bổ sung khả năng quét và đóng gói cache simulation cơ bản.
    • Tương thích với Blender 5.0 alpha.
  • v1.5.0
    • Hỗ trợ video formats mở rộng (Movie clips, VSE, camera backgrounds, compositor).
    • Thêm tính năng đóng gói add-on kèm manifest và bảng cài đặt Add-on Installer.

Giấy phép (License)

Add-on được phát hành mã nguồn mở theo giấy phép GPL-3.0 License. Bạn có toàn quyền sử dụng, đóng gói và chia sẻ dự án của mình.

🚀 Update v1.9.0: Added full support for packing & relinking Linked Libraries (.blend) & Library Overrides, bundling 3D Text Fonts (.ttf, .otf) & Audio/Sounds, Scene Scope filtering (All / Active / Selected Scene), UDIM Tiles recognition, complete Simulation & Physics Cache folders bundling (Fluid, Cloth, Particles, Geo Nodes bakes, Alembic, VDB Volumes), and standard Blender 4.2+ Extensions format!

Overview

Blender Asset Packer is an add-on that collects and packages all external assets from your Blender project into a clean, standalone directory, making it easy to share, archive, or send to render farms. Unlike Blender’s native Pack Resources feature (which embeds files directly into the .blend), this tool creates a structured external folder with safe relative paths for maximum flexibility.

Quick Comparison: Asset Packer vs. Pack Resources
Pack Resources (Blender built-in)
  • ✅ Embeds files into .blend
  • ✅ Simple single file
  • ❌ Huge .blend file size (GBs)
  • ❌ Difficult to modify assets externally
  • ❌ Cannot pack add-ons
  • ❌ No Linked Libraries or Library Overrides support
  • ❌ Cannot handle external simulation cache directories
Asset Packer (Add-on)
  • ✅ Lightweight, independent .blend file
  • ✅ External assets neatly structured
  • ✅ 100% reliable relative path relinking
  • ✅ Full Linked Libraries & Overrides support
  • ✅ Full Simulation Caches support (VDB, Fluid, Geo Nodes)
  • ✅ 3D Text Fonts, Audio & UDIM Tiles support
  • ✅ Bundles active add-ons with installer panel

Why Use Asset Packer?

🚀 Key Features in v1.9.0

One-Click Solution

Automatically scans and packages images, sequences, UDIM tiles, videos, HDRIs, textures, 3D fonts, sounds, VSE strips, and compositor nodes in one pass.

Linked Libraries Support

Discovers external linked .blend files (bpy.data.libraries), copies them, and remaps library datablocks so Library Overrides function without broken links.

Simulation & Cache Bundling

Locates and copies entire cache directories for Fluid domains, Cloth/Physics point caches, Alembic (.abc), OpenVDB (.vdb), and Geometry Nodes bakes.

Scene Scope Filtering

Choose between scanning the entire file (All Scenes), only the current active scene (Active Scene Only), or a designated scene (Selected Scene).

Rock-Solid Relinking

Relinks paths inside the copied .blend to relative paths (//...) with smart fallback resolution for identical filenames in different folders.

Add-ons Backup & Installer

Optionally backs up active user add-ons into _addons/ with a manifest and a dedicated installer panel for target machines.


What Gets Packed in v1.9.0

  • Linked Libraries: External linked .blend files (bpy.data.libraries), library overrides, and linked collections/objects.
  • Single Images: Material textures, World HDRIs, Camera background plates, Compositor image nodes.
  • Image Sequences & UDIMs: Sequential frames (automatic pattern detection) and multi-tile UDIM textures (1001, 1002…).
  • Videos & Clips: Movie clips, Camera background clips, VSE video strips, Compositor movie clips, Material video textures.
  • Simulations & Caches: Fluid domain caches, Cloth and particle point caches, Alembic files (.abc), OpenVDB volumes (.vdb), Geometry Nodes bakes.
  • 3D Fonts & Audio: 3D text font files (.ttf, .otf) and audio/sound strips.
  • Photometric Profiles: Light IES profiles.
  • Add-on Bundles (Optional): Active user add-ons exported to _addons/ with manifest.

Installation

For Blender 4.2+ (Extension Support)

  1. Download asset_packer.zip from GitHub Releases.
  2. Open Blender → Go to Edit > Preferences > Get Extensions.
  3. Click the menu/arrow in the top-right and select Install from Disk….
  4. Select asset_packer.zip and enable the extension.

For Blender 2.80 - 4.1 (Legacy Add-on)

  1. Download asset_packer.zip.
  2. Open Blender → Go to Edit > Preferences > Add-ons.
  3. Click Install… and choose asset_packer.zip.
  4. Enable Import-Export: Asset Packer.
  • Sidebar Panel: Open 3D Viewport → Press N → Navigate to the Asset Packer tab.

Quick Start

  1. Open your project in Blender.
  2. Open the N-panel → go to the Asset Packer tab.
  3. Click 📁 Select Output Directory to choose your destination folder.
  4. Configure options:
    • Include .blend File: Copies the project .blend file into the output directory.
    • Auto Save Before Pack: Saves current file before packing.
    • Relink Assets: Remaps asset paths in the copied .blend to relative paths (//...).
    • Include Linked Libraries: Copies and relinks external .blend libraries.
    • Include Fonts & Sounds: Copies and relinks 3D text fonts and audio files.
    • Include Enabled Add-ons: Bundles active add-ons to _addons/.
    • Scene Scope: Choose All Scenes, Active Scene Only, or Selected Scene.
  5. Click 🚀 Scan & Pack Assets.
  6. Check the popup summary and the generated timestamped log file (asset_pack_log_YYYY-MM-DD_HH-MM-SS.txt) in the output folder.

Changelog (Highlights)

  • v1.9.0 (Latest)
    • Full support for Linked Libraries (.blend) and Library Overrides packing & relinking.
    • Full support for 3D Text Fonts (.ttf, .otf) and Audio/Sound files.
    • Added Scene Scope filtering (ALL, ACTIVE, SELECTED).
    • Added detection and packing for UDIM multi-tile textures.
    • Bundles complete Simulation & Physics Cache folders (Fluid, Cloth, Particles, Geo Nodes, Alembic, VDB).
    • Fully compliant with Blender 4.2+ Extensions format (blender_manifest.toml).
  • v1.8.0
    • Added basic simulation cache packing.
    • Compatibility updates for Blender 5.0 alpha.
  • v1.5.0
    • Video format support (Movie clips, VSE, compositor, camera backgrounds).
    • Add-on packaging with manifest and built-in Add-on Installer panel.

License

Open source under the GPL-3.0 License. You are free to use, package, and distribute your packed project folders.