Skip to content

Build Kit 2.2#

Installation#

Compatibility#

Maya 2022 2023 2024 2025 2026
Python 2.7 3.x

How to install#

  1. Extract the RS_Assets folder from the RS_Assets.zip

  2. Extract RS_Build_Kit.pyc from RS_Build_Kit_MAYAVERSION.zip (depending on your Maya Version)

  3. Copy RS_Build_Kit.pyc or RS_Build_Kit.py (Studio Version) and the RS_Assets folder to:

    If an RS_Assets folder already exists in your folder

    If an RS_Assets folder already exists in the location below, please copy the RS_Build_Kit folder (from inside the extracted RS_Assets folder) and paste it into the existing RS_Assets folder in the location.

    \Users\USERNAME\Documents\maya\MAYAVERSION\prefs\scripts
    
    $HOME/maya/MAYAVERSION/prefs/scripts
    
    $HOME/Library/Preferences/Autodesk/maya/MAYAVERSION/prefs/scripts
    
  4. Launch / Restart Maya

  5. In Maya, open a Python Tab in the Script Editor and execute :

    1
    2
    3
    4
    from importlib import reload
    import RS_Build_Kit
    reload(RS_Build_Kit)
    RS_Build_Kit.MainClass_BuildKit.show_buKi_dialog()
    

    Attention

    Please make sure that there are no Space characters in front of each code line.

    Maintain settings during a Maya instance

    The code above will load a new instance of the tool every time it is executed. To maintain the settings during a Maya session, even if the tool is closed, use the code below:

    import RS_Build_Kit
    RS_Build_Kit.MainClass_BuildKit.show_buKi_dialog()
    

Initial Setup Requirements#

Enable Track Selection Order
  1. Make sure Track selection order is enabled

    Screenshot

For Quad Fill: Set Boundary Options
  1. Open the Boundary Options

    Screenshot

  2. Set the settings as below and save them.

    Screenshot

Environment Variables#

  1. To set and use a custom folder location, please open the Maya.env file.

    The Maya.env file is located here

    \Users\USERNAME\Documents\maya\MAYAVERSION
    
    $HOME/maya/MAYAVERSION
    
    $HOME/Library/Preferences/Autodesk/maya/MAYAVERSION
    
  2. Add the following lines to the Maya.env file:

    MAYA_SCRIPT_PATH = path\to\your\custom\script\folder
    PYTHONPATH = path\to\your\custom\script\folder
    RS_TOOLS_PATH = path\to\your\custom\script\folder
    

    Attention

    1. Replace path\to\your\custom\script\folder with the actual path to your scripts.
    2. Make sure there is no forward slash (/) or backward slash (\) at the end of the path.

Interface Basics#

Tool Menu#

Screenshot   Mesh / Selection / Layout tools

Screenshot   Import / Export tools

Screenshot   Curve tools

Screenshot   About / Links / Shortcuts / Scale UI

Tool Settings#

Indicator

A blue line underneath an icon indicates that optional tool settings are available.

Screenshot

How to open?

Open the settings with a RMB 2 click.

Position & What settings are open?
  1. The settings widget will appear at the bottom of the tool.

  2. The background of an icon button turns dark gray to indicate it's settings are currently open.

Screenshot

How to close?

To close the settings page RMB 2 click the active button again.

Tooltips#

  1. Hover over a button until a tooltip shows up.
  2. Tooltips include information about available Modifier Alt Ctrl Shift and RMB 2 settings options.

Screenshot

Please make sure that tooltips are enabled!

In Maya's main menu go to:

Windows > Settings / Preferences > Preferences > Interface > Help

and check DisplayToolClips under PopupHelp

Expand / Collapse tabs#

It is possible to expand or collapse all tabs on an active page.

Expand

Ctrl   click on Screenshot or Screenshot or Screenshot

Collapse

Alt   click on Screenshot or Screenshot or Screenshot

Note

A settings page will automatically close when expand or collapse all tabs is used.

Keyboard Shortcuts#

It is possible to control aspects of the tools interface with keyboard shortcuts.

Access pages

1   -   Mesh Page

2   -   Import / Export Page

3   -   Curve Page

4   -   About Page

5   -   Toggle Tool Menu Visibility

Requirements

The tool needs to have focus, for the shortcuts to work.

Expand / collapse tabs

 Ctrl   +   1   to expand all tabs on the Mesh Page

  Alt   +   1   to collapse all tabs on the Mesh Page

 Ctrl   +   2   to expand all tabs on the Import / Export Page

  Alt   +   2   to collapse all tabs on the Import / Export Page

 Ctrl   +   3   to expand all tabs on the Curve Page

  Alt   +   3   to collapse all tabs on the CurvePage

Attention

This only works on the currently active page.

Minimize to main menu

 Alt   +   5 to minimize the tool

