
好奇桥形象
Figura 头像脚本可以隐藏、移动、旋转和缩放 Curios 物品。仅客户端。
Figura Curios Bridge
⚠ 关于此模组
> 此模组是在 Claude(Anthropic 开发的 AI)的协助下开发的。已有真人于游戏内测试并确认其可正常工作,但请留意这一点。
> 如果你不愿意使用 AI 制作的模组,请不要使用此模组。
Figura Curios Bridge 允许 Figura 头像脚本控制 Curios 物品在玩家身上的渲染方式。
Figura 通常无法控制 Curios 物品,因为 Curios 会自行绘制它们。这往往导致这些物品在自定义头像上看起来不正确:护目镜陷进头发里、戒指飘离手部等等。此模组添加了一套小型 Lua API,让头像可以隐藏、移动、旋转或缩放任意 Curios 物品,以贴合其模型。
特性
- 为 Figura 头像新增 Lua 全局对象
curios - 隐藏 Curios 物品,或移动 / 旋转 / 缩放它们
- 可针对特定物品、整个槽位、某个槽位索引,或全部内容
- 变换可跟随身体部位(头、身体、手臂、腿)
- 读取玩家装备的 Curios 物品(
curios:getItems()) - 仅客户端运行,无需在服务器安装
依赖要求
- Minecraft 1.21.1 / NeoForge
- Figura 0.1.6 或更高版本(低于 0.2)
- Curios 9.5 或更高版本(可选:不安装时 API 仍然存在,但不产生任何效果)
注意: 效果仅对安装了此模组的玩家可见。
> 未安装的玩家会照常看到 Curios 物品,且不会出现任何异常。
Lua API
使用冒号调用这些方法:curios:setVisible(...)。
键(使用第一个匹配项):"head#0"(槽位#索引)→ "create:goggles"(物品 ID)→ "head"(槽位名称)→ "*"(全部)
| 函数 | 描述 |
|---|---|
getVersion() |
此模组的版本 |
isAvailable() |
是否安装了 Curios |
isHooked() |
Curios 渲染钩子是否处于活动状态 |
getItems() |
已装备的 Curios 物品列表:{slot, index, id, count, cosmetic, rendered} |
setVisible(key, bool) |
显示 / 隐藏 |
setPart(key, part) |
要跟随的身体部位:none(默认)、head、body、left_arm、right_arm、left_leg、right_leg |
setPos(key, vec) |
以像素为单位的偏移量(坐标轴与 Blockbench 相同) |
setRot(key, vec) |
以度为单位的旋转(坐标轴与 Blockbench 相同) |
setScale(key, vec) |
缩放(1 = 不变) |
setPivot(key, vec) |
旋转 / 缩放的轴心,以像素为单位,从所属部位的轴心算起 |
reset(key) / resetAll() |
移除设置 |
Setter 方法返回 curios,因此可以链式调用。
示例
基础设置: 始终先进行检查,这样你的头像在未安装此模组的玩家那里也能正常工作。lua<br>if curios and curios:isAvailable() then<br> -- your settings here<br>end<br>
隐藏物品lua<br>curios:setVisible("create:goggles", false) -- one item<br>curios:setVisible("ring", false) -- a whole slot<br>curios:setVisible("ring#1", false) -- only the 2nd ring<br>curios:setVisible("*", false) -- everything<br>
移动 / 缩放以贴合你的模型lua<br>local G = "create:goggles"<br>curios:setPos(G, vec(0, 1, -0.5)) -- 1px up, 0.5px forward<br>curios:setScale(G, vec(1.2, 1.2, 1.2))<br>
跟随身体部位lua<br>local N = "necklace"<br>curios:setPart(N, "body")<br>curios:setPivot(N, vec(0, -2, 0))<br>curios:setRot(N, vec(10, 0, 0))<br>
对玩家所佩戴的物品做出反应lua<br>local wait = 0<br>events.TICK:register(function()<br> wait = wait - 1<br> if wait > 0 then return end<br> wait = 10 -- check every 0.5 seconds<br> local goggles = false<br> for _, it in ipairs(curios:getItems()) do<br> if it.id == "create:goggles" and (it.rendered or it.cosmetic) then goggles = true end<br> end<br> -- e.g. change your avatar here<br>end)<br>
播放动画(每帧调用都是安全的)lua<br>events.RENDER:register(function(delta)<br> local t = world.getTime(delta)<br> curios:setRot("head", vec(0, 0, math.sin(t / 10) * 5))<br>end)<br>
安全性
- 遵循 Figura 的信任设置:除非查看者允许该头像的Vanilla Model Edit,否则不会发生任何变化
- 遵循 Figura 的紧急按键,并在头像脚本出错时停止
- 渲染时不运行任何 Lua 代码,因此不会占用头像的指令限制
- 如果 Curios 更新导致钩子失效,游戏仍会继续运行。你会收到聊天警告,物品会正常渲染。
测试环境
- Figura 0.1.6
- Curios 9.5.1 – 9.5.11
其他版本也可能可用。未测试的版本会在日志中注明。
许可证
MIT
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。