Variants-CIT

Variants-CIT

专为具有标准化变体的物品设计的精简 CIT 格式。

这个模组不如 OptiFine 灵活，但在单个物品基于同一数据拥有多种变体时表现出色。当可用的 CIT 数量极多时，它能提供更好的性能，并采用冗余度更低的资源格式，只需一个简短文件即可一次性配置所有可能的变体。

适用于此模组的即用型资源包分支：

• Even Better Enchants (原始资源包)
• Xali’s Enchanted Books(原始资源包)
• Xali’s Potions (原始资源包)
• Axolotl Bucket Variants (原始资源包)

资源包格式

以下内容仅为概览，完整指南请参阅维基。

此格式的核心是自动将物品变体与名称相匹配的模型或纹理关联起来。
你无需为每个 CIT 分别定义条件，而是为一个集合（称为模块）定义一条规则，用来管理其中的所有 CIT。模块会定义受影响的物品、如何确定其变体，以及变体模型所在的位置。

例如，下面是一个用于更改附魔书纹理的简单模块：

{
	"type": "stored_enchantment", // The behaviour of the module
	"items": "minecraft:enchanted_book", // The affected item type(s)
	"modelPrefix": "item/book_cit/", // The folder containing the possible models/textures.
	"modelParent": "item/generated", // Automatically generate models from texture (if models are absent)
	"parameters": { // Extra options specific to the module type
		"levelSeparator": "_lvl_" // Include the enchantment level in the variant ID
	}
}

在此示例中，拥有等级 2 的 minecraft:unbreaking 附魔的书，其变体 ID 为 minecraft:unbreaking_lvl_2，因此会使用存储在 /assets/minecraft/texture/item/book_cit/unbreaking_lvl_2.png 的纹理。
只要存在对应的纹理，这个模块就适用于所有可能的附魔，无论是原版还是模组添加的附魔。

上面的模块类型专门为附魔书设计了相应的逻辑。如果某个组件没有专用的模块类型，你仍然可以使用更通用的模块，从任意组件中获取变体：

{
	"type": "component_data",
	"items": "minecraft:suspicious_stew",
	"modelPrefix": "item/suspicious_stew_cit/",
	"parameters": {
		"componentType": "suspicious_stew_effects", // The component containing the variant ID
		"nbtPath": "[0].id" // The location of the variant ID in the component.
	}
}

更进一步，你还可以组合多个组件中的多项数据来创建变体：

{
	"type": "component_format",
	"items": "minecraft:diamond_sword",
	"modelPrefix": "item/trimmed_diamond_sword/",
	"parameters":{
		"format": "${pattern}_${material}", // How to combine various pieces of data into a variant ID
		"variables": { // Where to find those pieces of data.
			"pattern": {
				"componentType": "trim",
				"nbtPath": ".pattern"
			},
			"material": {
				"componentType": "trim",
				"nbtPath": ".material",
				"transform": "discard_namespace"
			}
		}
	}
}