军械库 API

一个轻量级的跨加载器 API,用于定义可自定义的工具和盔甲套装

基础库

Armory API

Armory API 是一个轻量级库,为 Minecraft 模组中定义和管理工具套组与盔甲套组提供共享代码。

该项目从 XunLib 中提取,以独立支持 Forge,并保持 API 的轻量化、模块化和加载器无关性。

支持的加载器:

  • Forge
  • NeoForge
  • Fabric

特性

  • 用于定义 ToolSet 和 ArmorSet 的 API
  • 减少注册工具和盔甲时的重复代码
  • 与加载器无关的实现
  • 范围小、依赖少
  • 兼容模组添加的工具类型

常见问题

我可以只使用 ToolSet 或只使用 ArmorSet 吗?
可以。这两个系统相互独立,可以分开使用。

这会自动处理物品注册吗?
不会。注册由使用该库的模组或特定加载器的实现来处理。

我可以用它创建自定义工具或盔甲行为吗?
可以。Armory API 包含用于实现自定义工具和盔甲行为的辅助 API,允许模组在原版行为之外扩展或自定义功能。

我可以添加自定义或模组添加的工具类型吗? 可以。ToolPieceType 专门设计用于支持自定义工具类别,可拥有自己的物品工厂、统计数据、属性和特性。

一个 ToolSet 可以只包含部分工具类型吗? 可以。ToolSet 不再局限于标准的原版工具集合。可以包含受支持的 ToolPieceType 实例的任意组合。

其他库或框架可以与 Armory API 集成吗?
可以。该 API 设计为保持轻量和模块化,因此如果需要,可以集成到更大的模组框架中。

依赖

Armory API 是一个库模组,仅被显式依赖它的模组所需要。

Armory API 不替代加载器的物品注册系统,也不要求使用它的模组采用特定的注册框架。


注意:模组 ID 为 armories,以避免与其他使用类似名称的模组冲突。