Screenshot

About Page#

Access the About page by clicking on Screenshot

The page contains information about the tool, web links and options to set up hotkey shortcuts and scale the UI.

Interface - About Page#

Screenshot

Create Hotkey Shortcuts#

How to: Create Shortcuts

LMB 1 click on the Create Hotkey Shortcuts button

Screenshot

How to: Open Hotkey Editor

Alt + click on the Create Hotkey Shortcuts button to open Maya's hotkey editor.

Info

You can also access the Hotkey Editor under Windows > Settings/Preferences > Hotkey Editor

Scale UI#

  1. Open About Page
  2. Choose a UI scale size in the drop-down menu: 100%, 125%, 150%, 200%
  3. Click the Set UI Scale button
  4. Close and reload the tool

Edit Mesh#

Interface - Edit Mesh#

Screenshot

Combine & Separate Screenshot#

  1. Combine

    Advanced Combine operation
    • Clean history (without empty groups)
    • Keeps the name of the first selected object
    • Stays under current parent
    • Option to keep the orientation from the first selected object
    • When combining a single group, it keeps the group name

    Screenshot

    How to use
    1. Select 2 or more objects or 1 or more groups

    2. LMB 1 click on Screenshot to run the script

    Add   Shift   to keep the orientation from the first selected object

  2. Separate

    Advanced Separate operation
    • Clean history (without empty groups)
    • Keeps mesh name and adds a _Sep# suffix
    • Stays under current parent
    • Centers pivots
    • Option to keep the orientation from the first selected object

    Screenshot

    How to use
    1. Select 1 or more combined objects

    2. Alt + click on Screenshot to run the script

    Add   Shift   to keep the orientation from the first selected object

Extract & Duplicate Face Screenshot#

  1. Extract

    Advanced Extract operation
    • Clean history (without empty groups)
    • Keeps mesh name and adds an _Ext# suffix
    • Remains under parent
    • Centers pivot
    How to use
    1. Select one or multiple faces
    2. LMB 1 click on Screenshot to run the script
  2. Duplicate Face

    Advanced Duplicate Face operation
    • Clean history (without empty groups)
    • Keeps mesh name and adds a _Dup# suffix
    • Stays under current parent
    • Centers pivot
    How to use
    1. Select one or multiple faces
    2. Alt + click on Screenshot to run the script

Connect Screenshot#

Various options to connect components.

  1. Connect Line

    How to use
    • Select 2 edges from a ring loop
    • LMB 1 click on Screenshot

    Screenshot

  2. Connect Diamond

    How to use
    • Select a triangle face
    • Alt + click on Screenshot

    Screenshot

  3. Connect Corner

    How to use
    • Select 2 corner edges from a quad polygon face
    • Ctrl click on Screenshot

    Screenshot

  4. Connect End

    How to use
    • Select 3 edges from a quad polygon face
    • Shift click on Screenshot

    Screenshot

Append Plus Screenshot#

Enhanced poly append based on a vertex or edge input.

  1. Append Poly

    How to use
    • Select one vertex in a corner of 2 edges
    • LMB 1 click on Screenshot

    Screenshot

    Caution!

    When a face adjoins the newly created vertex that sits across from the selected vertex, the vertices won't be merged. Please use the Append Bridge operation to create a connecting poly face.

    Screenshot

  2. Append Bridge

    How to use
    • Select a border ring edge
    • LMB 1 click on Screenshot

    Screenshot

  3. Append Ring Loop

    How to use
    • Select two edges within a ring loop
    • Alt + click on Screenshot

    Screenshot

Quad Fill Screenshot#

Automatically fills a polygon hole

Requirements
Edges
  1. The edge count needs to be an even number
  2. Opposite sides need to have the same edge amount

    Screenshot

Enable Track Selection Order
  1. Make sure Track selection order is enabled

    Screenshot

Set Boundary Options
  1. Open the Boundary Options

    Screenshot

  2. Set the settings as below and save them.

    Screenshot

How to use: 1 Corner Edge

Use Case

Quickest solution. Best for caps, planar and cylindrical meshes.

  1. Select 1 corner edge
  2. LMB 1 click on Screenshot
Examples

Plane area

Screenshot

Cylinder cap

Screenshot

Cylindrical mesh with curvature

Screenshot

Tip

If a cylindrical mesh has curvature, choose a corner edge from the side that best defines the curvature

How to use: 2 Corner Edges

Use Case

Essential when two opposing sides have only 2 edges.

  1. Select 2 corner edges
  2. LMB 1 click on Screenshot
Examples

Screenshot

Screenshot

How to use: 3 Edges

Use Case

Essential when the mesh is curved in all directions, but also works with caps, planar etc.

  1. Select 1 corner edge
  2. Select the edge right next to it, to define the direction along the loop
  3. Select 2 corner edge
  4. LMB 1 click on Screenshot
