Skip to content

mozi1924/rig2_addons

Repository files navigation

Rig2 Banner

Rig/2 Ecosystem — Addons

Rig/2 Blender Add-on Ecosystem: Facial Capture · GeckoLib Animation Export · Mine-imator Action Import

Official Website · mi2bl


Overview

Rig2 Addons is the official extension suite for Rig/2—the ultimate Minecraft character rigging solution for Blender.

The core Rig/2 assets file delivers a zero-dependency rigging experience featuring: an AIO "Super Shader," multi-dimensional limb systems (Steve & Alex), a 1:1 decoupled control panel, body shaping tools, and one-click switching between three foot modes. Simply append and use—no extra plugins required.

Rig2 Addons unlocks the full creative pipeline for Pro users, extending the Minecraft animation workflow from initial rigging to facial motion capture, middleware integration, and cross-platform export.


Core Features

🎭 Facial Capture — Face Cap

Real-time facial motion capture integration supporting two major protocols:

  • LiveLinkFace (UDP) — Directly receives 52-channel blendshape data streams from an iPhone running the Live Link Face app; supports zero-configuration Wi-Fi connectivity.
  • Custom WebSocket — Supports JSON/Binary encoding, suitable for custom motion capture hardware or third-party software pipelines.

Supports multiple rig bindings, with independent Face Index configuration for each. Head rotation data and blendshape data are processed separately, allowing for independent adjustment of intensity coefficients.

🎬 GeckoLib Animation Export — R2BB (Rig2 to Blockbench)

Export Rig/2 skeletal animations with a single click into the GeckoLib-compatible .animation.json format, ready for direct use in Minecraft resource packs or for previewing in Blockbench.

  • Built-in bone mapping presets (Default, March, etc.) that automatically map Rig2 FK bones to the Mine-imator naming convention
  • Support for custom mapping presets (save/load functionality)
  • Independent control over axis sign inversion for rotation, translation, and scaling for each bone
  • Automatic keyframe deduplication and normalization during animation export; outputs standard GeckoLib format_version: 1.8.0 format
  • Precise conversion of animation duration and keyframe timelines

🏗️ Mine-imator Animation Import — MIFrames

Use the mi2bl add-on to import .miframes / .miobject animation files from the Mine-imator ecosystem onto Rig/2 bones:

  • Automatically bake MI bone hierarchies into Rig2 FK bone keyframes
  • Supports various MI model configurations
  • Imported animations integrate seamlessly with Blender's native Action system, allowing for further editing

Version Comparison

Feature Open Edition
Rig/2 Core Rigging
AIO Super Shader
Multi-dimensional Limbs (Steve & Alex)
Three Foot Modes
Body Shaping
1:1 Control Panel
Face Capture (Face Cap)
Advanced Facial Expression System (52 Blendshapes)
MIFrames Animation Import (.miframes)
R2BB GeckoLib Export (.animation.json)

Quick Start

Installation

  1. Download the Rig2 Addons .zip package (available to Pro users after purchase)
  2. Open Blender 4.5+, go to Edit → Preferences → Add-ons
  3. Click the in the top-right corner → Install from file, and select the downloaded .zip package
  4. Search for Rig2 and check the box to enable it

Adding the Rig/2 Armature

After installing the add-on, press Shift + A → Rig/2 in the 3D Viewport to add the Rig/2 armature to the scene.

Using Facial Capture

  1. Locate the Face Cap panel in the Properties panel.
  2. Select a protocol: LiveLinkFace (default UDP port 11111) or WebSocket.
  3. Bind the target Rig bones.
  4. Open the Live Link Face app on your iPhone and enter your computer's IP address and port.

Exporting GeckoLib Animations

  1. Configure bone mapping in the R2BB section of the Properties panel (built-in presets are available).
  2. Select the Action to export.
  3. Click Export and choose a save path.

Importing MI Actions

  1. Ensure the mi2bl add-on is installed.
  2. Select the Rig/2 armature.
  3. Click Load .miframes and select the .miframes file.

Technical Stack

  • Blender 4.5+ Python API
  • Native C++ Extensions: Performance-critical modules (facial capture data parsing, action mapping, license verification) are written in C++ and distributed as CPython ABI3 binaries for Windows, macOS, and Linux.
  • Multi-language Support: Built-in English and Simplified Chinese interfaces.

Related Links


Asset files (Rig/2 Blend) are licensed under CC BY-NC-SA 4.0
Copyright © 2026 mozi1924. All rights reserved.

About

The BEST Blender Minecraft Rig addons mozi ever made

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors