CurseForge

**Figura**
==========


A Minecraft Java client mod that allows you to extensively customize your player model and have other players see your Avatar without requiring any server mods!
----------------------------------------------------------------------------------------------------------------------------------------------------------------


![blockbench](https://raw.githubusercontent.com/FiguraMC/Figura/HEAD/.github/assets/blockbench.png)


Utilizing the full potential of [Blockbench](https://curseforge.com/linkout?remoteUrl=https%253a%252f%252fwww.blockbench.net%252f).
-------------------------------------------------------------------------------------------------------------


![animation](https://raw.githubusercontent.com/FiguraMC/Figura/HEAD/.github/assets/anims.png)


![mesh](https://raw.githubusercontent.com/FiguraMC/Figura/HEAD/.github/assets/mesh_e.png)


Not only can you customize your model but Figura also has an optional [Lua](https://curseforge.com/linkout?remoteUrl=https%253a%252f%252fwww.lua.org%252f) API to make your own scripts!
------------------------------------------------------------------------------------------------------------------------------------------------------------------


![lua](https://raw.githubusercontent.com/FiguraMC/Figura/HEAD/.github/assets/lua.png)


What if someone is invisible, or very small? Take advantage of Figura's robust permission system!
-------------------------------------------------------------------------------------------------


![perms](https://raw.githubusercontent.com/FiguraMC/Figura/HEAD/.github/assets/perms.png)


We also have some extras, like:
-------------------------------


![Qol](https://raw.githubusercontent.com/FiguraMC/Figura/HEAD/.github/assets/wheel.png)


![skullemoji](https://raw.githubusercontent.com/FiguraMC/Figura/HEAD/.github/assets/skull.png)


Meet us on the [FiguraMC Discord Server](https://curseforge.comhttps://curseforge.com/linkout?remoteUrl=https%253a%252f%252fdiscord.figuramc.org%252f) for more info and help :)


Links
=====


Social:  [discord](https://curseforge.comhttps://curseforge.com/linkout?remoteUrl=https%253a%252f%252fdiscord.figuramc.org%252f)
------------------------------------------------------------------------------------


Download:  [modrinth](https://curseforge.com/linkout?remoteUrl=https%253a%252f%252fmodrinth.com%252fmod%252ffigura)   [curseforge](https://curseforge.com/minecraft/mc-mods/figura)
-------------------------------------------------------------------------------------------------------------------------------------------------------------


Donate:  [collective](https://curseforge.com/linkout?remoteUrl=https%253a%252f%252fopencollective.com%252ffigura)   [kofi](https://curseforge.com/linkout?remoteUrl=https%253a%252f%252fko-fi.com%252fskyrina)
------------------------------------------------------------------------------------------------------------------------------------------------------------------


FAQ
===


### • My avatars don't appear in the Figura list, even though they're in the correct folder?


> Check if your avatar has a file called "avatar.json" (don't forget to check file extensions)
>
> This file can be completely empty, it just needs to be present for Figura to recognise it as an avatar


### • How do I hide the vanilla model?


> At the top of your script, put:
>
> • To hide literally 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, you can check the in-game docs


### • How do I play a Blockbench Animation?


> Simply put this code in your script:



```
animations.modelName.animationName:play()

```

> Where:
>
> "`animations`" is the global table which contains all animations
>
> "`modelName`" is the name of the model you are accessing the animation from
>
> "`animationName`" is, as the name says, the animation name


### • What are Pings and how do I use them?


> Pings are Lua functions that are executed for everyone running your avatar's script
>
> Pings are sent from the host player, and can be used to sync things like keypresses or action wheel actions
>
> To create a ping:



```
function pings.myPing(arg1, arg2)
  -- code to run once the ping is called
end

```

> And to execute the ping, it's as shrimple as calling a lua function:



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

```

> Note that pings are limited in their content and size, and are rate-limited


### • How can I add an emissive texture?


> Name the texture the same as the non-emissive counterpart, then add `_e` to the end
>
> And don't forget to set the places you don't want to glow to **transparent black** (#00000000), to also ensure compatibility with shader mods


### • My emissives doesn't glow, nor have bloom with Iris/Optifine shaders?


> Since some shaders doesnt support emissives, a compatibility setting (default on) will change the render type of emissive textures to render them at it were fullbright, however that can lead to some unintended results
>
> You can force your avatar to use the correct emissive render type by using the render type `EYES` on your model


### • How can I use Figura with OptiFine?


> Figura will work with Optifine but due it's closed source nature issues might arise, therefore we still recommend you try using Sodium+Iris (Fabric) or Rubidium+Oculus (Forge) instead
>
> Check out the full list of [alternatives](https://curseforge.com/linkout?remoteUrl=https%253a%252f%252flambdaurora.dev%252foptifine_alternatives%252f)


### • Where can I find Avatars to download?


> For now you can find Avatars in the showcase channel in the official Discord server (A Web Based and In-Game browser is in the works!)


### • My Minecraft is cracked (non-premium/non-original) or I'm trying to join a cracked offline mode server, why can't I use Figura?


> Figura uses your account's UUID and your Mojang authentication as a way to prove you own that account, avoiding unwanted / malicious uploads
>
> Non-premium Minecraft accounts don't authenticate with Mojang, and Offline mode servers don't report working UUID's, as such can neither upload nor download Figura avatars




A client-side mod that allows for extensive customization of the player model.

Figura

Sources

CurseForge