标签管理器

标签管理器

向后移植并升级了1.13版本的标签系统。其用途截然不同。

基础库

标签系统太棒了!它在模组配置和兼容性方面有着天壤之别。 本模组旨在将 1.13 的标签系统向下移植。

本模组完全从头编写并升级;其中没有任何原版代码。TagManager 这个名字直接引用了新系统的核心 "net.minecraft.tags.TagManager.class"。除了升级之外,本模组还经过了高度优化和测试。不仅针对性能进行了优化,也针对内存进行了优化。

除了标签之外,模组还添加了表(Tables)和整数表(Integer Tables)。本模组还提供了一些有用的原创标签,例如 "tagmanager:tin_ores"。

要在条目中指定精确的元数据,请使用 "_:#"。

示例:"minecraft:planks:2" 表示白桦木板。

标签使用的格式与新版本完全相同。请记住,在扁平化之前,许多条目使用不同的 id 值。还有一种额外的方式来添加可选条目。除了原版方式之外,你还可以在 "values" 旁边指定一个 "optional" 列表。

表允许将方块/X 转换为另一个方块/X。这对于 1.12.2 中的深板岩或生物群系的邪恶变种之类的内容很有用。本模组不添加深板岩或任何新方块。表被创建为一个带有 "to" 和 "from" 属性的列表。还有一个 "name" 属性,它在代码中可见但未被使用;它只是为了在需要时让代码能够找到条目。默认情况下,"name" 会与 "to" 属性匹配。

示例:

{
  "values": [
	{
	  "from": "minecraft:log",
	  "to": "projectazalea:stripped_log"
	},
	{
	  "from": "minecraft:log2",
	  "to": "projectazalea:stripped_log2"
	},
	{
	  "from": "projectazalea:bark",
	  "to": "projectazalea:stripped_bark"
	},
	{
	  "name": "projectazalea:newer_bark_blocks",
	  "from": "projectazalea:bark2",
	  "to": "projectazalea:stripped_bark2"
	}
  ]
}

整数表将 X 转换为整数。这对于附魔能力等级或矿石价值之类的内容很有用。这些表使用 "key" 和 "value" 属性构建。

示例:

{
  "values": [
	{
	  "key": "minecraft:magma_cream",
	  "value": 2
	},
	{
	  "key": "minecraft:blaze_powder",
	  "value": 3
	},
	{
	  "key": "minecraft:torch",
	  "value": 3
	},
	{
	  "key": "minecraft:magma",
	  "value": 4
	},
	{
	  "key": "minecraft:lava_bucket",
	  "value": 5
	},
	{
	  "key": "minecraft:blaze_rod",
	  "value": 12
	}
  ]
}

加载顺序为:

1:运行 TagPrimeEvent

