Skip to content

alexustexus/ivy-generator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌿 Ivy Generator Controller for Blender

-Ivy Generator Controller- is a custom Blender add-on that lets you quickly grow procedural ivy on any object using Geometry Nodes and instancing. Ideal for creating nature scenes, fantasy environments, overgrown ruins, and more β€” all with full control over materials and growth behavior.

Designed for Blender artists who want fast, customizable greenery β€” without the pain of manual ivy modeling.

πŸ“Έ Preview

![Ivy Generator Preview](docs/ivy_example.jpg, material_panel.jpg, ui_panel.jpg)

(Include your own screenshots or renders here.)

✨ Features

  • 🌱 Procedural ivy growth using Geometry Nodes
  • 🧩 Supports multiple independent ivy controllers
  • πŸŽ›οΈ Custom UI panel for material control (color, roughness, translucency, etc.)
  • 🎨 Unique materials per controller instance
  • πŸ—‚οΈ Automatic instancing with unique collections per controller
  • 🧠 Smart naming (Ivy Controller, IVY_Instance_Collection.001, etc.)
  • 🧼 Clean structure and fully undoable
  • πŸ’‘ Ready for integration into modular environments or asset libraries

🧰 Requirements

  • Blender 4.5+ (tested in 4.5)
  • No third-party dependencies
  • Works with both Cycles and Eevee

πŸ”§ Installation

  1. Download the ivy_generator_controller.zip from Releases or clone this repo.
  2. In Blender, go to Edit > Preferences > Add-ons
  3. Click Install... and choose the zip file
  4. Enable Ivy Generator in the add-on list
  5. Done! The tool appears in the 3D View > Sidebar > Ivy Generator tab

πŸš€ Usage

  1. Select any mesh object in your scene
  2. In the Sidebar (press N), go to the Ivy Generator tab
  3. Click 🌿 Apply Ivy to Selected Object
  4. A new object named Ivy Controller appears β€” this drives the ivy growth
  5. Customize the ivy material under the BagaLeaf Material panel

πŸŽ›οΈ Material Controls

Each Ivy Controller generates instanced leaves with a unique material copy.

You can:

  • Adjust color, roughness, translucency, and alpha
  • Control parameters via the embedded "BagaLeaf" Node Group
  • Apply different settings to each controller separately

πŸ§ͺ Pro Tips

  • Use multiple Ivy Controllers on different surfaces (rocks, trees, buildings)
  • Animate the ivy by modifying node group parameters or blending modifiers
  • Replace the instance collection with your own custom leaf models
  • Optimize materials by linking shaders between controllers, if needed

πŸ“ File Structure

ivy_generator_controller/ β”œβ”€β”€ init.py β”œβ”€β”€ assets.blend # Contains instanced objects & materials β”œβ”€β”€ README.md β”œβ”€β”€ LICNSE.txt └── docs/ivy_example.jpg, material_panel.jpg, ui_panel.jpg (preview Images)

πŸ“£ Known Limitations

  • Only one Base Collection is currently used for all original source objects
  • All ivy controllers must be generated via the add-on panel (not manually duplicated)

πŸ™ Credits

  • Developed by [HyperSpace Academy]
  • Geometry Nodes inspired by Blender community experiments
  • Material shading system: fully procedural, powered by the BagaLeaf node group

Special thanks to the Blender community and open-source ecosystem ❀️

πŸ“œ License

This project is licensed under the "MIT License".
You can freely use, modify, and distribute it β€” even commercially β€” as long as attribution is maintained.

About

Procedural Ivy Generator Add-on for Blender using Geometry Nodes

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages