Excavated Variants

Excavated Variants

NeoForge 版本需要：Dynamic Asset Generator

Fabric/Quilt 版本需要：Dynamic Asset Generator 和 Fabric API/Quilted Fabric API
 

根据不同的石头自动生成相应的矿石变种。

详情：

许多模组会添加新的石头或矿石。_Excavated Variants_ 会自动为每种矿石与石头变种的组合添加新的矿石。此外，_Excavated Variants_ 还会尝试为这些矿石变种设置世界生成。可在配置文件中更改添加的变种；部分模组已包含在默认配置中，其他模组则需要手动添加。请查看 Curseforge 页面中的 _Images_ 选项卡，了解生成的矿石示例。

故障排除：

遇到问题了？从这里开始排查！

• 如果世界或游戏加载缓慢，请尝试在 _Dynamic Asset Generator_ 的配置中启用更强的资源和/或数据缓存。
• 游戏启动时崩溃？矿石纹理变成了品红色和黑色？配置可能有问题。尝试删除并重置配置文件。
• 下方列出的模组缺少兼容支持？删除配置文件以重置为默认配置。

兼容性：

_Excavated Variants_ 附带的默认配置包含以下模组的矿石变种，以及原版石头和矿石的变种：

• Quark
• Create
• Oh The Biomes You’ll Go
• Tech Reborn
• Immersive Engineering
• Blockus
• Better End
• Better Nether
• Promenade
• Twigs
• Unearthed
• Bewitchment
• Mekanism
• Mystical Agriculture
• 以及更多！

配置格式

主配置文件 config/excavated_variants.json 包含多个选项：

• attempt\_worldgen\_replacement：启用或禁用矿石生成替换；若未启用，世界生成时不会替换矿石。
• add\_conversion\_recipes：启用或禁用将变种转换回基础矿石的配方。

所有其他配置都通过 globalresources 文件夹加载。你可以直接在其中添加新的配置文件；如果想提取内置
配置并进行编辑，请打开 defaultresources.json 配置文件。内容应如下所示：

{
  "extract": {
    "excavated_variants": "unextracted"
  }
}

将 unextracted 改为 extract，然后启动游戏一次。之后即可在 globalresources 文件夹中编辑默认配置。

注意：如果你只是想添加更多配置，则无需（也不应该）这样做。你可以直接添加新的配置文件，无需提取现有配置。

配置定义了四种主要数据类型：

• 地面类型：地面类型代表矿石和石头的类别。它们用于确定应创建哪些新的矿石/石头组合（变体）。例如：excavated_variants:overworld 是普通 Minecraft 石头、深板岩和主世界矿石共享的一个类别。
• 矿石：矿石是可以存在于任意数量不同石头中的方块类型。在世界生成期间，它们会被替换为与相邻石头匹配的变体。例如：excavated_variants:minecraft/iron_ore 同时代表普通铁矿石和深板岩铁矿石，以及任何其他生成的变体。
• 石头：石头是矿石生成于其中的方块。例如：excavated_variants:minecraft/granite 代表花岗岩，并包含基于花岗岩生成哪些新变体的信息。
• 修饰符：修饰符用于修改变体的属性。它们可用于添加标签、更改方块属性、阻止变体创建等。

除非被修饰符更改，否则会为所有共享地面类型且尚未拥有变体的矿石/石头组合生成变体。

地面类型

放置在 globalresources/[folder/pack]/globaldata/[namespace]/excavated_variants/ground_type 中。它们是具有以下结构的 JSON 文件：

• （无内容）：这些实际上还不包含任何数据！只需使用一个空的 JSON 文件：{}。

矿石

放置在 globalresources/[folder/pack]/globaldata/[namespace]/excavated_variants/ore 中。它们是具有以下结构的 JSON 文件：