Examples

Mesh with curvature

Screenshot

Spherical

Screenshot

How to use: 4 Corner Edges

Use Case

Use this method for more control over the result. Often helpful with caps or when the corner edges are not as clearly defined.

  1. Select 4 corner edges in a "Z" shape (selection order is important!)
  2. LMB 1 click on Screenshot

Screenshot

Mirror Screenshot#

How to use: Mirror
  1. RMB 2 click Screenshot to open the settings widget

    Screenshot

  2. Check which options you want to apply

    • X-Axis:   LMB 1 click on Screenshot
    • Y-Axis:   Alt + click on Screenshot
    • Z-Axis:   Ctrl click on Screenshot

    To Mirror in World axis:

    Screenshot

  3. To Mirror from Pivot position:

    • Add Shift to Mirror from the current Pivot position

    Screenshot

How to use: Merge Border Vertices
  1. Combine two objects that have overlapping border vertices
  2. Select the combined object
  3. LMB 1 click the Merge Border Vertices button to run the script

Screenshot

Automatic position renaming

Objects and Groups that have L_, R_ or _l_, _r_ position tags in their naming will automatically be renamed when mirrored in the X-Axis.

Groups

Screenshot

Objects

Screenshot

Pivot Position Screenshot#

Set pivot positions based on an objects bounding box.

How to use
  • Center Pivot:   Shift + Alt + Ctrl click on Screenshot

  • X-Min:   LMB 1 click on Screenshot

  • Y-Min:   Alt + click on Screenshot
  • Z-Min:   Ctrl click on Screenshot

Add   Shift   for -Max direction

Screenshot

Component Operations Screenshot#

How to use: Evenly distribute vertices along an edge loop
  1. Select an edge loop
  2.   LMB 1 click on Screenshot

Screenshot

How to use: Straighten an edge loop
  1. Select an edge loop
  2.   Alt + click on Screenshot

Screenshot

Screenshot

How to use: Restore vertex corner point position
  1. First select each vertices pair of the neighbouring edges
  2. Then add the corner vertex
  3.   Ctrl click on Screenshot

Screenshot

How to use: Clean inset
  1. Select faces
  2.   Shift click on Screenshot
  3. Filter Window: Adjust slider that all required corner edges are highlighted

    Manual control

    At this stage it is also possible to add or remove edges manually in the viewport, but make sure they are part of the offset edge loop!

  4. Click Accept

  5. Offset Window: Enter a value or use the PLUS / MINUS buttons to increase or decrease the offset
  6. Click Accept

Screenshot

45 Mesh Angle Screenshot#

Rotate a face selection by 45° from a specified anchor point.

How to use
  1. With face selection:

    • Select one or multiple faces.
    • Switch to multi select mode. (Hold RMB 2 and choose Multi)
    • Add 1 edge, which will be the anchor point.
    • LMB 1 click on Screenshot

      Screenshot

  2. Without face selection:

    • Select a single border edge, which will be the anchor point
    • LMB 1 click on Screenshot

      Screenshot

  3. Choose how to proceed in the option window:

    Screenshot

    • Accept: Proceeds with the result on display.
    • Opposite: Rotates the face selection in the opposite direction.
    • Undo: Returns to the original state.

Instances Screenshot#

Convert instances to objects.

Screenshot

How to use
  1. RMB 2 click Screenshot to open the settings widget
  2. Choose a search scope
  3. If you chose Selection: Select a group or instanced objects
  4. LMB 1 click Screenshot to convert instances to objects
Settings

Screenshot

Randomize Transforms Screenshot#

Randomize object or component transforms.

Screenshot

How to use
  1. RMB 2 click Screenshot to open the settings widget
  2. If you want to affect indivual objects in a combined mesh, check Combined Object Mode
  3. Check what transforms you want to affect and enter range values.
  4. Choose between Relative or Absolute Transform (Relative adds the new value to the existing transform value of the object.)
  5. Choose an Axis
    • X-Axis  :   LMB 1 click Screenshot
    • Y-Axis  :   Alt + click Screenshot
    • Z-Axis  :   Ctrl click Screenshot

Object Space / World Space

  • The default transform will adjust the object in Object Space
  • Add   Shift   for World Space
Settings

Screenshot

Tiny Toolbox Screenshot#

How to use: (Un)Lock nodes and their transforms
  1. Select objects or groups
  2. Lock / Unlock:
    • Lock Nodes  :   LMB 1 click Screenshot
    • Unlock Nodes  :   Shift   click Screenshot
Easily find locked nodes
  • Use the "Select by Type or Status" Screenshot function to easily find locked nodes
How to use: Individually Group Each Object
  1. Select objects
  2.   Alt + click on Screenshot

Screenshot

