Backpack Display

BackpackDisplay

添加提示框，显示背包、潜影盒或其他容器物品中的内容。
可配置获取容器物品内容的方式。
该模组开箱即支持原版潜影盒、储物抽屉模组的抽屉以及林业背包。你可以在模组配置中编写自定义规则，为更多物品添加支持。

可配置选项（参见模组配置）：

• 显示模组提示框的物品
• 提示框的位置和颜色
• 可选：按住或松开按键绑定以显示提示框

配置格式

displayRules 是模组的主要配置项。你可以用它添加要显示背包提示框的新容器物品，格式如下：
格式：<modID>:<itemID>[:meta]#<rule type>#<rule definition>

meta 是以逗号分隔的元数据值列表，用于匹配。
例如，1,2,5-8 表示在元数据为 1、2、5、6、7、8 的物品上显示提示框。
如果省略 meta，则无论物品的元数据为何，都会显示提示框。

规则定义取决于所选的规则类型。

路径

路径常用于规则中，格式类似 path.to.the.item。
例如，在以下 NBT 结构中：

{"list":[{"key1":"value"},{"key2":"item"}]}

路径 list.1.key2 会获取其中的标签 “item”。

列表规则

规则类型：list

此规则中，物品都位于 NBTTagList 或 NBTTagCompound 之下。

规则定义：path.to.the.list[;path.to.the.itemstack[;path.to.the.counts]]
最后两个路径相对于列表中的标签物品。如果省略 counts，则使用 itemstack 中的数量。

示例：悬停在紫色潜影盒上时显示内容

minecraft:purple_shulker_box#list#BlockEntityTag.Items

单个规则

规则类型：single

此规则中，物品位于固定路径下，并可选择指定外部数量值。

规则定义：path.to.the.itemstack[;path.to.the.counts[;calculations for the counts]]
如果省略 counts，则使用 itemstack 中的数量。

示例：显示储物抽屉模组中所有基础抽屉的内容

storagedrawers:basicdrawers:0#single#BlockEntityTag.Drawers.0.Item;BlockEntityTag.Drawers.0.Count
storagedrawers:basicdrawers:1,3#single#BlockEntityTag.Drawers.0.Item;BlockEntityTag.Drawers.0.Count
storagedrawers:basicdrawers:1,3#single#BlockEntityTag.Drawers.1.Item;BlockEntityTag.Drawers.1.Count
storagedrawers:basicdrawers:2,4#single#BlockEntityTag.Drawers.0.Item;BlockEntityTag.Drawers.0.Count
storagedrawers:basicdrawers:2,4#single#BlockEntityTag.Drawers.1.Item;BlockEntityTag.Drawers.1.Count
storagedrawers:basicdrawers:2,4#single#BlockEntityTag.Drawers.2.Item;BlockEntityTag.Drawers.2.Count
storagedrawers:basicdrawers:2,4#single#BlockEntityTag.Drawers.3.Item;BlockEntityTag.Drawers.3.Count

如果数量不直接存储在标签中，但可以根据标签中的值计算得出，此规则支持进一步计算以获取物品的实际数量。
计算内容是一个以 +-*/^% 中的运算符开头、后接路径的字符串。计算顺序与无法输入表达式的基础计算器相同。
所有计算均以整数进行。

示例：显示储物抽屉模组中压缩抽屉的内容

storagedrawers:compdrawers#single#BlockEntityTag.Drawers.Items.0.Item;BlockEntityTag.Drawers.Count;/BlockEntityTag.Drawers.Items.0.Conv
storagedrawers:compdrawers#single#BlockEntityTag.Drawers.Items.1.Item;BlockEntityTag.Drawers.Count;/BlockEntityTag.Drawers.Items.1.Conv
storagedrawers:compdrawers#single#BlockEntityTag.Drawers.Items.2.Item;BlockEntityTag.Drawers.Count;/BlockEntityTag.Drawers.Items.2.Conv

Crafttweaker 支持

从 v1.3 开始，支持使用 crafttweaker 添加自定义函数来获取要显示的物品。
建议只在带有 #sideonly client 预处理器的脚本中编写条目。否则会在专用服务器上导致错误，因为此模组仅限客户端。
import mods.backpackdisplay.BackpackDisplay; // IIngredient 用于匹配要添加提示的物品，function 用于从给定 itemstack 返回物品数组 BackpackDisplay.addBackDisplay( IIngredient, (IItemStack) -> IItemStack[] );

示例：为 <ore:logWood> 中的每种原木显示工作台及其合成结果

#sideonly client    
import mods.backpackdisplay.BackpackDisplay;
import crafttweaker.item.IItemStack;
BackpackDisplay.addBackDisplay(<ore:logWood>,function(item){
    var items = [<minecraft:crafting_table>,recipes.craft([[item]])] as IItemStack[];
    return items;
});

当物品同时存在 crafttweaker 规则和普通规则时，来自 crafttweaker 支持的物品会显示在普通规则的物品之前。