# Bbrush

**Repository Path**: AIGODLIKE/Bbrush

## Basic Information

- **Project Name**: Bbrush
- **Description**: 这是一个模拟类似ZBrush雕刻方式的Blender插件

- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 2
- **Created**: 2023-03-28
- **Last Updated**: 2025-10-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Bbrush

"No More Compromises—Built for Tablet Artists"

This is an addon for Blender that simulates the way ZBrush sculpts.

Also can display silhouette, much convenient for tablets.


![981b5107_9588511](https://github.com/user-attachments/assets/f02b0b50-e4ad-4e7b-9817-fec10ade2e6a)


![screenshot-20250516-154529](https://github.com/user-attachments/assets/cd966ef1-4884-42ee-949d-745725566a3f)




## Start

1. Select a mesh object to enter sculpt mode

2. Enter BBrush Sculpting mode（It can be automatically turned on with the sculpt mode in the preference settings）

![image](https://github.com/user-attachments/assets/9ae969f5-ca73-44f2-afff-8f63cf16d3df)

3.Display shortcut keys
![image](https://github.com/user-attachments/assets/50ed0789-c865-4fad-a463-a6956534d0eb)


## Features

### Silhouette

When enable the silhouette, you can modify it in preferences or at the tool settings.

#### Display mode

- **Always**: Keep silhouette on toop even not in sculpt mode
- **Only Sculpt**: Display in sculpt mode
- **Only Bbrush**: Display in Bbrush mode
- **Disable**: Don't display

#### Scale

![c275d79d_9588511](https://github.com/user-attachments/assets/3485e5d1-ce2f-4214-9483-db4c2d65b9aa)


### Bbrush mode

When enter sculpt mode, top bar will have a Bbrush mode button.
Bbrush mode has many shorcuts:
#### Normal Mode.
Shows frequently used brushes

    View Manipulation
        Panning ALT+Right or ALT+Center
        Panning ALT+Left Drag on blank space
        Panning view SHIFT+Middle key
        Rotate view Right click
        Rotate view Left-click Drag in blank area
        Zoom View CTRL+Middle or CTRL+Right
        Skew View SHIFT+Left Drag in empty space
    Sculpting
        Sculpt Left click Draw on the model
        Reverse Sculpt ALT+Left click Draw on model
        Smooth SHIFT+Left click Draw on model
    Other
        Toggle engraved objects ALT+Left click on other models

#### Mask mode (Ctrl or Ctrl Alt).
When in mask mode, the brush will be switched to a mask brush.

![screenshot-20250516-134302](https://github.com/user-attachments/assets/393043a5-64d0-47e0-a5f8-8ed8d15463e0)

    Draw Mask CTRL+Left click to draw on the model.
    Erase Mask CTRL+ALT+Left to draw on the model.
    Invert Mask CTRL+Left Click on blank area
    Frame Mask CTRL+Left click Drag from blank area to model
    Box Erase Mask CTRL+ALT+left click Drag from blank area to model
    Fade Mask CTRL+left click on model
    Clear Mask CTRL+Left click Draw box on blank area
    Sharpen Mask CTRL+ALT+left click on model
    Fill Mask CTRL+ALT+Left Click to draw a box in a blank area.
    Growth Mask CTRL+Keypad+Sign Click
    Shrink Mask CTRL+Keypad - Sign Click
    Increase Mask Contrast CTRL+Up Arrow or CTRL+Keypad* Click
    Decrease Mask Contrast CTRL+Down Arrow or CTRL+Keypad/ Click

#### Hidden Mode.
Brushes will switch to hidden mode.

    Hide Outside Paint Box CTRL+SHIFT+Left click Paint on Model
    Inside the hidden drawing box CTRL+SHIFT+ALT+Left click Draw on the model.
    Unhide CTRL+SHIFT+Left click in blank area (will not work if you add multi-level subdivision modifier, this is Bl's own problem)
    Reverse hide CTRL+SHIFT+Left click or CTRL+SHIFT+ALT+Left click Draw on the blank area.

## Notice

- Switch hidden faces will cause multiresolution disabled
- Blender 3.0 + smooth brushes + invert sculpt = crash