How to use: Create Locators
  1. Create Locator at Pivot Position
    1. Select Objects and/or Groups
    2. Ctrl   click Screenshot
  2. Create Locator at the Center
    1. Select Objects or Components
    2. Ctrl + Shift   click Screenshot
  3. Create Locator at every selected Component
    1. Select Components
    2. Ctrl + Shift + Alt   click Screenshot

Select#

Interface - Select#

Screenshot

Topology Screenshot#

Analyze mesh geometry and detect invalid polygons.

Screenshot

How to use: Icon Basics
  1. LMB 1 click Screenshot to check for N-Gons (default / not changeable)
  2. Alt + click Screenshot to toggle Poly Count display
  3. RMB 2 click Screenshot to open Settings
  4. Ctrl + click Screenshot to run all checks (output in Script Editor)
How to use: Find Topology Issues
  1. RMB 2 click Screenshot to open the Settings widget
  2. Choose a Topology Type and click the button:
    • Triangles: 3-sided polygons
    • Quads: 4-sided polygons
    • N-Gons: polygons with 5+ sides
    • Non-Manifold: geometry that cannot be unfolded into a flat surface
    • Lamina: faces sharing all their edges
    • Concave: polygons with interior angles > 180°
    • Stars: vertices connected to 5+ edges
    • Holes: gaps in mesh topology
    • Float Verts: isolated vertices with no edge connections
    • Stray Verts: vertices connected to only 2 edges
    • Hard Edges: sharp transitions between faces
    • Border Edges: open mesh boundaries
      • LMB 1 click to find border edges
      • Alt + click to convert the border edges to curves
    • Overlap: geometry occupying identical space
      • LMB 1 click to check Objects: meshes with coincident bounding boxes
      • Alt + click to check Faces: coplanar faces in the same location
    • Intersections: self-intersecting or inter-object geometry conflicts
      • LMB 1 click to find intersections
      • Alt + click to convert the 'RS_Intersection_Collection' to curves
Poly Count / Wireframe on shaded

The Poly Count information and Wireframe on shaded mode are great for extra feedback.

  1. Poly Count:
    1. Find the option under Display > Heads Up Display > Poly Count
    2. or   Alt   click Screenshot to toggle the Poly Count display
  2. Wireframe on shaded:
    1. Go to the viewport menu and click the following icon
    2. Screenshot
Settings

Screenshot

Angle Screenshot#

Grow a polygon face selection based on a set edge normal angle.

Screenshot

How to use
  1. RMB 2 click Screenshot to open the settings widget.
  2. Set an angle value within the settings page.
  3. LMB 1 click Screenshot to run the script.

Tip

Use the slider to interactively change the angle.

Settings

Screenshot

Shortcut

If used as a shortcut through the hotkey editor, the angle value is always 15°.

The angle value and the interactive slider can only be used with and within the tool.

Nth Edge Screenshot#

Selects every nth edge within a Loop, Ring or Border edge.

Screenshot

How to use
  1. RMB 2 click Screenshot to open the settings widget.
  2. Set a selection value.
  3. Loop:   LMB 1 click Screenshot

    Ring:   Alt + click Screenshot

    Border:   Ctrl click Screenshot

Settings

Screenshot

Fill Shell Screenshot#

Temporarily cut a mesh with an edge selection and select one or multiple of the resulting shells.

Screenshot

How to use
  1. Make a loop or any closed edge selection
  2. Click Screenshot to start the process
  3. Choose one or multiple shell(s)
  4. Press Ok in the option window to end the process.

Percentage Screenshot#

Randomly selects a specified percentage from the current object or component selection.

How to use
  1. Select multiple Objects or Components
  2. RMB 2 click Screenshot to open the settings widget.
  3. Specify a percentage value
  4. LMB 1 click on Screenshot to run the script
Settings

Screenshot

Component Count Screenshot#

Find objects that have the same component count as the selected source or specify a poly count range.

How to use
  1. Choose a mode

    A. Based on a source object

    • Select an object (the source)

    B. Based on a value range

    • RMB 2 click Screenshot to open the settings widget
    • Switch On value mode
    • Set a poly count range
    • Specify the search scope
  2. Choose a component type

    • Face - LMB 1 click Screenshot
    • Vertices - Alt + click Screenshot
    • Edges - Ctrl click Screenshot
    • UVs - Shift click Screenshot
Settings

Screenshot

Name Screenshot#

Search and select objects by name or characters.

How to use
  1. RMB 2 click Screenshot to open the settings widget
  2. Choose a search scope
  3. Enter a name or characters into the text field (Wildcards are supported)
  4. LMB 1 click Screenshot to run the script
Settings

Screenshot

Type / Status Screenshot#

Search and select objects by type or their status.

How to use
  1. RMB 2 click Screenshot to open the settings widget
  2. Choose a search scope
  3. Select a type or status to look for
  4. LMB 1 click Screenshot to run the script
