Package me.kzheart.klib.item
Interface ExternalItemSource
public interface ExternalItemSource
单个外部物品系统的适配器,例如 MMOItems 或 NeigeItems。
在 ExternalItems 中以 prefix() 注册,配置里用 prefix:id 引用物品。
-
Method Summary
Modifier and TypeMethodDescriptionorg.bukkit.inventory.ItemStack按 ID 生成新物品;ID 不存在时返回null。default org.bukkit.inventory.ItemStack在实际使用者上下文生成一件物品;不需要上下文的提供者沿用基础生成。default org.bukkit.inventory.ItemStackcreateStack(String id, int amount, org.bukkit.entity.Player player) 生成一个堆叠。唯一实例提供者可以拒绝大于一的数量,调用方改用逐件批量生成。identify(org.bukkit.inventory.ItemStack item) 返回物品在本系统中的 ID;不属于本系统时返回null。plugin()用于诊断输出的插件名称。prefix()物品引用前缀,只能包含小写字母、数字、下划线和短横线。default me.kzheart.klib.item.ItemPreview无交付副作用的展示样本。默认明确不支持,绝不回退到 create。 适配器负责区分未就绪、未知 ID 和构建失败;不得为预览分配业务唯一实例。
-
Method Details
-
prefix
String prefix()物品引用前缀,只能包含小写字母、数字、下划线和短横线。 -
plugin
String plugin()用于诊断输出的插件名称。 -
create
按 ID 生成新物品;ID 不存在时返回null。 -
preview
无交付副作用的展示样本。默认明确不支持,绝不回退到 create。 适配器负责区分未就绪、未知 ID 和构建失败;不得为预览分配业务唯一实例。 -
create
在实际使用者上下文生成一件物品;不需要上下文的提供者沿用基础生成。 -
createStack
default org.bukkit.inventory.ItemStack createStack(String id, int amount, org.bukkit.entity.Player player) 生成一个堆叠。唯一实例提供者可以拒绝大于一的数量,调用方改用逐件批量生成。 -
identify
返回物品在本系统中的 ID;不属于本系统时返回null。
-