Image0225-2_edited_edited_edited.jpg

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.

Scatter modifier in Paint Mode

scatter paint.JPG

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 :

Effector.JPG

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.gif

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 :

cameculling.JPG

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 :

pref addon.png

Click Snap Instances

Creation : Keep pressing Shift key and select one or multiple object(s), select the target (surface), then press > 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 :

click snap.JPG

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 > 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 :

ivy.JPG

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 :

pipes.JPG

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 :

Brick walls.JPG

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

Window.gif

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 :

Windows.JPG

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 :

Handrail.JPG

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 :

Spiral stairs.JPG

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 :

Boolean.JPG

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

boolean.gif

Proxy

Creation :  Select object, then press J > Proxy

Access : Pie menu (J key) and N panel (addon panel)

Default Proxy modifier :

Proxy.JPG

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

Screen Selectable avec indic.jpg

Default Group modifier :

Group.JPG

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 :

Array.JPG

Modifier List : Display every BagaPie modifier related to the selected object.

array random.gif
Save Assets_vierge.jpg
displace.gif

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 :

displacement.JPG

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 :

Instance displace on array.JPG

Modifier List : Display every BagaPie modifier related to the selected object.

displace instances.gif

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

Need help or report a bug ?

  • Copie de 27_Artstation_logo_logos-512_edited_edited
  • YouTube
  • Instagram

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 !