# INTRODUCTION Welcome to the official CY-Tools Documentation. As a 3D artist working in the domain for more than a decade, I decided to start making tools for speeding up certain processes of mine that were repetitive or a bit tedious and wanted to share those tools with the Blender community. Some add-ons out there are doing similar things, some with extreme complexity. I personally set out to create a minimal, user-friendly set of tools that are affordable and to the point. \ \ You can find information about all the current tools under the suite, including: * [INSTAFOG](/instafog)\ Create cloud-like fog in one click - Instantly adds a cube in your scene with a Principled Volume configured to appear like a cloud under both EVEE and Cycles renderer. * [LIGHTGEN](/lightgen)\ Generate random lighting scenarios - Instantly generates Point Lights in the scene to achieve different lighting scenarios. * [CUBEGEN](/cubegen)\ Generate random cubes - Instantly places cubes in the scene with random positions and scales. * [WIGGLER](/wiggler)\ Make it shake - Instantly add a rotational wiggling noise modifier to any object, and control the strength and scale to achieve different intensities and speeds. * [COLORIZER](/colorizer)\ Randomize object colors - Instantly randomize the base color of objects, lights, and volumes. * [VIEWPOINTS
](/viewpoints)Renders all the selected cameras at once. * [CYGPT](/cygpt) \*New\*[
](/viewpoints)A new experimental toolkit seamlessly integrating AI functionalities within your Blender workspace to elevate your creativity and efficiency to new heights! *Requires OpenAI API Key or Ollama* * [CELL GROWTH](/cell-growth) \*New\* \ Simulate organic growth patterns - CellGrowth leverages differential growth algorithms to create organic and natural growth patterns in your mesh objects. * [SMART IMPORTER](/smart-importer) \*New\* \ A simple addon designed to streamline the file import process. Instead of manually selecting the file format before importing, simply click "Import Any File..." and let the addon intelligently detect and import the file.

#### 1. Installation 1. Downloaded the latest zip through the Blender Market page.\ 2. Open Blender, go to Edit > Preference > Addons > `Install...` 3. Locate and select the downloaded Python script file and click `Install Add-on` 4. In the Add-ons tab, search for "CY-Tools Suite" in the search bar. Check the checkbox next to the addon's name to enable it. (If you don't want to install the full suite, you can also extract the zip and install individual addons by simply installing the \_\_init\_\_.py under each folder.) **USEFUL LINKS**\ Blender Market Page: \ Author website: [https://cjkproduction.com](https://cjkproduction.com\\)
# INSTAFOG A Blender addon for instantly adding a cube in your scene with a Principled Volume configured to appear like a cloud under both EVEE and Cycles renderer.

The properties are set to the following by default to achieve a cloud look with the Principle Volume using a Musgrave texture. Make sure you have lights in your scene to view the fog properly and feel free to play around with the values. The following should be considered: * Scale: This parameter controls the size of the texture. A larger scale value will create a more detailed texture with smaller features, while a smaller scale value will create a smoother texture with larger features.

* Detail: This parameter controls the amount of high-frequency detail in the texture. A higher detail value will create a more complex texture with more small-scale variations, while a lower detail value will create a simpler texture with fewer variations. * Dimension: This parameter controls the overall shape of the texture. Higher values will create a more flat, two-dimensional texture, while lower values will create a more three-dimensional texture with bumps and ridges. * Lacunarity: This parameter controls the variation in feature size within the texture. A lower lacunarity value will create a more uniform texture with less variation in feature size, while a higher lacunarity value will create a more varied texture with larger and smaller features mixed together.

### Recommendations: **FOR EVEE:**

Make sure to have a look at Render Properties > Volumetrics parameters. If you have a performing GPU, you can easily set the tile size to 2px to get a more crisp fog, as well as make sure to enable Volumetric Shadows. I personally got good results with Distribution and Light Clamping to 0.
**FOR CYCLES:** For more control over rendering go to Render Properties > Light Paths parameters.\ Change the "Volume" value from 0 to a value between 4 to 12 or above depending on your hardware. Under Render Properties > Volumes, change the Max Steps to control how many samples the volume will render with. You can lower this in case of extremely long render times.

