好奇桥形象

好奇桥形象

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>&nbsp; -- your settings here<br>end<br>

隐藏物品
lua<br>curios:setVisible("create:goggles", false) &nbsp; -- one item<br>curios:setVisible("ring", false) &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; -- a whole slot<br>curios:setVisible("ring#1", false) &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; -- only the 2nd ring<br>curios:setVisible("*", false) &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;-- everything<br>

移动 / 缩放以贴合你的模型
lua<br>local G = "create:goggles"<br>curios:setPos(G, vec(0, 1, -0.5)) &nbsp; &nbsp; &nbsp; &nbsp;-- 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>&nbsp; wait = wait - 1<br>&nbsp; if wait &gt; 0 then return end<br>&nbsp; wait = 10 &nbsp; -- check every 0.5 seconds<br>&nbsp; local goggles = false<br>&nbsp; for _, it in ipairs(curios:getItems()) do<br>&nbsp; &nbsp; if it.id == "create:goggles" and (it.rendered or it.cosmetic) then goggles = true end<br>&nbsp; end<br>&nbsp; -- e.g. change your avatar here<br>end)<br>

播放动画(每帧调用都是安全的)
lua<br>events.RENDER:register(function(delta)<br>&nbsp; local t = world.getTime(delta)<br>&nbsp; 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