Settings

Screenshot

Selection Sets Screenshot#

Save and manage object and component selections.

How to use: Quick Set
  1. Select Components or Objects
  2. Alt   click Screenshot   :   Create a new or overwrite an existing Quick Set
  3. Ctrl   click Screenshot   :   To add further selections to the current Quick Set
  4. LMB 1 click Screenshot   :   Select the Quick Set
How to use: Selection Set List
  1. RMB 2 click Screenshot to open the settings widget
  2. Check "Enable Sets List"
  3. Select Components or Objects
  4. Buttons:
    • Add: Adds the current selection as a Set to the list
    • Save / Load
      • LMB 1 click: Save Sets to a file
      • Alt   click: Load Sets from a file (Overwrites the current list!)
    • Shelf: Creates a shelf button from the current selected list item
  5. List Operations:
    • Delete: Select an item from the list and press   Del   to remove it
    • Rename: Double click a list item to rename it
  6. Select: Select an item from the list and LMB 1 click Screenshot
Toggle between Quick Set and Set List Mode
  1. Shift   click Screenshot to toggle between the modes
Settings

Screenshot

Pattern Screenshot#

Select by component pattern.

Screenshot

How to use
  1. Select 2 components within a ring or loop (Face, Vertex or Edge)
  2. LMB 1 click Screenshot to select further components with the same pattern along the loop

Crease Screenshot#

Select creased edges. Set / Apply a crease value. Output / Print crease value.

How to use: Select all creased edges
  1. Select objects
  2. LMB 1 click Screenshot
How to use: Select creased edges by value or range
  1. Select objects
  2. RMB 2 click Screenshot to open the settings widget
  3. Check Select by Value or Range
  4. Set Min and Max values to define a search range. When both are the same, only edges with that exact value will be selected.
  5. LMB 1 click Screenshot
How to use: Set / Apply Crease
  1. Select edges
  2. RMB 2 click Screenshot to open the settings widget
  3. Check Crease Value (If unchecked, Default value is 2)
  4. Set value
  5. Alt + click Screenshot
How to use: Remove Crease
  1. Select creased edges
  2. RMB 2 click Screenshot to open the settings widget
  3. Check Crease Value (If unchecked, Default value is 2)
  4. Set value
  5. Alt + Shift click Screenshot
How to use: Output / Print Crease value
  1. Select creased edges
  2. Ctrl click Screenshot
  3. Check Script Editor or Command Line for output message
How to use: Open Crease Set Editor
  1. Shift click Screenshot
Settings

Screenshot

Layout#

Interface - Layout#

Screenshot

Place Screenshot#

Place meshes or groups on a target mesh, right under the mouse cursor location.

Screenshot

Before you start

Check the source objects Y-axis orientation and set a desired pivot location (the point where it gets placed on the target mesh) before adding it to the list.

How to use
  1. RMB 2 click Screenshot to open the settings widget
  2. Select objects or groups
  3. Click the Add button to add them to the list
  4. List Operations:
    • Delete: Select an item from the list and press   Del   to remove it
    • Clear List: Click on the Clear button to empty the whole list
  5. Select list items to make them available for placement

    Screenshot

  6. Options:

    • Random Mesh: Check to place the list objects in a random order
    • Instance: Check to place objects as instances
    • Random Rotation: Check to add random rotation upon placement
    • Random Scale: Check to add random scaling upon placement
  7. LMB 1 click Screenshot to start
Settings

Screenshot

Paint Screenshot#

Paint meshes or groups on a target mesh.

Screenshot

Before you start

Check the source objects Y-axis orientation and set a desired pivot location (the point where it gets placed on the target mesh) before adding it to the list.

How to use
  1. RMB 2 click Screenshot to open the settings widget
  2. Select objects or groups
  3. Click the Add button to add them to the list
  4. List Operations:
    • Delete: Select an item from the list and press   Del   to remove it
    • Clear List: Click on the Clear button to empty the whole list
  5. Select list items to make them available for placement

    Screenshot

  6. Options:

    • Random: Check to place the objects in a random order
    • Instance: Check to place iobjects as instances
    • Time: Change the value to control the paint density
      • Lower value (Min: 0.01) = faster placement
      • Higher value (Max: 0.20) = slower placement
    • Random Rotation: Check to add random rotation upon placement
    • Random Scale: Check to add random scaling upon placement
  7. LMB 1 click Screenshot to start
Settings

Screenshot

Distribute Screenshot#

Distribute overlapping objects or groups based on their bounding box or a value.

Screenshot

How to use
  1. RMB 2 click Screenshot to open the settings widget
    • Select a distribution mode, based on their Bounding Box (BBox) or by Value
    • Option to add Spacing between the objects
    • Enter a Move value for Value mode
  2. Select 2 or more overlapping objects or groups
  3. Choose an Axis
    • X-Axis  :   LMB 1 click Screenshot
    • Y-Axis  :   Alt + click Screenshot
    • Z-Axis  :   Ctrl click Screenshot
    • Add   Shift   for negative direction
