TFC Registry API

模组

· 作者 Verph

动态发现并统一访问所有由模组添加的 TFC 注册表类型(金属、木材、矿石、岩石、土壤、沙土、土壤变体),适用于任何使用注册表接口的模组。

0 本站下载 0 关注 更新于 11 个月前

需要前置:TerraFirmaCraft

最新 1.2 · 1.21.1 · NeoForge

一键开服(送7天)

TFC Registry API

一个轻量级的库模组,能够自动发现并统一所有由任何模组添加的 TerraFirmaCraft 注册表类型。它适用于任意附加模组,只要它们正确实现了此库的注册表接口或 TFC 自身的接口:

  • RegistryMetal
  • RegistryRock
  • RegistrySoilVariant
  • RegistryWood

由本库提供的注册表类型包括:

  • RegistryOre
  • RegistrySand
  • RegistrySoil

发现机制工作原理

当满足以下条件时,该模组会自动发现所有类型:

  • 该类型实现了正确的 Registry[Type] 接口
  • 该类型是一个 枚举(这是自动发现的必要条件)

如果某个附加模组没有使用枚举,或者需要手动注册,附加模组的开发者仍可以通过直接调用辅助注册方法来支持它:

示例:从非枚举源手动注册土壤变体

SoilVariantRegistryHelper.registerTypes(
    YourSoilVariantClass.class,
    List.of(yourVariant1, yourVariant2, ...),
    "yourmodid"
);

每个辅助类中都有相同的方法:

MetalRegistryHelper.registerTypes(...)
WoodRegistryHelper.registerTypes(...)
RockRegistryHelper.registerTypes(...)
OreRegistryHelper.registerTypes(...)
SoilRegistryHelper.registerTypes(...)
SandRegistryHelper.registerTypes(...)
SoilVariantRegistryHelper.registerTypes(...)

代码示例:

// 金属
List<RegistryMetal> allMetals = MetalRegistryHelper.getAllMetalValues();
RegistryMetal brass = MetalRegistryHelper.getMetalValueOrDefault("brass");

// 木材
List<RegistryWood> allWoods = WoodRegistryHelper.getAllWoodValues();
RegistryWood ebony = WoodRegistryHelper.getWoodValueOrDefault("ebony");

// 岩石
List<RegistryRock> allRocks = RockRegistryHelper.getAllRockValues();
RegistryRock marble = RockRegistryHelper.getRockValueOrDefault("marble");

// 矿石
List<RegistryOre> allOres = OreRegistryHelper.getAllOreValues();
RegistryOre sphalerite = OreRegistryHelper.getOreValueOrDefault("sphalerite");

// 土壤
List<RegistrySoil> allSoils = SoilRegistryHelper.getAllSoilValues();
RegistrySoil duff = SoilRegistryHelper.getSoilValueOrDefault("duff");

// 沙子颜色
List<RegistrySand> allSands = SandRegistryHelper.getAllSandValues();
RegistrySand white = SandRegistryHelper.getSandValueOrDefault("white");

// 土壤变体
List<RegistrySoilVariant> allVariants = SoilVariantRegistryHelper.getAllSoilVariantValues();
RegistrySoilVariant inceptisol = SoilVariantRegistryHelper.getSoilVariantValueOrDefault("inceptisol");

所有 get[Type]ValueOrDefault("name") 方法均不区分大小写,并在未找到时返回安全回退值。

例如,遍历 List<RegistryWood> 列表,可以生成如下木材类型列表,这里展示了安装了 ArborFirmaCraft 的情况:

acacia, ash, aspen, birch, blackwood, chestnut, douglas_fir, hickory, kapok, mangrove, maple, oak, palm, pine, rosewood, sequoia, spruce, sycamore, white_cedar, willow, araucaria, baobab, beech, cypress, eucalyptus, fig, ginkgo, hevea, ipe, ironwood, mahoe, mahogany, teak, tualang

你可以轻松使用辅助类提供的列表/获取器来注册新方块。以下展示了如何为所有已注册的土壤类型和土壤变体添加新的 SoilBlock 的示例:

public static final Map<RegistrySoil, Map<RegistrySoilVariant, Id<Block>>> NEW_SOIL_BLOCKS =
    SoilRegistryHelper.getAllSoilValues().stream()
        .collect(Collectors.toMap(
            type -> type,
            type -> SoilVariantRegistryHelper.getAllSoilVariantValues().stream()
                .collect(Collectors.toMap(
                    variant -> variant,
                    variant -> register(type.toString() + "/" + variant.toString(),
                        () -> new SoilBlock(Block.Properties.of().mapColor(MapColor.DIRT).strength(1.4f), type, variant))
                ))
        ));

例如:如果一个方块/物品/实体等构造函数 坚持 使用诸如 SoilBlockType 之类的类型(如 ConnectedGrassBlock),你可以安全地将来自 RegistrySoil 接口的 soil 强制转换为此类型,像这样 (RegistrySoil)(Object)soil(或者以你喜欢的其他方式进行转换),因为我已让 TFC 的 SoilBlockType 枚举类实现了自定义的 RegistrySoil 接口。

非常适合附加模组、整合包制作者,或任何需要与所有兼容 TFC 的金属、木材、岩石、矿石、土壤、沙子或变体协同工作的场景,无论安装了哪些模组。

例如,你可以使用本库创建的注册表类型列表,轻松为所有或特定类型的所需条目创建新的方块、物品、实体等。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源