I also recommended to using INSTAFOG in combination with the [COLORIZER ](/colorizer)addon. ### Development considerations This addon is still in development and interactions may occasionally not work as expected.\ Follow this addon on Blender Market to stay tuned regarding any updates. ### Author and License Cy-Tools is a suite of Blender Addons created by @cyrusjameskhan and\ licensed under the GNU General Public License (GPL). See [LICENSE](/license) for more information. # LIGHTGEN A Blender addon for instantly generating Point Lights in the scene to achieve different lighting scenarios. ### Usage Access the addon's panel: 1. Open a 3D Viewport in Blender. 2. In the 3D Viewport, locate the Tool Shelf on the right side. 3. Look for the "CY-Tools" tab and click it to reveal the "CY-Tools Cubes Generator" panel.

Generate random lights: * Adjust the scatter range by entering values for X Range, Y Range, and Z Range. Specify the number of lights to generate by entering a value for Scatter Amount. * Click the "Generate" button to create the specified number of lights scattered within the defined range. * Delete generated lights: Click the "Delete" button to remove all generated lights from the scene.

### Recommendations Recommended to use LIGHTGEN in combination with the [COLORIZER ](/colorizer)addon. ### Development considerations This addon is still in development and interactions may occasionally not work as expected.\ Follow this addon on Blender Market to stay tuned regarding any updates. ### Author and License Cy-Tools is a suite of Blender Addons created by @cyrusjameskhan and\ licensed under the GNU General Public License (GPL). See [LICENSE](/license) for more information. # CUBEGEN The CY-Tools Generate Cubes is a Blender add-on that provides a graphical user interface for generating random cubes scattered at different positions with a controllable scatter range. ### Usage Access the addon's panel: 1. Open a 3D Viewport in Blender. 2. In the 3D Viewport, locate the Tool Shelf on the right side. 3. Look for the "CY-Tools" tab and click it to reveal the "CY-Tools Cubes Generator" panel.

Generate random cubes: * Adjust the scatter range by entering values for X Range, Y Range, and Z Range. * Specify the number of cubes to generate by entering a value for Scatter Amount. * Click the "Generate" button to create the specified number of cubes scattered within the defined range. Delete generated cubes: * Click the "Delete" button to remove all generated cubes from the scene. Randomize the scale of generated cubes: * Click the "Randomize Scale" button to change the scale of all generated cubes to random values within the specified range.

### Recommendations I personally like using this tool as a starting point for creating basic cityscapes. By generating multiple cubes with random scales and positions, it provides a foundation for a simplistic representation of a city's buildings. \ \ Recommended to use LIGHTGEN in combination with the [COLORIZER ](/colorizer)addon. ### Development considerations This addon is still in development and interactions may occasionally not work as expected.\ Follow this addon on Blender Market to stay tuned regarding any updates. ### Author and License Cy-Tools is a suite of Blender Addons created by @cyrusjameskhan and\ licensed under the GNU General Public License (GPL). See [LICENSE](/license) for more information. # WIGGLER A simple Blender addon that enables users to add random noise to the rotations of selected objects, either mesh or camera, via a GUI in the 3D Viewport's Tool shelf. ### Usage Access the addon's panel: 1. Open a 3D Viewport in Blender. 2. In the 3D Viewport, locate the Tool Shelf on the right side. 3. Look for the "CY-Tools" tab and click it to reveal the addon panel. The `strength` and `scale` values are properties that control the noise applied to the rotations of selected objects.

1. Strength: The `strength` value determines the intensity or magnitude of the noise effect on the object's rotations. A higher strength value results in more significant variations in the object's rotations, while a lower value leads to subtler changes. The strength property has a default value of 0.5, and the user can set it between 0 (no noise) and 10 (maximum noise). 2. Scale: The `scale` value controls the frequency of the noise effect. A higher scale value results in a slower, more gradual change in the object's rotations, giving the impression of a smoother, less erratic motion. Conversely, a lower scale value leads to rapid, frequent fluctuations in the rotations, creating a more chaotic and erratic motion. The scale property has a default value of 15, and the user can set it between 0 (extremely high-frequency noise) and 100 (very low-frequency noise).

### Recommendations I personally built this script to quickly get some camera noise modifiers going in a blink as I felt the whole keyframing process took a little while, I used some addons, but then I figured why not make my own very minimal version. This is a great way to instantly add a handheld effect to your camera.

Applied to a camera for quick random shake