Settings

Screenshot

Duplicator Screenshot#

Distribute object or group duplicates based on their bounding box or a value.

Screenshot

How to use:
  1. RMB 2 click Screenshot to open the settings widget
  2. Options:
    • Gizmo Directions: Check to move duplicates in the objects Manipulator direction (Only works with objects)
    • Instance: Check to duplicate instances
  3. Move by settings:
    • Select a duplicator mode, based on their Bounding Box or by Value
    • Specify the amount of copies
    • Option to add Spacing between the objects
    • Enter a Move value for Value mode
  4. Select an object or a group
  5. Choose Axis:
    1. X-Axis   -   LMB 1 click Screenshot
    2. Y-Axis   -   Alt + click Screenshot
    3. Z-Axis   -   Ctrl click Screenshot
    4. Add   Shift   for negative direction
Settings

Screenshot

Snap Screenshot#

Snap objects or groups to selected components.

Screenshot

Before you start

Check the source objects Y-axis orientation and set a desired pivot location (the point where it gets placed on the target mesh) before adding it to the list.

How to use: Snap
  1. RMB 2 click Screenshot to open the settings widget
  2. Select objects or groups
  3. Click the Add button to add them to the list
  4. List Operations:
    • Delete: Select an item from the list and press   Del   to remove it
    • Clear List: Click on the Clear button to empty the whole list
  5. Select list items to make them available for placement

    Screenshot

  6. Options:

    • Random: Check to snap the objects in a random order
    • Instance: Check to snap instanced objects
  7. Select components
  8. LMB 1 click Screenshot to snap
Constraints

This function creates constraints and doesn't delete them right away to maintain interactive control. To automatically remove the constraints, please read the "How to use: Delete pointOnPolyConstraints" section below.

Snap Groups

When you snap groups this function creates additional constraints and locators (which will be parented under a group called "BUKI_SNAP_LOCATORS_grp"). Please don't modify the group or the locators within for the script to work properly. To automatically remove the constraints and the locators, please read the "How to use: Delete Group Constraints and Locators" section below.

How to use: Delete pointOnPolyConstraints
  1. RMB 2 click Screenshot to open the settings widget
  2. Choose a search scope in the settings under "Delete Constraints"
  3. If you chose Selection, select objects with constraints
  4. Alt   click Screenshot to start the process
How to use: Delete Group Constraints and Locators
  1. Ctrl   click Screenshot to start the process

This cleanup ignores your selected search scope in the settings and affects the whole scene

Settings

Screenshot

Radial Screenshot#

Duplicate objects or groups in a radial fashion.

Screenshot

Before you start: Anchor point

Set your anchor point by adjusting the object or group pivot.

How to use
  1. RMB 2 click Screenshot to open the settings widget
  2. Set anchor point: Adjust your object or group pivot
  3. Select object or group
    • X-Axis  :   LMB 1 click Screenshot
    • Y-Axis  :   Alt + click Screenshot
    • Z-Axis  :   Ctrl click Screenshot

    Choose an Axis

    Toggle rotation direction

    Add   Shift   to toggle between positive and negative rotation direction within the chosen axis

  4. Tweak options:

    • Copies: Amount of duplicates
    • Rotation: Specifies how much the duplicates will be rotated by (negative value will rotate in opposite direction)
    • Instance: Converts duplicates to Instances
    • Distribute Evenly: Distributes the duplicates evenly within a circle
  5. Wrap up the process:

    • Done Button:
      • LMB 1 click - Finish process and maintain current settings
      • Alt   click - Finish process and reset all settings
    • Cancel Button:
      • LMB 1 click - Cancel process but maintain current settings
      • Alt   click - Cancel process and reset all settings

    The Instance Checkbox is always going to reset to it's default state.

Wrap up!

Don't forget to click Done or Cancel when you finished to tweak the settings.

Live Object Axis and Bake

If you rotate an object it's Live Object Axis changes, while the rotation axis looks correct - This leads to unexpected radial duplications. Display the Live Object Axis, adjust the pivot to correct the axis and bake the new orientation.

Screenshot

Display Live Object Axis
  1. Select the object
  2. Hold Ctrl + Alt + RMB 2 to open the Marking Menu
  3. Go to Axis >
  4. Choose Live Object Axis
How to bake a pivot
  1. Go to the Modify tab in Maya's main menu
  2. Under the Pivot separator line click on Bake Pivot
Settings

Screenshot

Import / Export#

Interface - Import / Export#

Screenshot

Import#

Import .obj files

Import .obj files as a combined mesh, separated meshes or as Blendshapes.

