Figura - Figura 虚拟形象模组

Figura

一个 Minecraft Java 客户端模组，让你能够深度自定义你的玩家模型，并且无需服务器安装任何模组，其他玩家也能看到你的 Avatar！

充分发挥 Blockbench 的全部潜力。

你不仅可以自定义模型，Figura 还提供一个可选的 Lua API，让你编写自己的脚本！

如果有人隐身了，或者非常小怎么办？利用 Figura 强大的权限系统吧！

我们还有一些额外功能，比如：

欢迎加入 FiguraMC Discord Server 获取更多信息和帮助！\

在 Weblate 上帮助将 Figura 翻译成你的母语吧！\

![translate]

[translate]: https://translate.figuramc.org/widget/figuramc/figura/horizontal-auto.svg

链接

[discord]: https://discord.com/api/guilds/1129805506354085959/widget.png

[modrinth]: https://img.shields.io/badge/Modrinth-1bd96a?logo=modrinth&logoColor=ffffff

[curseforge]: https://img.shields.io/badge/CurseForge-f16436?logo=curseforge&logoColor=ffffff

[github]: https://img.shields.io/badge/GitHub-181717?logo=github

[github-contrib]: https://img.shields.io/badge/GitHub-Contributing-grey?logo=github&labelColor=181717

[kofi]: https://img.shields.io/badge/Ko--fi-00b9fe?logo=kofi&logoColor=ffffff

[collective]: https://img.shields.io/badge/Open%20Collective-83b3fb?logo=opencollective&logoColor=ffffff

[wiki]: https://img.shields.io/badge/Figura-Wiki-black?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADAAAAAwCAYAAABXAvmHAAAAAXNSR0IArs4c6QAAAM5JREFUaIHtmbENAjEMRRPECIiSmvrYAZobggXoGIMhGOIa2IHUNDTU7HAsYBeWgh6W/isTx7knS5Z1qaUTwzTPkfg21trj3kWPJCQSoJEATbgTeN2mbYJ53vZ6tDulr4AEaCRAIwEaCdBIgMadO4aLM/PsnfjxELq4TTc7z92JP9szUvoKSIBGAjQSoJEAjQRoqjfzlK194HPc/fBzSlldH/bG015OXwEJ0EiAZhk94HWJXn+no6SvgARoJEBT16dX6IX930hfAQnQSIDmC5x4H/qkICDcAAAAAElFTkSuQmCC&labelColor=166ddd&color=5ea5ff

[weblate]: https://img.shields.io/badge/Weblate-Translating-125252?logo=Weblate&logoColor=ffffff&labelColor=2ECCAA

[website]: https://img.shields.io/badge/FiguraMC-Website-purple?logo=data:image/png;base64,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&labelColor=01090E

社交： [ [

下载： [ [ [

捐助： [ [

资源： [ [ [

常见问题

• 我的 avatars 明明放在正确的文件夹里，为什么没有出现在 Figura 列表中？

> 检查你的 avatar 是否有一个名为 "avatar.json" 的文件（别忘了检查文件扩展名）

>

> 这个文件可以完全是空的，只要它存在，Figura 就会将其识别为一个 avatar

• 如何隐藏原版模型？

> 在你的脚本顶部加入：

>

> • 隐藏所有内容（玩家、盔甲、鞘翅、手持物品）：

> ```lua

> vanilla_model.ALL:setVisible(false)

> ```

>

> • 仅隐藏玩家：

> ```lua

> vanilla_model.PLAYER:setVisible(false)

> ```

>

> • 仅隐藏盔甲：

> ```lua

> vanilla_model.ARMOR:setVisible(false)

> ```

>

> • 若要隐藏其他部分或特定部分，可以查看游戏内文档

• 如何播放一个 Blockbench 动画？

> 只需将这段代码放进你的脚本中：

> ```lua

> animations.modelName.animationName:play()

> ```

> 其中：

>

> "animations" 是包含所有动画的全局表

>

> "modelName" 是你要从中访问动画的模型名称

>

> "animationName" 顾名思义，就是动画名称

• 什么是 Pings，我该如何使用它们？

> Pings 是 Lua 函数，会在所有正在运行你的 avatar 脚本的人那里执行

>

> Pings 由宿主玩家发送，可用于同步按键操作或 action wheel 动作等内容

>

> 创建一个 ping：

> ```lua

> function pings.myPing(arg1, arg2)

> -- code to run once the ping is called

> end

> ```

> 然后执行这个 ping，就像调用一个 lua 函数一样简单：

> ```lua

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

> ```

> 请注意，pings 的内容和大小都有限制，并且有速率限制

• 我该如何添加自发光纹理？

> 让该纹理与非自发光版本同名，然后在末尾加上 _e

>

> 同时别忘了将你不想发光的部分设置为 透明黑色 (#00000000)，这样也能确保与着色器模组兼容

• 为什么我的自发光纹理不发光，或者在 Iris/OptiFine 着色器下没有泛光？

> 由于某些着色器不支持自发光，兼容性设置（默认开启）会更改自发光纹理的渲染类型，使其以类似 fullbright 的方式渲染，但这可能会导致一些非预期结果

>

> 你可以通过在模型上使用渲染类型 EYES 来强制 avatar 使用正确的自发光渲染类型

• 如何让 Figura 与 OptiFine 一起使用？

> Figura 可以与 OptiFine 一起工作，但由于其闭源特性，可能会出现一些问题，因此我们仍然推荐你改用 Sodium+Iris（Fabric）或 Rubidium+Oculus（Forge）

>

> 查看完整的替代方案

• 我可以去哪里下载 Avatars？

> 目前，你可以在官方 Discord 服务器的 showcase 频道中找到 Avatars（网页版和游戏内浏览器正在开发中！）

• 我的 Minecraft 是破解的（非正版）账号，或者我正在尝试加入一个破解离线模式服务器，为什么我不能使用 Figura？

> Figura 使用你的账号 UUID 和 Mojang 身份验证来证明你拥有该账号，以避免不受欢迎/恶意的上传

>

> 非正版 Minecraft 账号不会通过 Mojang 验证，而离线模式服务器也不会提供有效的 UUID，因此既无法上传也无法下载 Figura avatars

社区资源

• 想学习 / 入门 Lua 脚本？

可以看看 Manuel 制作的这个 Lua quickstart。

• 如果你厌倦了必须进游戏才能查看 wiki，applejuice 提供了一个网页版的 wiki：website.

• 如果你是 Figura 新手，正在寻找一个讲解整体工作原理的视频教程，你大概应该去看 Chloe 在 YouTube 上的 Figura tutorial series。

• 你是否在使用 VSCode，并希望 Figura 的文档能在编辑器中自动补全？GrandpaScout 的 VSDocs. 可以帮到你。

• Katt 创建了一个 Blockbench 扩展，为 Figura 添加了一种特殊的模型格式！查看更多信息请点这里。 - 注意：该插件可在 Blockbench 插件浏览器中获取，应该从那里安装。

• 只需在 VSCode 扩展浏览器中搜索 “Figura”，你就可以安装 Manuel 的 Figura extension！它增加了多项实用功能，包括模型路径的自动补全。

仅当使用从官方渠道（Modrinth、GitHub Releases、Discord Releases）获取的构建版本时，Figura 才可以被收录进整合包中