Skip to content

Build Kit v1.0#

Installation#

Compatibility#

Maya 2017 2018 2019 2020

How to install#

  1. Extract the RS_assets folder from the RS_assets.zip.

  2. Copy RS_Build_Kit.pyc or RS_Build_Kit.py and the RS_assets folder to :

    Windows

    1
    \Users\USERNAME\Documents\maya\MAYAVERSION\prefs\scripts
    

    Linux

    1
    $HOME/maya/MAYAVERSION/prefs/scripts
    

    Mac

    1
    $HOME/Library/Preferences/Autodesk/maya/MAYAVERSION/prefs/scripts
    
  3. Launch / Restart Maya

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

    1
    2
    3
    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, leave out the code below.

    1
    reload(RS_Build_Kit)
    

Interface Basics#

Tool Menu#

Screenshot   Mesh / Selection / Layout tools

Screenshot   Import / Export tools

Screenshot   About / Links / Shortcuts

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

Collapse

Alt   click on 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   -   Edit Mesh Page

2   -   Import / Export Page

3   -   About Page

4   -   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 Edit Mesh Page

  Alt   +   1   to collapse all tabs on the Edit Mesh Page

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

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

Attention

This only works on the currently active page.

Minimize to main menu

 Alt   +   4 to minimize the tool

Screenshot

About Page#

Access the About page by clicking on Screenshot

The page contains information about the tool, several web links and an option to set up hotkey shortcuts.

Interface - About Page#

Screenshot

Create Hotkey Shortcuts#

Click on the Create Hotkey Shortcuts button to make multiple functions available within Maya's hotkey editor.

Screenshot

Info

Access the Hotkey Editor under Windows > Settings/Preferences > Hotkey Editor

Edit Mesh#

Interface - Edit Mesh#

Screenshot

Extract#

Advanced Extract operation

  • Clean history (without empty groups)
  • Keeps mesh name and adds an _Ext# suffix
  • Remains under parent
  • Centers pivot

Screenshot

How to use

  1. Select one or multiple faces
  2. Click on Screenshot to run the script

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

Screenshot

How to use

  1. Select one or multiple faces
  2. Click on Screenshot to run the script

Connect#

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#

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

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 of the first selected object (See RMB 2 Settings)

  • 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. Click on Screenshot to run the script

Settings

Screenshot

Separate#

Advanced Separate operation

  • Clean history (without empty groups)

  • Keeps mesh name and adds a _Sep# suffix

  • Stays under current parent

  • Centers pivots

Screenshot

How to use

  1. Select 1 or more combined objects

  2. Click on Screenshot to run the script

Mirror#

  1. Mirror - World

    How to use

    • X-Axis:   LMB 1 click on Screenshot

    • Y-Axis:   Alt click on Screenshot

    • Z-Axis:   Ctrl click on Screenshot

    Screenshot

    Automatic prefix renaming

    Objects / Groups that have L_ or R_ prefixes
    will automatically be renamed when mirrored in the X-Axis.

    Examples

    Groups

    Screenshot

    Objects

    Screenshot

  2. Mirror - Pivot

    How to use

    • Add Shift to Mirror from the current Pivot position

    Screenshot

Attention

None of these mirror operations will merge vertices.

Pivot Position#

Set pivot positions based on an objects bounding box.

How to use

Add Shift for opposite directions

Bottom:   LMB 1 click on Screenshot

Top:   Shift + LMB 1 click on Screenshot

Screenshot

Front:   Alt click on Screenshot

Back:   Shift + Alt click on Screenshot

Screenshot

Right:   Ctrl click on Screenshot

Left:   Shift + Ctrl click on Screenshot

Screenshot

Center:   Shift + Alt + Ctrl click on Screenshot

Groups#

Group objects
  • Group all or each object individually
  • Automatically adds a "_grp" suffix

How to use

Add all objects to one group:   LMB 1 click on Screenshot

Screenshot

Add each object to an individual group:   Alt click on Screenshot

Screenshot

Quad Fill#

Automatically fills a grid polygon hole with an equal edge side count.