Load the objExport plugin
  • Go to Windows > Settings/Preferences > Plug-in Manager
  • Search for objExport.mll
  • Check Loaded and Auto load

How to use

  1. RMB 2 click Screenshot to open the settings widget
    • Choose an import mode
  2. When the Import mode is set to As blendshapes, select a base mesh
  3. LMB 1 click Screenshot
  4. Navigate to the file location and select files to import

Settings

Screenshot

Import .fbx files
Load the fbxmaya plugin
  • Go to Windows > Settings/Preferences > Plug-in Manager
  • Search for fbxmaya.mll
  • Check Loaded and Auto load

How to use

  1. LMB 1 click Screenshot
  2. Navigate to the file location and select files to import
Import .abc files
Load the AbcImport plugin
  • Go to Windows > Settings/Preferences > Plug-in Manager
  • Search for AbcImport.mll
  • Check Loaded and Auto load

How to use

  1. LMB 1 click Screenshot
  2. Navigate to the file location and select files to import
Import .ma or .mb files

How to use

  1. Import:
    • .ma files  : LMB 1 click Screenshot
    • .mb files   :   Alt   click Screenshot
  2. Navigate to the file location and select files to import

Export#

Export .obj files
Load the objExport plugin
  • Go to Windows > Settings/Preferences > Plug-in Manager
  • Search for objExport.mll
  • Check Loaded and Auto load

How to use

  1. RMB 2 click Screenshot to open the settings widget
    • Choose an export mode
    • Set the preferred options to On or Off
  2. Select objects to export
    • When the Export mode is set to As blendshapes, select objects that have blendshapes
  3. LMB 1 click Screenshot
  4. Navigate to the save location
    • When the Export mode is set to Combined, enter a file name

Settings

Screenshot

Export .fbx files
Load the fbxmaya plugin
  • Go to Windows > Settings/Preferences > Plug-in Manager
  • Search for fbxmaya.mll
  • Check Loaded and Auto load

How to use

  1. RMB 2 click Screenshot to open the settings widget
    • Choose an export mode
  2. Select objects to export
  3. LMB 1 click Screenshot
  4. Navigate to the save location
    • When the Export mode is set to Single file, enter a file name

Settings

Screenshot

Export .abc files
Load the AbcExport plugin
  • Go to Windows > Settings/Preferences > Plug-in Manager
  • Search for AbcExport.mll
  • Check Loaded and Auto load

How to use

  1. RMB 2 click Screenshot to open the settings widget
    • Choose an export mode
    • When objects are animated, set Start and End values for the time slider.
      When not, leave the default values.
  2. Select objects to export
  3. LMB 1 click Screenshot
  4. Navigate to the save location
    • When the Export mode is set to Single file, enter a file name

Settings

Screenshot

Export .ma or .mb files

How to use

  1. RMB 2 click Screenshot to open the settings widget
    • Choose an export mode
  2. Select objects to export
  3. Export:
    • .ma files  : LMB 1 click Screenshot
    • .mb files   :   Alt   click Screenshot
  4. Navigate to the save location
    • When the Export mode is set to Single file, enter a file name

Settings

Screenshot

Utilities#

Obj fix

Clean up a mesh by exporting and immediately re-importing the mesh as an obj.

How to use

  1. RMB 2 click Screenshot to open the settings widget
    • LMB 1 click on the "..." button and specify a save path

    Set Save path

    Set as default path

      Alt   click on the "..." button if you want to set the current path as the default path upon startup

  2. Reassign Shader: Check the box if you want the the script to reassign the current Shader when the mesh gets re-imported

  3. Select objects
  4. LMB 1 click Screenshot to start the process

Settings

Screenshot

Curve Tools#

Interface - Curve Tools#

Screenshot

Rebuild Screenshot#

Rebuild curves based on their length.

How to use
  1. RMB 2 click Screenshot to open the settings widget
  2. Enter a division value
  3. Select curves
  4. LMB 1 click Screenshot to start the process
Analysis
  • Works in conjunction with the Analysis Screenshot tool to determine the division value
  • Select all your curves and get the length of the shortest curve (See Analysis section)
Open Maya's Rebuild Tool

Alt   click Screenshot

Settings

Screenshot

Pivot To Origin Screenshot#

Sets the pivot to the curve origin.

Screenshot

How to use
  1. Select curves
  2. LMB 1 click Screenshot to start the process

Snap To Surface Screenshot#

Snaps the curve origin to the closest point on a specified surface.

Screenshot

How to use
  1. First select curves
  2. Then Shift select the surface
  3. LMB 1 click Screenshot to start the process

Change Direction Screenshot#

Reverse or equalize curve directions.

How to use: Reverse
  1. Select curves
  2. LMB 1 click Screenshot to start the process
