TooManyRecipeViewers

模组

· 作者 Nolij

由 Nolij 编写的用于在 EMI 中运行 JEI 插件的兼容层

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

需要前置:EMI

最新 0.9.0+mc.21.1 · 1.21.1 · NeoForge

一键开服(送7天)

重要许可证声明

以任何形式使用本项目,即表示您对本项目许可证条款(见 License)给予“明确同意”,并确认我(本项目的作者)已履行许可证规定的义务,即“在现有情况下做出合理努力以获取接收者对本许可证条款的明确同意”。

TooManyRecipeViewers

TooManyRecipeViewers(简称 TMRV)是一个兼容层,由 Nolij 编写,用于在不安装 JEI 的情况下,让 EMI 运行 JEI 插件。

你需要安装 EMI 才能使用此模组。

为什么选择 TMRV 而不是 EMI+JEI(即 JEMI)?

JEMI 是内置于 EMI 中的一个兼容层,旨在通过大量依赖 JEI 的内部机制,使 JEI 插件在 EMI 中基本可用。它的设计尽可能简单,依赖于 JEI 先处理配方数据,然后再将其导入到 EMI 中。

TMRV 与 JEMI 不同——它旨在完全替换 JEI API(注意:TMRV 包含一些未修改的 JEI 内部代码——详见 JEI Code Re-Use)。TMRV(在可行的情况下)将 JEI API 替换为直接映射到 EMI API 的代码,而不是加载整个 JEI 注册表并在事后查询它。这带来了几个优势,包括更有效地利用系统资源,但这也是一项权衡,因为 TMRV 的方法使得维护工作远比 JEMI 复杂。JEMI 故意这样设计,以便让 EMI 的开发能够专注于改进 EMI 本身,我完全支持这种做法。

TL;DR:TMRV 比 JEMI 效率高得多,代价是维护成本远高于 JEMI,且不应期望 EMI 投入如此多的精力来支持一个在设计时有意未引用的 API。请庆幸 EMI 从一开始就能开箱即用加载 JEI 插件——这也确实花了相当大的功夫。

话虽如此,TMRV 相比 JEMI 有两个主要优势:

1. 插件兼容性

TMRV 对 JEI API 的支持覆盖范围比 JEMI 更广(有一个例外——见 Known API Limitations)。截至撰写本文时,这包括:

  • 更好的内置配方类型转换(JEMI 仅支持合成和信息配方类型;TMRV 支持所有内置的 JEI 配方类型)
  • 支持原料/搜索别名
  • createRecipeExtras 支持

2. 效率

使用 TMRV 时,你进入世界的速度总是快于使用 JEMI。这是因为 JEI 插件初始化会阻塞世界加载——在所有 JEI 插件初始化完成之前,你无法开始游戏。而 EMI 在世界加载后异步加载插件。

这意味着,即使 TMRV 加载 JEI 插件的速度比 JEI 慢(事实并非如此,它的加载速度明显更快——见 benchmarks),世界也始终会比使用 JEMI 时加载得更快。

如前所述,TMRV 将大部分 JEI API 替换为对应 EMI API 的映射器——这意味着可以彻底移除 JEI 内部结构的很大一部分。无需初始化和存储整个 JEI 配方注册表——TMRV 只需将 JEI API 调用转换为 EMI 调用,并将响应转换为 JEI 格式。可以将 TMRV 比作 Wine 或 Proton,而将 JEMI 比作虚拟机。JEMI 使用真实的 JEI,因此可能会出现某些场景下 TMRV 报错而 JEMI 不会的情况(请注意,这并不一定意味着 JEMI 正确支持该场景,只是看起来像那样),但总体而言,TMRV 的效率会高于 JEMI。

基准测试

完整的结果和获取这些结果所遵循的步骤记录在 BENCHMARKS.md 中。这些结果并非经过挑选。说明文件中的步骤被严格遵照执行。我鼓励社区进行验证。

加载时间

TMRV JEMI Comparison
Craftoria 1582ms (世界加载前 5ms,世界加载后 1577ms) 11036ms (世界加载前 10000ms,世界加载后 1036ms) -9454ms (世界加载前 -9995ms,世界加载后 +541ms)
ATM10 4951ms (世界加载前 3ms,世界加载后 4948ms) 20132ms (世界加载前 15550ms,世界加载后 4582ms) -15181ms (世界加载前 -15547ms,世界加载后 +366ms)
Finality: Omnia 3010ms (世界加载前 6ms,世界加载后 3004ms) 6354ms (世界加载前 4425ms,世界加载后 1929ms) -3344ms (世界加载前 -4419ms,世界加载后 +1075ms)

内存占用

TMRV JEMI Comparison
Craftoria 4.278 GiB 4.386 GiB -110.6 MiB (近似值)
ATM10 4.401 GiB 5.273 GiB -892.9 MiB (近似值)
Finality: Omnia 1.947 GiB 2.065 GiB -120.8 MiB (近似值)

已知的 API 限制

JEI 配置文件

.minecraft/config/jei/blacklist.json 是 TMRV 唯一读取的 JEI 配置文件。该文件对于原版原料类型以及由 JEI 插件添加的模组原料类型应该能正常工作(这不包括原生同时支持 JEI 和 EMI 的模组,例如 Mekanism)。这是为了作为从 JEI 切换过来的整合包的权宜之计。JEMI 也存在类似的缺陷。EMI 有自己的隐藏原料配置——请使用那个配置。TMRV 完全忽略其他所有 JEI 配置文件,并且没有计划支持它们。

Recipe Manager Plugins

JEI API 支持“配方管理器插件”(Recipe Manager Plugins)。这些插件允许模组自行控制其配方注册表,并在运行时处理配方查询。

TMRV 将尝试从这些插件中提取配方,但这在大多数插件上并不生效,且远未达到对该功能的完善支持。目前暂无计划提供超出此范围的支持。配方管理器插件是一个过时的概念,极少有插件仍在沿用;若要对其进行妥善支持,则必须使用侵入性极强的 EMI mixin——而这并非本项目所打算采用的方案。

运行时注册表更改

JEI API 支持在运行时(即插件注册完成后)修改配方和物品注册表。这一概念与 EMI 不兼容,且我不希望支持此类做法。因此,在 IModPlugin.onRuntimeAvailable 被调用后,若再尝试调用任何用于运行时注册表修改的 API,都将抛出 IllegalStateException,以避免潜在的混淆。

JEI 代码复用

计划在后续更新中替换更多 JEI 的内部实现。然而,出于各种原因,JEI 的部分内容并无重新实现的必要。无论如何,TMRV 已经替换了足够多的 JEI 内部逻辑,我可以自信地说:

  1. 通过 mixin 来实现对 JEMI 的同等优化是不可行的(至少无法以合理的方式实现),并且
  2. 已有足够多的 JEI 内部实现被替换或移除,因此我认为这并未对 JEI 造成不公平,尤其是考虑到 JEI 的许可证 明确允许此类行为。

许可证

本项目采用 OSL-3.0 许可证授权。更多信息请参阅 LICENSE。

部分代码遵循其版权许可证要求,从 EMI 和 JEI 复制而来。本项目中存在的所有修改均与项目其余部分一样,采用 OSL-3.0 许可证授权。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源