Nexus API

Nexus API

大量面向平台的通用工具,旨在减少样板代码/兼容性问题,从而简化 MultiLoader 及其他平台上的模组开发。

基础库

Nexus API

Nexus 是一个库模组,其核心目标是在保持高效与优化的同时,尽可能简化开发流程,尤其是在 Multiloader 项目配置中。它引入了相当大量的抽象和其他便利设施,而不会强迫开发者严格遵循更高层面的约定。简而言之,它为开发者提供的工具能够大幅简化/消除冗余任务,同时又不会过度呵护开发者,以至于除了使用它提供的东西之外什么都做不了。

特性

  • 全面的平台无关注册系统:允许跨平台进行对象注册。然而,与其他基于注册器的库不同,Nexus API 的注册器在简单注册钩子之外的其他方面提供了广泛的功能。
  • 实用的平台无关工具:提供获取不同加载器特定实现的大量信息的方法。例如模组数据、环境侧等。
  • 直观的平台无关网络:抽象了不同网络的奇特之处,从而让开发者可以专注于编写数据包以同步信息,而无需担心内部怪癖。
  • 总括性的平台无关数据生成系统:在多平台项目配置中,数据生成是模组开发中经常被忽视的组成部分,主要是因为选择一个单一加载器(通常是 Neo/Forge)并将其生成的数据输出到你的通用源码集就足够了。Nexus API 提供了加载器无关的数据生成,在所有受支持的加载器上以确定性的方式工作,并拥有自己易于配置的系统,使编写代码这一通常繁琐的方面变得无缝且高效。
  • 属性包装器:一个详尽的无实用工具,将易用性与效率融为一体。属性包装器描述了 Nexus API 提供的一个系统,允许开发者正确地模板化并编写所有类型的对象以及任何共享/关联属性。
  • 全新、易用且强大的事件系统:Nexus API 添加了自己的非侵入式但强大的事件系统,可在所有加载器之间干净地对接,并独立运作而不会施加负面性能影响。

开发者应参阅 Nexus API Wiki,以获取 Nexus API 所提供全部特性的恰当概览和详细描述。

依赖要求

常见问题

问:Nexus API 面向谁?

答:Nexus API 面向经常使用 Multiloader(或类似)项目配置的开发者。当开发者使用单一特定加载器时,它也能提供可观的收益,尤其是在中型或大型项目中使用时。

问:为什么使用 Nexus API?为什么不选择像 Architectury 这样已经存在的平台?

答:Nexus API 提供了自己的功能集,以节省开发者编写在其他加载器之间可能存在兼容性问题的烦人样板代码的时间。与 Architectury 不同,Nexus API 没有那种为了最大化效率而让你更愿意使用的平台生态系统——它更像是为希望快速高效地完成工作,同时保持兼容性和质量的开发者提供的一站式商店。

问:Nexus API 有多重?

答:Nexus API 中大多数"消耗性能"的操作都在启动期间完成。即便如此,Nexus API 本身对标准整合包的启动时间只增加了可忽略不计的毫秒数(在 Forge 上,对于包含更大型内容模组的较重整合包,约为 4 - 10 秒;在 Fabric 上,在 Xeon e5 2620 v4 CPU 上使用类似重量的整合包时,约为 10 - 20 秒——在两种加载器上均使用约 390 个模组进行测试,包括 Cataclysm 和 Cobblemon 等内容密集的模组。在更现代的硬件上,时间实际上会减半)。至于游戏内运行时性能,Nexus API 经过了高度优化,在所有方面几乎不会产生任何明显的性能影响。换句话说,它的优化程度足以让你(作为用户和/或最终开发者)无需担心它,无论是否使用性能优化模组。