addTint

addTint is a Blockbench plugin for Minecraft Java models. It lets you set tintindex values on model faces and preview the tinted result directly in Blockbench.

The plugin writes standard Minecraft Java model data. Preview colors are stored only in Blockbench editor settings and are not exported into your model JSON.

Features

• Set any non-negative tintindex on selected cube faces
• Remove tint indices from selected faces
• Preview each tint index with a custom color in the 3D viewport
• Edit all tint preview colors used by the current model in one dialog
• Convert only the selected face UV areas to tint-friendly grayscale
• Use the left sidebar panel, UV Editor context menu, or Filter menu
• Undo and redo support
• English and Japanese UI, following your Blockbench language setting

Installation

1. Open Blockbench.

2. Go to File > Plugins....

3. Choose Load Plugin from URL.

4. Paste this URL:

   https://github.com/YOHEMAL/addTint/releases/latest/download/add_tint.js
   

   

5. Confirm the installation.

After installation, open a Minecraft Java Block/Item model. The addTint panel appears in the left sidebar when the plugin is available for the current model.

This URL points to the latest GitHub release asset, so you do not need to download a new file manually when addTint is updated.

Basic Usage

1. Open a Minecraft Java Block/Item model in Blockbench.
2. Select a cube.
3. Select one or more faces in the UV Editor.
4. In the left sidebar, use the addTint panel.
5. Set a Tint Index and preview color.

You can also use Filter > addTint: Set Tint Index from the top menu.

addTint Panel

The sidebar panel gives direct access to the main tools:

• Tint Index: set a tint index on the selected faces
• Preview Colors: edit the preview colors for tint indices used by the current model
• Grayscale Texture: convert selected UV areas to grayscale for better tinting

The panel shows the current face selection and tint state. Tools that cannot be used with the current selection are hidden.

UV Editor Context Menu

Select faces in the UV Editor, then right-click and open addTint: Tint Index.

From this menu you can:

• Apply a tint index already used in the model
• Choose Specify Index... to enter any index
• Choose Remove Tint to clear the tint from selected faces
• Open Edit Preview Colors...

Preview Colors

Use Filter > addTint: Edit Preview Colors or the Preview Colors button in the panel.

Each color picker updates the 3D viewport in real time. Confirming the dialog saves the preview colors in Blockbench. Canceling restores the colors from before the dialog was opened.

Preview colors are only for editing. Minecraft resource packs decide the actual in-game tint color.

Grayscale Tint Textures

Tinted Minecraft textures usually work best when the tinted area is grayscale.

To prepare a texture:

1. Select the faces you want to tint in the UV Editor.
2. Run Filter > addTint: Grayscale Tint Textures, or use Grayscale Texture in the panel.
3. Confirm the listed textures.

Only the UV areas used by the selected faces are converted. Alpha is preserved, brightness is preserved, and areas outside the selection stay unchanged.

Export Behavior

addTint uses Minecraft Java's standard tintindex property on model faces.

Example:

{
  "faces": {
    "north": {
      "texture": "#layer0",
      "tintindex": 0
    }
  }
}

The plugin does not add preview colors or custom metadata to the exported Minecraft model JSON.

Requirements

• Blockbench 5.0.0 or later
• Minecraft Java Block/Item model format