2:保存 config/default/*.json

3:加载 config/custom/*.json 和 config/default/*.json

使用 /reload 确实有效(在开发环境之外),因此你每次做出更改后都不必重启 Minecraft!

免责声明

单独使用时,TagManager 的数据不会产生任何效果。

面向开发者

剧透

与较新版本的 Minecraft 不同,标签是由代码创建的;在此版本中数据包尚不可模组化。它不会在正确的时间刷新,而且唯一的模组文件加载代码是客户端侧的。

要创建一个标签,你必须创建一个字段来保存标签键。与较新的 Minecraft 不同,当扁平化发生时,方块和物品的指定方式有所不同。

方块标签键为:"TagKey"

物品标签键为:"TagKey"

该字段以调用 "TagManager.X.createKey(R)" 结束。'X' 是要为其创建键的注册表,例如 BLOCKS 或 ITEMS。'R' 是用作标签 id 的资源位置。

该字段就是标签引用。

要将条目添加到你的标签或现有标签,你必须使用对应注册表的 TagPrimeEvent 子类。在那里你检查正在加载的是哪个标签,并添加到指定的标签。这个 'if' 语句至关重要。

例如:

public static final TagKey<IBlockState>ALLOWS_WEBBED_COBBLESTONE=TagManager.BLOCKS.createKey(new ResourceLocation("mysticalmobs","allows_webbed_cobblestone"));
public static final TagKey<IBlockState>BANE_OF_ARTHROPODS_EFFECTIVE=TagManager.BLOCKS.createKey(new ResourceLocation("mysticalmobs","bane_of_arthropods_effective"));
public static final TagKey<IBlockState>WEBBED_COBBLESTONE_REPLACEABLE=TagManager.BLOCKS.createKey(new ResourceLocation("mysticalmobs","webbed_cobblestone_replaceable"));
public static final TagKey<IBlockState>WEB_CLUSTER_REPLACEABLE=TagManager.BLOCKS.createKey(new ResourceLocation("mysticalmobs","web_cluster_replaceable"));
public static final TagKey<IBlockState>WEB_COCOON_REPLACEABLE=TagManager.BLOCKS.createKey(new ResourceLocation("mysticalmobs","web_cocoon_replaceable"));
@SubscribeEvent public void prime(BlockTagPrimeEvent event){
	if(event.tag==BlockTags.BASE_STONE_OVERWORLD)event.required.add("mysticalmobs:webbed_cobblestone");
	else if(event.tag==BlockTags.FLOWER_POTS)event.required.add("mysticalmobs:buttercup_flower_pot");
	else if(event.tag==BlockTags.SMALL_FLOWERS)event.required.add("mysticalmobs:buttercup");
	else if(event.tag==ALLOWS_WEBBED_COBBLESTONE)event.required.add("mysticalmobs:web_cocoon");
	else if(event.tag==BANE_OF_ARTHROPODS_EFFECTIVE){
		event.required.add("minecraft:monster_egg");
		event.required.add("minecraft:web");
		event.required.add("mysticalmobs:web");
		event.required.add("mysticalmobs:web_cocoon");
		event.required.add("mysticalmobs:webbed_cobblestone");
	}
	else if(event.tag==WEBBED_COBBLESTONE_REPLACEABLE){
		event.required.add("minecraft:cobblestone");
		event.required.add("minecraft:gravel");
		event.required.add("minecraft:monster_egg:0");
		event.required.add("minecraft:monster_egg:1");
		event.required.add("minecraft:mossy_cobblestone");
		event.required.add("minecraft:stone:0");
	}
	else if(event.tag==WEB_CLUSTER_REPLACEABLE){
		event.required.add("minecraft:air");
		event.required.add("mysticalmobs:web");
	}
	else if(event.tag==WEB_COCOON_REPLACEABLE)event.required.add("minecraft:web");
}

持有标签的类必须在 FMLPreInitializationEvent 中被引用,否则游戏将崩溃!

例如: MinecraftForge.EVENT_BUS.register(new ModBlockTags()); ...或者... ModBlockTags.WEB_COCOON_REPLACEABLE.location();

要使用一个标签,你必须调用 X.test(Y)。'X' 是标签键的实例。'Y' 是需要被测试的对象。

本模组可以作为仅使用 Java 反射的标签软依赖使用。以下是一个好的实现方式:

import java.util.function.Predicate;
public static final Predicate<IBlockState>BASE_STONE_OVERWORLD;
public static final Predicate<IBlockState>EXAMPLE_BLOCK_TAG;
public static final Predicate<ItemStack>EXAMPLE_ITEM_TAG;
static{
    Predicate<IBlockState>m,n;
    Predicate<ItemStack>o;
    try{
        Method d=Class.forName("com.quethed.tagmanager.TagManager")
            .getDeclaredMethod("createKey",ResourceLocation.class,ResourceLocation.class,BiConsumer.class);
        ResourceLocation l=new ResourceLocation("minecraft","block");
        m=(Predicate<IBlockState>)d.invoke(null,l,new ResourceLocation("minecraft","base_stone_overworld"),null);
        n=(Predicate<IBlockState>)d.invoke(null,l,new ResourceLocation("mod","example"),new BiConsumer<ArrayList<String>,ArrayList<String>>(){
            @Override public void accept(ArrayList<String>required,ArrayList<String>optional){
                required.add("minecraft:carrots");
                required.add("minecraft:potatoes");
                optional.add("betternether:egg_plant");
            }
        });
        o=(Predicate<ItemStack>)d.invoke(null,new ResourceLocation("minecraft","item"),new ResourceLocation("mod","example"),new BiConsumer<ArrayList<String>,ArrayList<String>>(){
            @Override public void accept(ArrayList<String>required,ArrayList<String>optional){
                required.add("minecraft:apple");
                required.add("minecraft:carrot");
                required.add("minecraft:potato");
                optional.add("betternether:egg_plant");
            }
        });
    }catch(Throwable e){
        m=(a)->{
            if(a.getBlock()!=Blocks.STONE)return false;
            BlockStone.EnumType b=a.getValue(BlockStone.VARIANT);
            return b==BlockStone.EnumType.STONE||b==BlockStone.EnumType.GRANITE||b==BlockStone.EnumType.DIORITE||b==BlockStone.EnumType.ANDESITE;
        };
        n=(a)->{
            Block b=a.getBlock();
            return b==Blocks.CARROTS||b==Blocks.POTATOES;
        };
        o=(a)->{
            Item b=a.getItem();
            return b==Items.APPLE||b==Items.CARROT||b==Items.POTATO;
        };
    }
    BASE_STONE_OVERWORLD=m;
    EXAMPLE_BLOCK_TAG=n;
    EXAMPLE_ITEM_TAG=o;
}

现在你已经了解了 TagManager 的基础知识,请查看代码以了解更多。

面向用户

剧透

整合包开发者可以轻松地更改或读取标签。遗憾的是,不支持数据包。要更改数据:

步骤 1:找到 ":/config/tagmanager/default/T/R/N/P.json"。

T = 数据类型。 R = T 对应的注册表。 N = 模组的 id。 P = 条目的名称。

默认文件不适合修改,并且每次加载时都会重置。默认文件只是让你能看到游戏正在加载什么。

步骤 2:在同一位置新建一个 json 文件,但放在 "custom" 而不是 "default" 中。

步骤 3:将新数据写入该文件。记住:是 ":/config/custom/" 而不是 ":/config/default/"。除非将 "replace" 设置为 true,否则自定义数据将与默认数据混合。

常见问题:

剧透

问: 我可以分享这个……吗?

答: 你可以分享链接或非商业整合包。你不得在任何地方重新发布本模组。此页面仅在 Modrinth 上以作说明。你不能从我的模组中获利!

问: 我可以在我的整合包中使用它吗?

答: 你不能在任何形式涉及购买的整合包中使用它,包括捐赠奖励或将下载锁定在付费服务器之后。

问: 你能移植到 X 版本/模组加载器吗?

答: 我只会移植到相邻的旧版本。对于较新版本,我正在规划数据包续作 "TableManager"。基本上,在 1.11 完成之前,我不会制作 1.10。

问: 我可以在我的视频中使用它吗?

答: 只要注明出处并链接到本页面即可。此页面仅在 Modrinth 上以作说明。如果用于系列视频,注明出处只需在首次出现时进行。链接必须出现在所有视频中,建议放在简介中。