标签排除

标签排除

用于从标签中移除条目的库和实用工具

基础库

本库在 26.1+ 上已废弃,因为 Fabric API 和 Neoforge 现在都提供了从标签文件中移除条目的方法。


一个库与实用工具,用于移除标签中的条目,避免在数据包中必须使用 "replace": true。

语法

现在标签条目有了一种简写语法。你可以在条目末尾添加 ? 将其标记为可选,并在条目开头添加 ! 将其标记为排除条目。

排除条目会从标签中移除,包括从同一标签文件中的先前条目以及来自较低层级数据包中的条目。

示例:

{
  "values": [
    
    "#minecraft:doors",
    // 添加所有门
    "!minecraft:spruce_door",
    // 但云杉木门除外
    
    "#minecraft:logs",
    // 添加所有原木
    "!#minecraft:logs_that_burn",
    // 但可燃烧的原木除外
    
    "create:brass_casing?",
    // 如果安装了 Create,则添加其黄铜机壳
    
    "!#enderscape:veiled_logs?"
    // 如果安装了 Enderscape,则移除其蒙面原木
    
  ]
}

标准的展开格式也得到了扩展。

{
  "values": [
    "#minecraft:logs",
    {
      "id": "#minecraft:logs_that_burn",
      "tagex:exclude": true
    }
  ]
}

依赖 Tag Exclusion

目前推荐使用 JitPack 在 Gradle 中添加该模组,并以 jar-in-jar 方式打包。

repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    modImplementation include("com.github.ThePotatoArchivist:TagExclusion:${project.tagex_version}")
}

注意:由于某些原因,JitPack 的版本名中不能包含 +,因此在 Gradle 中指定版本时必须改用 -,例如 1.0.0-mc1.21.11。模组元数据中的版本仍然使用 +,只有 maven 版本使用 -。

数据生成

要在数据生成中添加标签排除,请使用 TagAppender 的扩展方法。

valueLookupBuilder(ItemTags.ANVIL)
        .tagex_exclude(Items.CHIPPED_ANVIL);

valueLookupBuilder(ItemTags.LOGS_THAT_BURN)
        .tagex_forceExcludeTag(ItemTags.DARK_OAK_LOGS);

如果你使用 Kotlin,也有名称中不带 tagex_ 的扩展函数。

with (valueLookupBuilder(ItemTags.ANVIL)) {
    exclude(Items.CHIPPED_ANVIL)
}

为了避免在不该干扰数据生成时进行干扰,只有当生成模组为其数据生成指定了模组 ID 并声明对 tagex 的硬依赖时,数据生成才会以简写形式生成标签条目。

在 build.gradle 中:

fabricApi {
    configureDataGeneration {
        // ...
        modId = "testmod"
    }
}

你可能需要重新生成 IDE 的运行配置。

在 fabric.mod.json 中:

{
  // ...
  "depends": {
    // ...
    "tagex": "^1.0.0"
  }
}