You've already forked stocker_helper
41 lines
1.8 KiB
Markdown
41 lines
1.8 KiB
Markdown
# Stocker Helper
|
|
|
|
A Blender add-on for [Stocker Geometry Nodes](https://garylritchie.gumroad.com/l/stocker).
|
|
|
|
## Overview
|
|
|
|
The **Stocker Helper** creates a boundary cube that encompasses selected objects. It calculates the global bounding box, generates a mesh, aligns the origin to the bottom-front-left corner, and applies Geometry Node templates.
|
|
|
|
## Features
|
|
|
|
* **Bounding Box Calculation:** Calculates the global spatial extent of selected mesh objects.
|
|
* **Origin Alignment:** Sets the boundary object's origin to the **Back-Left** extreme (+Y, -X).
|
|
* **Geometry Nodes Injection:** Applies a `NODES` modifier using templates named `grid_pack` or `circle_pack`.
|
|
* **Asset Fetching:** Scans registered Asset Libraries for required node groups.
|
|
* **Height Buffer Control:** Adds a percentage-based buffer to the Z-height via a slider.
|
|
* **UI:** Access via the **Stocker** tab in the 3D Viewport N-Panel.
|
|
|
|
## Requirements
|
|
|
|
* **Blender Version:** 4.5
|
|
* **Node Group Templates:** The `.blend` file or the Stocker Asset Library **must** contain Geometry Node groups named `grid_pack` and `circle_pack`.
|
|
|
|
## Installation
|
|
|
|
1. Download `stocker.zip`.
|
|
2. Drag the `.zip` file into Blender.
|
|
|
|
## Usage
|
|
|
|
1. **Select Objects:** Select the objects for the packing area.
|
|
2. **Open Sidebar:** Press `N` in the 3D Viewport.
|
|
3. **Locate Tab:** Click the **Stocker** tab.
|
|
4. **Adjust Height Buffer:** Set the height buffer percentage.
|
|
5. **Run Setup:** Click **Grid Boundary** or **Circle Boundary**.
|
|
6. **Result:** An object named `Stocker_Boundary` is created with the configured Geometry Nodes modifier and origin.
|
|
|
|
## Recent Improvements
|
|
|
|
* **Asset Library Scan:** Implemented priority for "stocker" libraries and automatic appending of missing node groups.
|
|
* **Code Robustness:** Updated imports and classmethod poll attributes for Blender Extension compliance.
|