• types：此矿石可以生成于其中的地面类型列表。例如：["excavated_variants:overworld"]。
• translations：一个对象，以区域设置（如 en_us）为键，以矿石的翻译名称为值。翻译名称前会加上石头名称，除非翻译中包含 %s，此时石头名称将插入到该位置。
• tags：此矿石的变体将添加到的标签列表，同时作为方块标签和物品标签。
• blocks：一个映射，表示此矿石的变体与石头的配对。每个键是代表矿石变体的方块标识符。值采用以下两种形式之一：
• 一个字符串，代表石头的标识符。例如："excavated_variants:minecraft/granite"。如果方块 ID 命名空间对应的模组存在，则假定此变体存在。
• 一个具有以下字段的对象：
• stone：一个字符串，代表石头的标识符。例如："excavated_variants:minecraft/granite"。
• required_mods：必须存在才能生成此变体的模组 ID 列表。例如：["spelunkery", "create"]。
• generating：（可选，默认为 true）此变体是否可用作新生成变体的父级。

石头

放置在 globalresources/[folder/pack]/globaldata/[namespace]/excavated_variants/stone 中。它们是具有以下结构的 JSON 文件：

• types：此石头可以生成于其中的地面类型列表。例如：["excavated_variants:overworld"]。
• translations：一个对象，以区域设置（如 en_us）为键，以石头的翻译名称为值。
• block：对应此石头的方块标识符。例如："minecraft:granite"。
• ore_tags：此石头的矿石变体将添加到的标签列表，同时作为方块标签和物品标签。

修饰符

放置在 globalresources/[folder/pack]/globaldata/[namespace]/excavated_variants/modifier 中。它们是具有以下结构的 JSON 文件：

• tags：（可选）一个标签列表，匹配过滤器的变体会被添加到这些标签中。可以是方块标签或物品标签，格式为 "namespace:[blocks/items]/path"。
• flags：（可选）一个标志列表，来自以下集合，将应用于匹配的变体：
• "original_without_silk"：变体应掉落其原始方块会掉落的物品，除非使用了精准采集。请注意，此标志对于任何具有掉落“粗矿块”或类似行为特性的矿石方块无关紧要，仅在原始方块掉落自身时相关。
• "original_always"：变体应始终掉落其原始方块会掉落的物品，即使使用了精准采集。
• "disable"：该变体不应由模组生成或识别。
• "non_generating"：该变体不应作为新变体的父级使用，但模组仍然知晓它。
• properties：（可选）一个具有以下字段的对象，用于修改生成方块的属性：
• destroy_time：破坏方块所需的时间。
• explosion_resistance：方块的爆炸抗性。
• xp：方块掉落的经验量。可以采用与原版数据包中相同的整数范围形式。
• filter：描述此修饰符应用于哪些变体。

过滤器

修饰符过滤器可以采用字符串或对象的形式。作为对象时，它们至少有一个字段 type，
用于描述过滤器的类型。可用的类型有：

• all 匹配所有内容。
• empty 不匹配任何内容。
• not 匹配其 "filter" 字段未匹配的所有内容。
• and 匹配其 "filters" 字段所有成员都匹配的所有内容。
• or 匹配其 "filters" 字段至少一个成员匹配的所有内容。

作为字符串时，它们采用以下形式之一：

• *：匹配所有内容。
• ~：不匹配任何内容。
• ~[filter]：匹配 [filter] 未匹配的所有内容。
• ground_type@[namespace]:[path]：匹配具有给定地面类型的所有变体。
• stone@[namespace]:[path]：匹配具有给定石头类型的所有变体。
• ore@[namespace]:[path]：匹配具有给定矿石类型的所有变体。
• mod@[mod_id]：匹配所有内容，但仅在存在具有给定 ID 的模组时。
• generated：匹配由模组生成的所有变体。
• block@[namespace]:[path]：匹配具有给定方块 ID 的所有变体。此处提供的命名空间和路径可以使用 * 作为通配符来匹配一个或多个字符。