How to use: Equalize Directions
  1. First select the curve with the correct direction
  2. Then   Shift   select all other curves
  3. Alt   click Screenshot to start the process

Point Range Screenshot#

Select a specific point range on one or multiple curves at once.

Screenshot

Range Limit

When the range is higher than the curves point amount, the curve will be ignored.

How to use
  1. RMB 2 click Screenshot to open the settings widget
  2. Enter a Range
  3. Select curves
  4. LMB 1 click Screenshot to start the process
Settings

Screenshot

Convert Edges Screenshot#

Convert selected edges to curves.

Screenshot

How to use
  1. Select edges
  2. Convert:
    • Curve Degree 3: LMB 1 click Screenshot
    • Curve Degree 1: Alt   click Screenshot

Create Center Curve Screenshot#

Generate an objects center curve from edge loops (cables, cylinders, etc.)

Screenshot

How to use
  1. Select an object (cables, cylinders, etc.)
  2. Select an edge loop that runs across the mesh
  3. LMB 1 click Screenshot

Attention

For best results, use objects without caps. If necessary, create a duplicate and adjust the temporary mesh for curve generation.

Analysis Screenshot#

Inspect curve attributes.

How to use
  1. RMB 2 click Screenshot to open the settings widget
  2. Select a single curve and LMB 1 click Screenshot to get the
    • Length of the curve
    • CV count
    • Span count
    • Degree count
  3. Select multiple curves and LMB 1 click Screenshot to get the
    • Shortest curve
    • Longest curve

Additional Operations

  • Alt   click Screenshot   : Select Shortest Curve
  • Ctrl   click Screenshot   : Select Longest Curve
  • Shift   click Screenshot   : Reset Textfields
Settings

Screenshot

Extruder Screenshot#

Convert curves to geometry.

How to use: Sweep Presets
  1. Select curves
  2. Convert to geometry: - Cable: LMB 1 click Screenshot

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    ![Screenshot](images/BuildKit/curve_tools_extruder_cable.gif)
    
    - **Rope**: &nbsp; <kbd>Alt</kbd> &nbsp; click ![Screenshot](images/BuildKit/tool_icons/icon_curve_extruder.png)
    
    ![Screenshot](images/BuildKit/curve_tools_extruder_rope.gif)
    
    - **Pipe**: &nbsp; <kbd>Ctrl</kbd> &nbsp; click ![Screenshot](images/BuildKit/tool_icons/icon_curve_extruder.png)
    
    ![Screenshot](images/BuildKit/curve_tools_extruder_pipe.gif)
    
    - **Box**: &nbsp; <kbd>Shift</kbd> &nbsp; click ![Screenshot](images/BuildKit/tool_icons/icon_curve_extruder.png)
    
    ![Screenshot](images/BuildKit/curve_tools_extruder_box.gif)
    
  3. Click on the mesh and use the Sweep Mesh Creator within Maya's Attribute Editor to tweak the result:

    1
    ![Screenshot](images/BuildKit/curve_tools_extruder_sweep_mesh_creator.png)
    
How to use: Legacy Cable
Before you start

Use the Rebuild Screenshot function to recreate the curve with a good amount of and evenly distributed vertexes.

  1. RMB 2 click Screenshot to open the settings widget
  2. Tweak available options: - Sections - Radius - Taper
  3. Select curves
  4. Convert to geometry:   Ctrl   +   Alt   click Screenshot

    1
    ![Screenshot](images/BuildKit/curve_tools_extruder_2020_below.gif)
    
Settings

Screenshot

Distribute Along Curve Screenshot#

Interactive object distribution along curves

Screenshot

How to use
  1. RMB 2 click Screenshot to open Settings
  2. Select a curve and one object to duplicate along it
  3. LMB 1 click Screenshot
  4. Adjust Settings as needed
  5. Finish the operation:
    • Done - complete the operation
      • LMB 1 click: finish and keep settings
      • Alt + click: finish and reset settings
    • Cancel - abort the operation
      • LMB 1 click: cancel and keep settings
      • Alt + click: cancel and reset settings
How to use: Scale
  1. Enable Scale in Settings
  2. Set Min Value (left field) and Max Value (right field)
  3. Choose a Mode:
    • All: scales all objects equally using Min Value only
    • Rnd: randomly scales objects between Min and Max values
    • Taper: gradually scales objects from Min to Max along the curve
      • Alt + click Taper to swap Min/Max values
How to use: Rotation
  1. Enable Rotate in Settings
  2. Set Min Value (left field) and Max Value (right field)
  3. Choose Axis
  4. Choose a Mode:
    • All: rotates all objects equally using Min Value only
    • Rnd: randomly rotates objects between Min and Max values
    • Twist: gradually rotates objects from Min to Max along the curve
      • Alt + click Twist to swap Min/Max values

Attention

Ensure the geometry is at the origin with its transforms frozen.

Footnotes#