### Development considerations This addon is still in development and interactions may occasionally not work as expected.\ Follow this addon on Blender Market to stay tuned regarding any updates. ### Author and License Cy-Tools is a suite of Blender Addons created by @cyrusjameskhan and\ licensed under the GNU General Public License (GPL). See [LICENSE](/license) for more information. # COLORIZER A simple Blender addon to instantly randomize the base color of objects, lights and volumes. ### Usage Access the addon's panel: 1. Open a 3D Viewport in Blender. 2. In the 3D Viewport, locate the Tool Shelf on the right side. 3. Look for the "CY-Tools" tab and click it to reveal the addon panel.

Click `COLORIZE` to instantly apply a new random color to a mesh, volume, or light object.\ (\**Please note that if you are selecting a mesh object, it must first contain a material before the base color can be randomized.)*

### Development considerations This addon is still in development and interactions may occasionally not work as expected.\ Follow this addon on Blender Market to stay tuned regarding any updates. ### Author and License Cy-Tools is a suite of Blender Addons created by @cyrusjameskhan and\ licensed under the GNU General Public License (GPL). See [LICENSE](/license) for more information. # VIEWPOINTS A simple Blender addon that lets the user select cameras in the scene and instantly render a still image. ### Usage Access the addon's panel: 1. Open a 3D Viewport in Blender. 2. In the 3D Viewport, locate the Tool Shelf on the right side. 3. Look for the "CY-Tools" tab and click it to reveal the addon panel.

To add a camera to the list, click the "+" button on the right side of the camera list. A new entry will be created in the list. Click on the new entry to reveal a dropdown menu of available cameras in your scene. Select the desired camera from the list. Repeat steps 5 and 6 to add more cameras to the list as needed. If you need to remove a camera from the list, select the camera entry in the list and click the "-" button on the right side of the camera list. To render the selected viewpoints, click the "Render Viewpoints" button at the bottom of the panel. The add-on will render each camera viewpoint individually and save the output images as PNG files in a folder named "Blender Viewpoints Exports" on your Desktop. The images will be named according to their corresponding camera names in the Blender scene. ### Development considerations This addon is still in development and interactions may occasionally not work as expected.\ Follow this addon on Blender Market to stay tuned regarding any updates.\ \ Future implementations include a setting to export an animation. ### Author and License Cy-Tools is a suite of Blender Addons created by @cyrusjameskhan and\ licensed under the GNU General Public License (GPL). See [LICENSE](/license) for more information. # CELL GROWTH Differential (Cell-like) Growth Simulation Addon for Blender.

### Usage To use the CY-Tools CellGrowth addon, follow these steps: 1. **Access the addon's panel**: * Open a **3D Viewport** in Blender. * In the 3D Viewport, locate the **Tool Shelf** on the right side. * Look for the **"CY-Tools" tab** and click it to reveal the addon panel.

1. **Create vertex groups**: * This addon works by iterating the on the vertex weights. Before you can start growth, you must select vertices and add them to a group. You can do this manually, or click the 'create random vertex group' at the top of the panel.

2. **Configure Growth Settings**: * **Seed**: Controls the random seed for noise generation. Default is 0.1. * **Scale**: Sets the growth scale in the X, Y, and Z directions. Default is (1.0, 1.0, 1.0). * **Repulsion Radius**: Radius within which vertices repel each other. Default is 1.0. * **Noise Scale**: Scale of the noise applied to vertices. Default is 0.5. * **Attraction Factor**: Factor for attraction force between vertices. Default is 0.5. * **Repulsion Factor**: Factor for repulsion force between vertices. Default is 0.5. * **Noise Factor**: Factor for noise applied to vertices. Default is 0.1. * **Time Step**: Time step for each growth iteration. Default is 0.1. * **Inhibit Base**: Base inhibition factor for non-boundary vertices. Default is 0.1. * **Inhibit Shell**: Inhibition factor based on vertex shell factor. Default is 0.1. * **Split Radius**: Radius at which edges are subdivided. Default is 0.1. 3. **Execute Growth Step**: * Click the **"Execute Growth Step"** button to simulate a growth step based on the configured settings.

### Recommendations I personally built this script to simulate organic growth patterns quickly and efficiently. It's a great way to create intricate and detailed mesh structures that mimic natural forms. The addon allows you to experiment with various growth settings to achieve diverse and visually appealing results. Bear in mind with every iteration you are dealing with more vertices, be careful of not going too quickly as it could cause blender to crash-to-desktop. ### Development Considerations This addon is still in development, and interactions may occasionally not work as expected. Follow this addon on Blender Market to stay updated on any new updates and improvements. ### Author and License Cy-Tools is a suite of Blender Addons created by **@cyrusjameskhan** and licensed under the GNU General Public License (GPL). See LICENSE for more information. ### Inspiration

This addon was inspired by Boris Okunskiy's incredible work with the [Differential Growth plugin](https://github.com/inca/blender-differential-growth). As it has not been updated for over two years, I decided to create a new version of it to continue exploring the fascinating possibilities of differential growth in Blender. You can read more about Boris Okunskiy's work on his [blog](https://boris.okunskiy.name/posts/blender-differential-growth). # SMART IMPORTER The CY-Tools SmartImporter addon allows you to import any file type into Blender without needing to pick the format beforehand. Simply click "Import Any File..." and select any file format. ### Usage 1. Go to `File > Import > Import Any File...`. 2. Select any file format supported by the addon. 3. The addon will automatically detect the file type and import it accordingly.

### Development Considerations * This addon is still in development, and interactions may occasionally not work as expected. * Follow this addon on Blender Market to stay tuned regarding any updates. * Future implementations to include a multi-file/format selection. ### Author and License CY-Tools is a suite of Blender Addons created by @cyrusjameskhan and licensed under the GNU General Public License (GPL). See LICENSE for more information. # CYGPT These are experimental tools that bring the power of OpenAI's GPT models to your Blender workflow, from writing and executing scripts on the spot from a prompt, to generating textures. #### 1. Cy-GPT: Operator `Cy-GPT: Operator` leverages the capabilities of the GPT model. It acts as a co-pilot, generating Python scripts based on your textual input and executing them directly within Blender. Essentially, the GPT model translates your text input into a Python script, which is then immediately executed, thereby making complex scripting tasks more accessible and user-friendly. Besides generating and executing scripts, `Cy-GPT: Operator` also maintains a list of previously generated scripts, providing options to open or delete scripts as needed. This enhances script management and helps maintain a clean and organized scripting environment. #### 2. Cy-GPT: Blendalle `Cy-GPT: Blendalle` provides another kind of integration of AI within Blender. By leveraging OpenAI's DALL-E, an innovative image generator, `Blendalle` can create textures from textual prompts. This feature allows you to generate intricate textures directly within Blender by simply providing a descriptive prompt, transforming the way you design and conceptualize materials. #### 3. Installation 1. Downloaded the latest zip through the Blender Market page. 2. Open Blender, go to Edit > Preference > Addons > `Installl...` 3. Locate and select the downloaded Python script file and click `Install Add-on` 4. In the Add-ons tab, search for "Cy-GPT" in the search bar. Check the checkbox next to the addon's name to enable "Cy-GPT: Operator" and "Cy-GPT: Blendalle". 5. Input your API Key provided by OpenAI. #### 4. Author and License Cy-Tools is a suite of Blender Addons created by @cyrusjameskhan and\ licensed under the GNU General Public License (GPL). See [LICENSE](/license) for more information. # Blendalle Cy-GPT: Blendall-E is a Blender add-on that integrates OpenAI's DALL-E APIs into Blender. This allows you to generate images using OpenAI's DALL-E directly from within the Blender environment.

### Usage After installing the add-on, go to the "Image Editor" panel in Blender. In the sidebar, you'll see a new panel labeled "Cy-GPT: Blendall-e". In the panel, you'll find: * A "Prompt" field: Enter a description of the image you want to generate. * A "Size" dropdown: Select the resolution of the generated image. Options include 256x256, 512x512, and 1024x1024. * A "Generate" button: Click this to generate the image.

### Limitations and Warnings You must use your own API key to interact with OpenAI's DALL-E API. Also, please be aware that DALL-E's API is subject to usage limitations as specified by OpenAI's API terms and conditions. # Operator The "Cy-GPT: Operator" is a Blender add-on that uses the LLMs (Large Language Models) to generate and run scripts based on user input. It essentially serves as a co-pilot, generating Python scripts and executing them directly in Blender.

### Usage Access the addon's panel: 1. Open a 3D Viewport in Blender. 2. In the 3D Viewport, locate the Tool Shelf on the right side. 3. Look for the "CY-Tools" tab and click it to reveal the "Blender Transformer" panel. After you have entered your API key from OpenAI, you can proceed to type in a prompt, here are a couple of examples:\ \ `" Create 5 cubes in a row"` `"Make the world background color red"` `"Add 10 lights at random positions"` `"Create a camera that constantly looks at the center cube"` `"Delete all the lights in the scene"` `"Rotate all the objects in the scene randomly"` `"Render the selected cameras"`
The GPT model will process the user input and generate a Python script as per the request, which will be executed directly in Blender. The AI Response field shows the script generated by the GPT model. The add-on maintains a list of generated scripts, which are displayed under the "Generated Scripts" section. Each script can be opened in the Text Editor or deleted from the list. ### Recommendations Try to be concise with your information such as specifying the exact number of items your are looking to generate. ### Limitations and Warnings Please remember this addon is very experimental and will occasionally cause Blender to crash. Moreover, the current base dataset was based on information about Blender that is already outdated for a lot of tasks (2019-2021). For instance with the prompt "Change the background color to ultraviolet" it will most likely work, but not in the newer world node shading system. If you untick "Use-Nodes" in your world properties, you will see the color displaying. These issues will hopefully be solved in the future as I iterate on this tool to include a fine tuned model as well. You must use your own API key to interact with OpenAI's API. Also, please be aware that the API is subject to usage limitations as specified by OpenAI's terms and conditions. ### Installation * Downloaded the latest zip. * Open Blender, go to Edit > Preference > Addons > `Install...` * Locate and select the downloaded Python script file and click `Install Add-on` * In the Add-ons tab, search for "CY-GPT" in the search bar. Check the checkbox next to the addon's name to enable them. #### OpenAI 1. Go to: and create an account 2. After setting up billing, head to and generate an API key. 3. Select GPT-4o, GPT-4, or GPT-3.5 in Cy-GPT preferences. 4. Model should be ready to use! (Visit to track your usage) #### Ollama 1. Download and install: 2. Open terminal and type: 'Ollama run llama3' to download and run the model once. You can then close the terminal window. 3. Open a new window and type 'Ollama serve'. 4. Select Llama3-8b in Cy-GPT preferences. 5. Model should be ready to use! (This is running on your computer so there aren't any costs associated.)
# HELP General Q/A | Question | Answer | | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Do I need to open the zip? | You can directly use the zip file without extracting it. | | What license are these addons under? | Cy-Tools is licensed under the GNU General Public License (GPL). See [LICENSE](/license) for more information. | | Who is the author? | The author is @cyrusjameskhan see more at [AUTHOR](/author). | | I can't run the addon. | If you have followed all the steps highlighted in this documentation, and are still having issues, you may submit a report at [CONTACT](/contact). | | Can I get a refund? |

If you have followed all the steps highlighted in this documentation as well as sent a bug report, yet are still experiencing technical difficulties running the suite on your machine, a refund may be considered.
(Must be within 30 days of purchase.)

Submit a request at CONTACT and chose the topic "Other".

| # CONTACT For any bug report please fill in the following form" {% embed url="" %} # LICENSE General Public License The add-ons mentioned in this document are licensed under the GNU General Public License (GPL). This means you are free to use, modify and distribute these add-ons, as long as you distribute them under the same license. You have the right to study and modify the source code to meet your needs. Any modifications you make must also be licensed under the GPL. The key principles of the GPL are: 1. Freedom to use: The license allows anyone to use the software for any purpose, without any restrictions. 2. Freedom to study: The license allows anyone to examine the source code of the software to learn from it. 3. Freedom to modify: The license allows anyone to modify the software and distribute the modified version. 4. Freedom to distribute: The license allows anyone to distribute the original or modified version of the software to others, as long as they also distribute it under the same license. 5. Copyleft: The GPL is a copyleft license, which means that anyone who receives a copy of the software and modifies it must make the modified source code available under the same license. # AUTHOR @cyrusjameskhan My name is Cyrus James Khan, I’m a digital artist and tech enthusiast who’s been learning computer graphics since I was 8 years old. I am a self-taught 3D Generalist, meaning I operate in everything from 3D modeling, rigging, texturing, animation, lighting, and rendering. Visual arts has been my passion since I can remember, along with a deep appreciation of science fiction and technology, which has shaped my career path to this day. I have always used computers to push the boundaries of my imagination and strive to remain on the cutting edge of technology, including working in Virtual Reality, Game Development, Blockchain, and AI. You can find more of my work and stay tuned on my developments via my[ linktree ](https://linktr.ee/cyrusjameskhan)and [website](https://cjkproduction.com).