Figura

Figura

一个 Minecraft Java 客户端模组，允许你广泛自定义你的玩家模型，并让其他玩家无需任何服务端模组即可看到你的形象！

充分利用 Blockbench 的全部潜力。

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

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

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

在 FiguraMC Discord 服务器 上与我们见面，获取更多信息和帮助！

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

链接

社交：

下载：

捐赠：

资源：

常见问题

• 我的形象没有出现在 Figura 列表中，尽管它们放在了正确的文件夹里？

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

这个文件可以是完全空的，但必须存在，Figura 才能识别它为形象

• 我如何隐藏原版模型？

在脚本顶部，放置：

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

vanilla_model.ALL:setVisible(false)

• 只隐藏玩家：

vanilla_model.PLAYER:setVisible(false)

• 只隐藏盔甲：

vanilla_model.ARMOR:setVisible(false)

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

• 我如何播放一个 Blockbench 动画？

只需将这段代码放入你的脚本：

animations.modelName.animationName:play()

其中：

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

"modelName" 是你正在访问其动画的模型名称

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

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

Pings 是为所有运行你形象脚本的玩家执行的 Lua 函数

Pings 由主机玩家发送，可用于同步按键或操作轮盘动作等内容

创建一个 ping：

function pings.myPing(arg1, arg2)
  -- ping 被调用时运行的代码
end

执行 ping 就像调用一个 Lua 函数一样简单：

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

请注意，ping 在内容和大小上有限制，并且有速率限制

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

将纹理命名为与非自发光对应纹理相同的名称，然后在末尾添加 _e

别忘了将你不想发光的地方设置为透明黑色 (#00000000)，以确保与光影模组的兼容性

• 我的自发光纹理在 Iris/OptiFine 光影下不发光，也没有泛光效果？

由于某些光影不支持自发光，一个兼容性设置（默认开启）会更改自发光纹理的渲染类型，使其如同全亮度渲染，但这可能会导致一些意想不到的结果

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

• 我如何将 Figura 与 OptiFine 一起使用？

Figura 可以与 OptiFine 一起工作，但由于其闭源性质，可能会出现一些问题，因此我们仍然建议你尝试使用 Sodium+Iris（Fabric）或 Rubidium+Oculus（Forge）作为替代

查看完整的 替代品列表

• 我在哪里可以找到下载用的形象？

目前，你可以在官方 Discord 服务器的展示频道中找到形象（基于 Web 和游戏内的浏览器正在开发中！）

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

Figura 使用你账户的 UUID 和你的 Mojang 验证来证明你拥有该账户，避免不必要的/恶意的上传

非正版 Minecraft 账户不通过 Mojang 验证，离线模式服务器也不报告有效的 UUID，因此既不能上传也不能下载 Figura 形象

社区资源

• 想学习/入门 Lua 脚本？ 看看这个由 Manuel 制作的 Lua 快速入门。

• 如果你厌倦了必须在游戏中查看 Wiki，applejuice 将 Wiki 托管为一个网站。

• 你是 Figura 新手，正在寻找关于一切如何运作的视频教程？你应该看看 Chloe 在 YouTube 上的 Figura 教程系列。

• 你使用 VSCode 并希望 Figura 的文档在编辑器中自动补全？GrandpaScout 用他们的 VSDocs 拯救了你。

• Katt 创建了一个 Blockbench 扩展，为 Figura 添加了一种特殊的模型格式！点击此处了解更多。- 注意：此插件在 Blockbench 插件浏览器中可用，应从此处安装。

• 在 VSCode 扩展浏览器中搜索 "Figura" 即可安装 Manuel 的 Figura 扩展！它添加了多项实用功能，包括模型路径的自动补全。

Figura 可以被包含在整合包中，无需事先获得我们的批准，但前提是使用从官方渠道（Modrinth、GitHub Releases 和 Pre-releases、Discord Pre-releases）获得的构建版本。