Nexus API

Nexus API

Nexus 是一个库模组，其核心目标是在保证高效和优化的前提下，尽可能简化开发流程，尤其是在 Multiloader 项目设置中。它引入了相当庞大的抽象集合和其他便捷功能，同时不会强迫开发者严格遵守更高层次上的约定。简而言之，它为开发者提供了能大幅简化或消除重复性任务的工具，而不会过度限制，以至于开发者只能使用它所提供的内容。

功能特性

全面的跨平台注册系统：允许跨平台进行对象注册。然而，与其他基于注册表的库不同，Nexus API 的注册器在简单的注册钩子之外，还为其他方面提供了广泛的功能。

实用的跨平台工具类：提供方法来检索不同加载器特定实现的大量信息。例如模组数据、环境侧（客户端/服务端）等。

直观的跨平台网络系统：抽象了不同网络实现的差异，从而使开发者能够专注于编写用于同步信息的数据包，而无需担心内部的细微差别。

全面的跨平台数据生成系统：在多平台项目设置中，数据生成（Datagen）通常是一个未被触及的模组开发组件，这主要是因为选择一个单一的加载器（通常是 Neo/Forge）并将其生成的数据输出到你的公共源集就足够了。Nexus API 提供了与加载器无关的数据生成，它在所有受支持的加载器上都能确定性地工作，并拥有自己易于配置的系统，使编写代码这一通常繁琐的方面变得无缝且高效。

属性包装器：一个兼具易用性和效率的全面工具。属性包装器描述了 Nexus API 提供的一个系统，它允许开发者正确地模板化并编写所有类型的对象以及任何共享/关联的属性。

新颖、易用且强大的事件系统：Nexus API 添加了其自身非侵入性但功能强大的事件系统，该系统能在所有加载器上干净地交互，并且不会造成负面性能影响。

开发者应参考 Nexus API Wiki，以获取 Nexus API 提供的所有功能的正确概述和详细描述。

前置要求

对于 1.20.1 上的 Fabric，需要 Fabric API 0.96.2+1.20.1 或更高版本。

常见问题解答

问：Nexus API 是为谁设计的？

答：Nexus API 主要面向经常使用 Multiloader（或类似）项目设置的开发者。此外，当开发者仅使用一个特定加载器时，尤其是在中型或大型项目中使用时，它也能提供显著的好处。

问：为什么使用 Nexus API？为什么不选择像 Architectury 这样已有的平台？

答：Nexus API 提供了自己的功能集，以节省开发者编写可能在不同加载器之间存在兼容性问题的、繁琐的样板代码的时间。与 Architectury 不同，Nexus API 没有你需要为了最大化效率而偏好使用的平台生态系统——它更像是一个一站式工具，供希望快速高效地完成任务，同时保持兼容性和质量的开发者使用。

问：Nexus API 有多沉重？

答：Nexus API 中大部分"消耗性能"的操作都在启动期间完成。即便如此，对于标准整合包，Nexus API 本身也只为启动时间增加了微不足道的毫秒数（在 Forge 上使用内容较多的模组且较重的整合包中为 4 到 10 秒，在 Xeon e5 2620 v4 CPU 上使用类似重量级整合包且包含约 390 个模组（包括诸如 Cataclysm 和 Cobblemon 等内容型模组）的 Fabric 上为 10 到 20 秒。在更现代的硬件上，这些时间实际上会减半）。至于游戏内的运行时性能，Nexus API 经过了高度优化，在各个方面几乎不会产生任何明显的性能影响。换句话说，它的优化程度足以让你（作为用户和/或终端开发者）无需担心它，无论是否使用性能优化模组。