# BY-GEN

<figure><img src="https://3226204921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP1obpIH8PEXlis2OfDpz%2Fuploads%2FJYnOP9vWrPTkmUWgnsp0%2FBY-GEN%2010%20Cover%20JPG.jpg?alt=media&#x26;token=efd971fa-7aef-49db-a3b1-7dcf7f3d2d20" alt=""><figcaption></figcaption></figure>

### Introduction

BY-GEN (V10 and onwards) is a usability addon designed to simplify the artistic workflow of using geometry nodes for procedural and generative effects.

The workflow is simple:

* Select one or more objects.
* Select a 'logic library' from one of the major categories (surface, mesh, volume).
* Apply the effect to the selected object/s.

Depending on the logic library selected, one or more geometry nodes modifiers will be added to the target object/s.

{% hint style="info" %}
For a visual walkthrough of the V10+ changes, watch the [release video](https://youtu.be/ZbvDazHPLOc).
{% endhint %}

{% hint style="danger" %}
**Note:** BY-GEN V10 has been built for Blender 5.0+
{% endhint %}

***

### Import Methods

The exact method of importing the content will also depend on the naming convention used. For example, geometry nodes effects that start with '(S)' are considered 'simple' effects, meaning only a single geometry nodes modifier needs to be constructed on the selected object. Alternatively, '(Ts)' effects import a template object from the content pack file and migrate the entire modifier stack to the originally-selected object, automatically assigning object references to the target object. This is a heavier procedure and will only be appropriate for specific workflows.

***

### Content Pack and Asset Libraries

Content packs can be added to BY-GEN via the 'content\_packs' folder in the addon's root directory. They can also act as Asset Libraries, provided the geometry nodes trees have been flagged as assets in the blend file. The node trees within the official content pack that comes with the BY-GEN addon have already been marked as assets, meaning you can optionally assign it as an asset library within your user preferences.

{% hint style="info" %}
Learn more about [Asset Libraries](https://docs.blender.org/manual/en/latest/files/asset_libraries/introduction.html) in the official Blender documentation.
{% endhint %}

See the following page for more information on creating content packs (or making asset libraries compatible with the BY-GEN content pack system):

{% hint style="info" %}
[Creating Content Packs (Including From Asset Libraries)](https://curtis-holt.gitbook.io/curtis-holt-docs/knowledge-base/blender-projects/by-gen/creating-content-packs-including-from-asset-libraries)
{% endhint %}

***

### Debugging

BY-GEN V10+ allows for debugging information to be exposed to the console or written to a text log, which should simplify the process of identifying issues. See the linked page for more information:

{% hint style="info" %}
[Debugging in BY-GEN](https://curtis-holt.gitbook.io/curtis-holt-docs/knowledge-base/blender-projects/by-gen/debugging-in-by-gen)
{% endhint %}

***

### For Developers

Below is some information specific to developers of the BY-GEN addon (or anyone making alternate versions of the addon).

{% hint style="info" %}
[Can I Sell Content Packs for BY-GEN?](https://curtis-holt.gitbook.io/curtis-holt-docs/knowledge-base/blender-projects/by-gen/can-i-sell-content-packs-for-by-gen)
{% endhint %}

{% hint style="info" %}
[BY-GEN Layout for Distribution](https://curtis-holt.gitbook.io/curtis-holt-docs/knowledge-base/blender-projects/by-gen/by-gen-layout-for-distribution)
{% endhint %}

***

### Additional Information

BY-GEN has undergone many changes across the versions. If you would like to learn more about the philosophy of the changes, then consider the following page:

{% hint style="info" %}
[Changes Over Time](https://curtis-holt.gitbook.io/curtis-holt-docs/knowledge-base/blender-projects/by-gen/changes-over-time)
{% endhint %}

{% hint style="info" %}
[Video Directory](https://curtis-holt.gitbook.io/curtis-holt-docs/knowledge-base/blender-projects/by-gen/video-directory)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://curtis-holt.gitbook.io/curtis-holt-docs/knowledge-base/blender-projects/by-gen.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
