Runtime Registry Extender

模组

· 作者 Nerjal_Nosk

赋能模组作者,使其能够在运行时注册内容

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

最新 0.1-beta.10 · 26.2 · Fabric

一键开服(送7天)

Runtime Registry Extender

一个极其扭曲的库类模组,用于在同样极其扭曲的 Minecraft 注册表(registries)中于运行时添加条目。

请注意,此处的“运行时”仅限于游戏循环的几个阶段,以避免出现随机的破坏性故障。

此外,出于稳定性考虑,此模组仅允许向上述注册表添加新条目,而不允许修改其冻结的基础数据。

这些限制的核心目的是允许服务器/世界为玩家的游戏提供额外的值以供其考量,而无需每次重启游戏或启动完全不同的配置。

目前,只有注册表条目受到影响。任何相关资产(模型、纹理、翻译等)仍必须本地存在或通过其他方式提供(例如服务器资源包、本地存在的资产)。

为了避免给模组作者带来不得不摆弄毫无意义且错综复杂的注册表结构的负担,此模组提供了一些入口点(entrypoints),让模组作者能够相当轻松地设置一切:

  • runtime_registry_extender:extension_setup:必须是 ExtendableRegistryInitializer 类型
    • 在注册表的初始化之前执行!注意你的静态值!
    • 允许提供需要使哪些注册表变为可扩展的注册表键。
      • 其他注册表不会被设为可扩展!请确保为你所有的需求提供它。
    • 允许提供无效方块状态适配器(invalid block states adapters),从而用另一个未知的方块状态替换任何未知状态。
      • 这些仅在方块状态下执行。未来将致力于支持其他数据类型。
      • 这仅影响方块状态,方块实体数据尚未(?)能通过此类方式适配。
      • 适配器仅接收从区域文件中读取的原始 NBT 格式数据,并返回理论上有效的 NBT 数据。
  • runtime_registry_extender:values_loader:必须是 RegistryExtensionLoader 类型
    • 允许注册扩展值。为未设为可扩展的注册表提供的任何值都会导致问题。 它分为内置注册表的扩展值注册和可重载注册表的扩展值注册,以确保值既不过早也不过晚注册,同时仍能访问适当的数据源。(即允许基于数据驱动的功能注册条目)
    • 在数据重载开始时执行,在其他重载之前进行,以确保为后续阶段提供扩展条目。(例如,确保在加载标签时能够访问扩展条目)
    • 允许提供无效元素适配器(invalid elements adapters),从而用另一个未知元素替换任何未知元素。
      • 未来将支持其他数据类型。
      • 适配器仅接收从区域文件中读取的原始 NBT 格式数据,并返回理论上有效的 NBT 数据。
      • 你只能针对每个元素命名空间和每个适配器名称,为每种元素类型(方块状态、物品堆叠...)注册一个适配器。尝试注册重复项将被忽略。
      • 截至目前,适配器支持以下类型:方块状态、流体状态、物品堆叠、生物效果(mob effects)和方块实体类型。
    • 该入口点始终提供一个辅助工具,用于注册各种更为棘手的元素类型,这些类型可能需要一些注册后处理,或者不是标准注册的。例如,方块和流体注册辅助方法将自动处理注册适当的方块状态和流体状态。

平台

此模组专为 Fabric 加载器制作,并且将仅支持 Fabric。

我毫不怀疑此模组会在基于 Forge 的加载器上崩溃。 并且尝试使用 Sinytra 加载它可能也无法工作。

此模组以与基于 Forge 的工具链不兼容的方式重新实现了注册表,而我既不愿意投入精力为其 NeoForge 制作等效版本,也不赞同人们为此移植此模组。如果你想知道,许可证禁止分发未经授权的移植版,并且我预先通知你对移植到上述工具链或其前身版本的严格拒绝态度。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源