FluidSlot

FluidSlot 在槽位内渲染 FluidStack，并以方向性填充效果展示液位。手持流体容器点击槽位时，会通过原版 FluidUtil API 进行填充或排空。当 JEI、REI 或 EMI 存在时，它也会与这些模组联动。

UIElement 中记录的所有内容（布局、样式、事件、数据绑定等）同样适用于此处。

用法

JavaKotlinKubeJS

var fluidSlot = new FluidSlot();
fluidSlot.bind(fluidHandler, 0); // IFluidHandler + tank index
fluidSlot.setCapacity(16000);
parent.addChild(fluidSlot);

// Phantom slot (XEI drag-drop)
fluidSlot.xeiPhantom();

fluidSlot({
    layout { width(18).height(18) }
}) {
    api {
        bind(fluidHandler, 0)
        setCapacity(16000)
    }
}

let slot = new FluidSlot();
slot.bind(fluidHandler, 0);
slot.setCapacity(16000);
parent.addChild(slot);

XML

<!-- Basic slot -->
<fluid-slot capacity="16000"/>

<!-- Disable XEI lookup -->
<fluid-slot capacity="4000" allow-xei-Lookup="false"/>

XML 属性	类型	描述
`capacity`	`int`	悬停提示中显示的储罐容量。默认值：`0`。
`allow-xei-Lookup`	`boolean`	悬停时是否触发 XEI 配方查找。默认值：`true`。

内部结构

字段	CSS 类	描述
`amountLabel`	`.__fluid-slot_amount-label__`	右下角显示流体数量的 `Label`（例如 `1.5B`）。

槽位样式

fill-direction

流体纹理随数量增加而填充槽位的方向。可选值：LEFT_TO_RIGHT、RIGHT_TO_LEFT、UP_TO_DOWN、DOWN_TO_UP、ALWAYS_FULL。

默认值：LEFT_TO_RIGHT

JavaLSS

fluidSlot.slotStyle(style -> style.fillDirection(FillDirection.UP_TO_DOWN));

fluid-slot {
    fill-direction: UP_TO_DOWN;
}

hover-overlay

悬停时绘制在槽位上方的纹理。

默认值：ColorRectTexture(0x80FFFFFF)

JavaLSS

fluidSlot.slotStyle(style -> style.hoverOverlay(myTexture));

fluid-slot {
    hover-overlay: color(#FFFFFF80);
}

slot-overlay

绘制在槽位背景上方的纹理。

默认值：无（空）

JavaLSS

fluidSlot.slotStyle(style -> style.slotOverlay(myOverlay));

fluid-slot {
    slot-overlay: sprite("mymod:textures/gui/fluid_slot.png");
}

show-slot-overlay-only-empty

为 true 时，slot-overlay 仅在槽位为空时绘制。

默认值：true

JavaLSS

fluidSlot.slotStyle(style -> style.showSlotOverlayOnlyEmpty(false));

fluid-slot {
    show-slot-overlay-only-empty: false;
}

show-fluid-tooltips

悬停时是否显示流体名称、数量/容量、温度和状态悬停提示。

默认值：true

JavaLSS

fluidSlot.slotStyle(style -> style.showFluidTooltips(false));

fluid-slot {
    show-fluid-tooltips: false;
}

值绑定

FluidSlot 继承自 BindableUIElement<FluidStack>：

Java

fluidSlot.bind(DataBindingBuilder.fluidStackS2C(
    () -> tank.getFluidInTank(0)
).build());

详情请参见数据绑定。

字段

名称	类型	访问权限	描述
`amountLabel`	`Label`	`public final`	显示精简流体数量的标签。
`slotStyle`	`SlotStyle`	`private` (getter)	当前槽位样式。
`fluid`	`FluidStack`	`private` (getter)	当前显示的流体。
`capacity`	`int`	`getter/setter`	用于填充计算和悬停提示的储罐容量。
`allowClickFilled`	`boolean`	`getter/setter`	手持容器点击时是否从储罐填充容器。默认值：`true`。
`allowClickDrained`	`boolean`	`getter/setter`	手持容器点击时是否向储罐排空容器。默认值：`true`。

方法

方法	返回值	描述
`bind(IFluidHandler, int)`	`FluidSlot`	绑定到指定储罐索引的流体处理器。同步流体和容量。
`setFluid(FluidStack)`	`FluidSlot`	设置显示的流体并通知监听器。
`setFluid(FluidStack, boolean)`	`FluidSlot`	设置流体；第二个参数控制是否通知。
`slotStyle(Consumer<SlotStyle>)`	`FluidSlot`	以流式接口配置样式。
`xeiPhantom()`	`FluidSlot`	在此槽位上启用 XEI 虚拟拖拽功能。
`xeiRecipeIngredient(IngredientIO)`	`FluidSlot`	在 XEI 配方视图中标记为配方原料。
`xeiRecipeSlot()`	`FluidSlot`	标记为配方槽位，默认 `IngredientIO.NONE`。
`xeiRecipeSlot(IngredientIO, float)`	`FluidSlot`	以给定的 I/O 类型和概率标记为配方槽位。
`getFluidAmountText()`	`Component`	返回 `amountLabel` 中显示的精简数量文本。
`getFullTooltipTexts()`	`List<Component>`	返回合并后的流体和自定义悬停提示文本行。