Figura - Complete Character Customization in Minecraft

Discover limitless possibilities for personalizing your game character with the Figura mod! This client-side mod for Minecraft Java Edition allows you to completely transform your avatar's appearance, while other players will see all changes without needing to install any mods on the server.

Powerful Creative Tools

Figura provides full access to modeling and animation tools. You can create unique character models, customize every detail of appearance, and add complex animations. The mod fully unlocks the potential of the popular Blockbench editor, allowing you to import models and animations created there.

Programmable Capabilities

For those who want more, Figura offers a full Lua API. Create your own scripts to control your avatar's behavior, add interactive elements, and implement complex logic chains. The possibilities are limited only by your imagination!

Flexible Permission System

Figura includes a well-designed access management system. You can control which elements of your avatar are visible to other players, adjust transparency levels, and regulate the sizes of individual model parts.

Additional Features

The mod also offers numerous additional capabilities for enhancing gameplay, including a convenient action wheel and special visual effects.

Compatibility

Figura works on all popular mod loaders: Fabric, Forge, and Quilt. The mod is completely client-side and doesn't require server installation.

Frequently Asked Questions

Avatars don't appear in the Figura list, even though they're in the correct folder

Make sure the avatar folder contains an "avatar.json" file (check file extensions). This file can be empty, but it must be present for avatar recognition.

How to hide the vanilla character model

Add at the beginning of your script: • To hide everything (player, armor, elytra, held items):

vanilla_model.ALL:setVisible(false)

• To hide only the player:

vanilla_model.PLAYER:setVisible(false)

• To hide only armor:

vanilla_model.ARMOR:setVisible(false)

• To hide other or specific parts, check the in-game documentation

How to play a Blockbench animation

Simply add this code to your script:

animations.modelName.animationName:play()

Where: "animations" - global table containing all animations "modelName" - name of the model from which the animation is taken "animationName" - animation name

What are Pings and how to use them

Pings are Lua functions that execute for everyone using your avatar's script. They are sent from the host player and can be used to synchronize key presses or action wheel actions. Creating a ping:

function pings.myPing(arg1, arg2)
  -- code that executes when ping is called
end

Calling a ping:

pings.myPing("Hello", "World")

Pings have content, size, and frequency limitations

How to add an emissive texture

Name the texture the same as the non-emissive one, but add _e at the end. Ensure areas that shouldn't glow have transparent black color (#00000000) for shader compatibility.

Emissive textures don't work with Iris/OptiFine shaders

Some shaders don't support glow. The compatibility setting (enabled by default) changes the rendering type of emissive textures. You can force the correct rendering type by setting type EYES for your model.

Compatibility with OptiFine

Figura works with OptiFine, but due to closed source code, issues may arise. We recommend using Sodium+Iris (Fabric) or Rubidium+Oculus (Forge).

Where to find avatars for download

Currently, avatars can be found in the showcase channel of the official Discord server. A web browser and in-game browser are in development!

Issues with non-licensed Minecraft versions

Figura uses your account's UUID and Mojang authentication to confirm account ownership. Non-licensed Minecraft versions don't pass authentication, so they cannot upload or download Figura avatars.

Community Resources

• Want to learn Lua scripts? Check out the Lua quickstart by Manuel.
• Tired of searching for information in the wiki only in-game? applejuice hosts the wiki as a website.
• New to Figura and looking for video tutorials? Watch Chloe's Figura tutorial series on YouTube.
• Use VSCode and want Figura documentation autocompletion? GrandpaScout created VSDocs.
• Katt created a Blockbench extension adding a special model format for Figura! Read more here.
• Search for "Figura" in the VSCode extension browser to install Manuel's extension! It adds useful features including model path autocompletion.