BagaPie
Modifier and Assets : Documentation
What is BagaPie ?
BagaPie Modifier is an all in one and free addon.
It creates presets for scattering, hard surface, deformation, architecture, array random, groups, ...
It is accompanied by the paying extension BagaPie Assets which is fully integrated into BagaPie's workflow (Blender 3.0 and 3.1 ONLY).
BagaPie V6 is available for B3.0 and B3.1 (previous version available for B2.93).
How it works ?
Select an object then press J. You can then choose a modifier in the pie menu (scatter, boolean, displace, ...).
The BagaPie panel (in the addons panel), display the modifiers present on the selected object.
You can control the modifier visibility, apply or remove them. The various properties of the selected modifier appear below.
Scattering
Scatter
Scatter Paint
Creation : Keep pressing Shift key and select one or multiple object(s) to scatter, select the target (surface) on which you want to scatter object(s), then press J > Scatter or Scatter paint.
Access : Pie menu (J key) and N panel (addon panel).
Notes :
_ You can add as many assets layers as you want.
_ Warning ! Due to recent redevelopment of the Scatter Tool, scatters created by the current version aren't compatible with the previous ones and vice versa.
Default Scatter modifier :
Modifier List : Display every BagaPie modifier present on the selected object.
Rename Layer : Allow you to rename the current scatter layer
View Display : Display only X% of the instances (only viewport).
Assets : Add or remove the selected asset to the selected layer. You have to select assets then add the object to the selection.
Proxy : Enable/disable proxy on every assets in the active layer.
Paint : Switch to paint mode to add/remove instances. If necessary, SUBDIVIDE YOUR SURFACE : please note that Scatter paint basically require subdivided surfaces.
Pos/Rot/Scale : Allow you to rotate, move or scale your instances.
Tip : You can use driver to synchronise texture between layer :
Random : Allow you to randomize the position, rotation and scale.
First row : minimum on X, Y and Z axis.
Second row : maximum on X, Y and Z axis.
Point Effector
For scattering
Creation : Keep pressing Shift key and select one object (thus designated as the effector), select the target (surface) and the related scatter layer in N panel, then press J > Point Effector.
Access : Pie menu (J key) and N panel (addon panel)
Note : If necessary, subdivide your surface to increase precision.
Default Point effector modifier :
Modifier List : Display every BagaPie modifier related to the selected object. At least one scatter layer is necessary.
Distance : Distance between object's surface and the instances.
Keep min and max close for sharper results.
Density : Instances density in the affected area. Switch from 0 to 1 to affect proportionally your scattered objects onto the surface.
Camera Culling
For scattering
Creation : Keep pressing Shift key and select one camera or empty, select the target (surface) and the related scatter layer in N panel, then press J > CamCulling.
Access : Pie menu (J key) and N panel (addon panel)
Notes :
_ Once this modifier is added, a button will appear in each scatter layer to enable/disable Camera Culling.
_ If necessary, subdivide your surface to increase precision.
_ You can't cumulate more than one Camera culling modifier.
Default Camera culling modifier :
Modifier List : Display every BagaPie modifier related to the selected object. At least one scatter layer is necessary.
Ratio : Allow to adapt the camera focal lenght on X and Y axis, from near to far.
Offset : Instances density at the edges of the affected area.
Security Features
For scattering
This feature avoids overloading your computer.
Access : BagaPie Modifier in Edit > Preferences > Addons > BagaPie
Note :
_ Don't forget to save your preferences !
_ Thanks for reading the documentation ! Here is a "secret" code to get BagaPie Assets with 20$ discount : bagapiedoc
BagaPie Modifier addon preferences > Security features :
Click Snap Instances
Creation : Keep pressing Shift key and select one or multiple object(s), select the target (surface), then press J > Point Snap Instance.
Utilization : On the N panel, click on Add Instances, then click onto the surface to add instances. Instances are added only on top of objects.
Press Escape to stop clicking.
Access : Pie menu (J key) and N panel (addon panel).
Notes :
- This tool ignores snapping on instances (incompatible with Array).
- This tool add new vertices, you can switch to edit mode and manually edit the instances position. For a better visualisation, display the initial scatter layer and activate Toggle X-ray (shortcut : Alt Z).
Default Snap Instance modifier :
Modifier List : Display modifier related to the selected object.
Add Instances : Allow you to add new instances on the affected surface.
Source data : Object and collection used.
Offset : Move instance on Z axis, from its initial position.
Random : Randomize rotation and scale
Ivy Generator
Creation : Select one or multiple target(s), set 3D Cursor and press J > Ivy
Utilization : In the N-panel (addon panel), you can apply, remove or change the visibility of the modifier, modify its parameters, add new ivy and add/remove target.
Access : Pie menu (J key) and N panel (addon panel)
Notes :
_ If you add an ivy from the Pie menu, a new ivy system is generated with new settings. If you use the N panel, you generate an extension of the existing one with the same parameters.
_ This generator creates a cylinder around the empty, then project this cylinder to generate ivy. Radius and height both match to the cylinder.
Default Ivy generator modifier :
Modifier List : Display modifier related to the selected object.
Target : Assign/remove a target from the Ivy system : from the initial Ivy layer, keep pressing Shift key, select the new target and select the Ivy. Then press + Target to include the target, or - Target to exclude the target.
Tip : Thanks for reading the documentation !
Here is a "secret" code to get BagaPie Assets with 20$ discount : bagapiedoc
Add a new ivy source : A new sphere (empty) with an ivy linked will appear. Move the Ivy empty to vary the arrangement of the ivy, or click on Add Ivy to 3D cursor to add multiple Ivy empties by setting de 3D Cursor.
Source data : Object and collection used.
Pipe Generator
Creation : Select target(s) (mesh for pipes snapping) and press J > Pipes.
Utilization : This tool switch automatically in edit mode and use the draw curve tool. If you want to add more pipes, select it and switch to edit mode.
Access : Pie menu (J key) and N panel (addon panel).
Note : You can easily edit the pipe in edit mode : You can edit each pipe by selecting the vertices of the affiliated curve.
Default Pipe generator modifier :
Modifier List : Display modifier related to the selected object.
Poly/Curve : Determine the main shape of the curve. You're free to switch from an polygonal to a curvilinear disposition.
Custom objects : Different extra part of the pipe.
Precision : The most important setting ! The pipe is fundamentaly generated from a curve and the position of each point on the curve is rounded. This setting determine the accuracy degree of the pipe
Jonctions et support : Dimensions of extra parts of the pipe.
Tip : Take a look to the "apply scatter" video.
UVs are stored as an attribute in geometry nodes. Once the modifier is applied, you can convert this attribute to UVs data.
Materials : You can assign materials on any part of the pipes in the modifier stack (the place you add modifiers in the object property)
Custom objects : Enable this button then set the source object/profile in the modifier stack (the place you add modifier in the object property)
Wall
Creation : Select a flat surface (2D shapes like plane, circle, or line) or a curve and press J > Wall or Brick Wall
Access : Pie menu (J key) and N panel (addon panel)
Note :
_ Wall tools are generated from edges : even if you can apply it to spheres or cubes, it could generate uncontrolled results : this modification changes edges into walls so use appropriate meshes.
_ Please note Wall tool can't apply to curve, while Brick Wall tool can.
Default Brick Wall modifier :
Modifier List : Display every BagaPie modifier related to the selected object.
Height/Thickness : Allow to edit wall or brick specifications.
Axis offset : Random disposition along the axis
Windows
Creation : Select Wall or another object, then press J > Windows.
Access : Pie menu (J key) and N panel (addon panel).
Notes :
_ In order to facilitate the utilization of the tool, don't forget to activate the Snap to faces basic feature : the volume you draw must have the same thickness as the wall to function properly.
_ Windows tools only fonctions on flat faces, and can't be properly applied to spheres or curved walls.
_ Thanks for reading the documentation ! Here is a "secret" code to get BagaPie Assets with 20$ discount : bagapiedoc
Default Windows modifier :
Modifier List : Display every BagaPie modifier related to the selected object.
Window Size/Offset/Bevel : Allow to edit window joineries
Merge by distance : has to be superior or equal to the wall thickness, otherwise the creation of the window can fail.
Handrail
Creation : Press J > Handrail, then draw path of the railing.
Access : Pie menu (J key) and N panel (addon panel)
Note : This tool uses a 2D curve. That is to say, it will always remain flat. To move it on the Z axis, you have to go into object mode and move the whole object. If you select a curve, the railing will follow the curve, otherwise you can draw them from scratch.
Default Handrail modifier :
Curve / Poly : Poly creates straight pipes between the points and the second follows the curve.
Modifier List : Display every BagaPie modifier related to the selected object.
Architectural Presets
Creation : Press J > Column, Beam, Stairs or Floor
Access : Pie menu (J key) and N panel (addon panel)
Default Spiral stairs modifier :
Modifier List : Display every BagaPie modifier related to the selected object.
Boolean
Creation : Select object, then press J > Difference (for material soustraction) or Union (for material addition), then draw your boolean.
Access : Pie menu (J key) and N panel (addon panel)
Notes :
_ By default, it uses Exact mode. If you have slowdowns switch to Fast mode.
_ The Boolean uses the Add Object tool, you can change the shape. If you do not use the exit button, it may remain active when you return to Edit Mode.
_ The mirror setting uses the object's origin by default.
_ If you use this modifier on meshes that contains Array or Scatter, hide them first and switch Boolean to Fast mode.
Default Boolean modifier :
Modifier List : Display every BagaPie modifier related to the selected object.
Utilization : When drawing a shape, press Ctrl to activate snapping or Alt to extrude from the center of the volume
Proxy
Creation : Select object, then press J > Proxy
Access : Pie menu (J key) and N panel (addon panel)
Default Proxy modifier :
Modifier List : Display every BagaPie modifier related to the selected object.
Save Assets/Material
Creation : First, create a new Library, in Edit > Preferences > File Paths > Asset Libraries > Add Asset Libraries > Save preferences.
Select object(s) and press J > Save Asset or Save Material > Select your library. Then, switch to Asset Browser Edit Type to visualise your saved asset(s) and refresh the Asset library. Your asset appear and you can now drag and drop the object on 3D Viewport Edit type.
Access : Pie menu (J key) and N panel (addon panel)
Notes :
_Once you've saved your asset, don't forget to refresh the Asset Library (shortcut R).
_ If the object is modified and it is save as asset again, an option detects the existing version and proposes to create a variant (by renaming the asset). You can also decide to replace the existing asset with the new one.
_ If you open a new blender, the assets will be directly available.
_ Thanks for reading the documentation ! Here is a "secret" code to get BagaPie Assets with 20$ discount : bagapiedoc
Use your local library. Eg : "New Library"
Group_ Duplicate by Alt + N
Group_ Instances
Group
Creation : Keep pressing Shift key , select objects and press J > Group.
Access : Pie menu (J key) and N panel (addon panel)
Notes :
_ Select the group by clicking on the origin or on an edge of the bounding box. if the bounding box is deleted, objects must be frozen, so enable the Selectable thumbnail (yellow box on the screenshot bellow) in the layer panel by activate it in Filter (red box bellow).
_ If the selected objects have a parent, the parent must be selected for them to be taken into account.
_ Once the group has been created, the group's objects is no longer selectable, use Edit Group to make it selectable again.
Utilization :
_ Once your group is created, you can Lock it to make it unselectable, or Edit it to modify the position and the geometry of each one of the objects of the group.
_ Use Alt + J to basically duplicate the group by creating an independant group ; both of the original and the copy are therefore not affected by any modifications of their alter ego.
_ Use Alt + N to duplicate the group by creating a linked group ; thus note the original and the copy are only impacted by the modification of the geometry of the components of the linked group. They aren't affected by any translations (rotation, scale or move) of objects within the linked group.
_ Convert your group into multiple instances by selecting the group, then click Instances in Bagapie panel. The original group appears at the origin of the 3D viewport, then duplicate and spread the instances. To modify instances, use Edit mode in the original group, as you can modify both geometry and translation of the objects of the group. This is the most optimized method to duplicate identical objects in wide quantities without overloading your computer., as only one group is physically modelised : as instances only are projections of the original group.
Activate Selectable in layer panel to enable selection of unselectable objects
Default Group modifier :
Modifier List : Display every BagaPie modifier related to the selected object.
Utilization : Edit, delete or change the group to an instance. You can duplicate the group by selecting its bounding box and pressing Alt + J (or Alt + N for duplicate linked).
Array
Creation : Select object, then press J > Array, choose the type of array : Line, Grid, Circle or Curve
Access : Pie menu (J key) and N panel (addon panel)
Note :
_ BagaPie Assets unlock an additionnal tool : Draw Array Assets, which is a shortcut to randomly arrange BagaPie vegetal and mineral assets by drawing a curve.
_ Don't apply your Array from Blender modifier panel otherwise it will not operate ; apply it only from Bapapie panel.
Default Circle Array modifier :
Modifier List : Display every BagaPie modifier related to the selected object.
Displacement
Creation : Select object, then press J > Displace, then select the type of texture you need in the N-panel
Access : Pie menu (J key) and N panel (addon panel)
Note :
_ Depending on the type of texture used, some parameters (scale, brightness, and ramp) may not be available.
_ Thanks for reading the documentation ! Here is a "secret" code to get BagaPie Assets with 20$ discount : bagapiedoc
Default Displacement modifier :
Modifier List : Display every BagaPie modifier related to the selected object.
Instance Displacement
Creation : Select object, it must have instances (Arrayed or Scattered objects only) then press J > Instances Displace
Access : Pie menu (J key) and N panel (addon panel)
Note :
_ You can't convert it to mesh.
_ Thanks for reading the documentation ! Here is a "secret" code to get BagaPie Assets with 20$ discount : bagapiedoc
Default Instance Displacement modifier :
Modifier List : Display every BagaPie modifier related to the selected object.
Bagapie Assets
Creation : Select object, then press J > Scatter > Asset then select the type of asset (rocks, trees, grass, stumps and plants. Let's play with it !
Access : Pie menu (J key) and N panel (addon panel)
Once again, thanks for reading the documentation ! Here is a "secret" code to get BagaPie Assets with 20$ discount : bagapiedoc
Hi ! l'm Antoine Bagattini, the creator of BagaPie.
Many thanks to everyone who supports the development of this addon.
Especially many thanks to Franck Demongin and Clovis Flayols for their help !