Requirements
  1. Make sure that Track selection order is enabled" Screenshot

  2. Opposite sides need to have the same edge amount

How to use

Select the 4 corner edges in a "Z" shape order

Screenshot

LMB 1 click on Screenshot

Tip

If a mesh has curvature choose edges from the sides that best define the curvature

Examples

Plane area

Screenshot

Cylinder cap

Screenshot

Cylinder side with curvature

Screenshot

45 Mesh Angle#

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

How to use

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

    Screenshot

  5. Choose how to proceed in the option window.

    Screenshot

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

Select#

Interface - Select#

Screenshot

Topology#

Analyze a mesh and find invalid polygon geometry.

Screenshot

How to use

  1. RMB 2 click Screenshot to open the settings widget.
  2. Choose a geometry type from the settings page.
  3. LMB 1 click Screenshot to run the script.

Tip

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

Find the Poly Count display option under Display > Heads Up Display > Poly Count

or Alt click Screenshot to toggle the Poly Count display.

Settings

Screenshot

  • Triangles (polygon with 3 sides)
  • Quads (polygon with 4 sides)
  • N-Gons (polygons with more than 4 sides)
  • Concave (a polygon with one or more interior angles greater than 180°)
  • Lamina (faces sharing all edges)
  • Holes
  • Non-Manifold (geometry that cannot be unfolded)

Angle#

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

Attention

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#

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#

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#

Randomly selects a specified percentage from the current object selection.

How to use

  1. Select multiple Objects
  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#

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#

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
  4. LMB 1 click Screenshot to run the script

Settings

Screenshot

Type#

Search and select objects by type.

How to use

  1. RMB 2 click Screenshot to open the settings widget
  2. Choose a search scope
  3. Select a type
  4. LMB 1 click Screenshot to run the script

Settings

Screenshot

Layout#

Interface - Layout#

Screenshot

Place#

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

Screenshot

How to use

  1. RMB 2 click Screenshot to open the settings widget
  2. Add one or multiple objects to the list
    1. Use Del to remove items
    2. Click on Clear to empty the whole list
  3. Select list items to make them available for placement

    Screenshot

  4. Check Random to place the objects in a random order

  5. LMB 1 click Screenshot to run the script

Tip

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.

Settings

Screenshot

Paint#

Paint source meshes on a target mesh.

Screenshot

How to use

  1. RMB 2 click Screenshot to open the settings widget
  2. Add one or multiple objects to the list
    1. Use Del to remove items
    2. Click on Clear to empty the whole list
  3. Select list items to make them available for paint placement

    Screenshot

  4. Change the time value to control the paint density.
    Lower value (Min: 0.01) = faster placement.
    Higher value (Max: 0.20) = slower placement.

  5. Check Random to place the objects in a random order
  6. LMB 1 click Screenshot to run the script

Tip

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.

Settings

Screenshot

Distribute#

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
    1. Select a distribution mode, based on their Bounding Box (BBox) or by Value
    2. Option to add Spacing between the objects
    3. Enter a Move value for Value mode
  2. Select 2+ overlapping objects or groups
  3. Choose an 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

Duplicator#

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
    1. Option to duplicate in the objects Manipulator direction (Only works with objects)
    2. Select a duplicator mode, based on their Bounding Box or by Value
    3. Option to add Spacing between the objects
    4. Enter a Move value for Value mode
  2. Select an object or a group
  3. Choose an 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

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
    1. Choose an import mode
  2. When the Import mode is set to As blendshapes, select a base mesh
  3. LMB 1 click Screenshot to run the script
  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 to run the script
  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 to run the script
  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
    1. Choose an export mode
    2. Set the preferred options to On or Off
  2. Select objects to export
    1. When the Export mode is set to As blendshapes, select objects that have blendshapes
  3. LMB 1 click Screenshot to run the script
  4. Navigate to the save location
    1. 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
    1. Choose an export mode
  2. Select objects to export
  3. LMB 1 click Screenshot to run the script
  4. Navigate to the save location
    1. 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
    1. Choose an export mode
    2. 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 to run the script
  4. Navigate to the save location
    1. When the Export mode is set to Single file, enter a file name

Settings

Screenshot