Common Storage Lib

通用存储库

CSL 致力于接续 Botarium 的工作，推动实现真正跨平台的存储方案。与前身一样，CSL 允许开发者编写与平台无关的存储代码，并将其注册到 Fabric 和 NeoForge 各自的 API 中。它沿用了 Fabric Storage API 的不可变资源和物品上下文，同时采用了 Forge 的模拟系统。

与前身不同，CSL 也开放了那些实现抽象功能的工具，供你使用。因此，除了存储抽象，CSL 还提供流体资源和配方材料的抽象、NeoForge 与 Fabric 提供的数据附件系统抽象，以及两种加载器各自“实体系统”API 的抽象（NeoForge 的能力系统和 Fabric 的 ApiLookup）。这些 API 分别位于独立模块中，你可以将它们单独用于自己的项目，无需使用存储抽象。

致非跨平台开发者

对于仅面向 NeoForge 或 Fabric 的项目，CSL 也有一些优势。对 NeoForge 开发者而言，不可变资源和物品上下文在存储场景中非常实用。如果你使用物品上下文，CSL 会自动处理其他模组对你物品的使用。Fabric 开发者可能会考虑用 CSL 来绕过 Fabric 的事务系统。不过需要注意：由于存储仍需注册到 Fabric Storage，因此要确保你的存储实现支持回滚。相关文档很快就会提供，但 CSL 已原生支持这一功能。希望存储在 Fabric 上正常运行的开发者，也应确保自己的存储实现支持回滚。

CSL 目前处于 Alpha 阶段

CSL 0.0.0 提供了 Botarium 的全部功能，并增加了更多内容。Botarium 仅支持能量物品/方块和流体物品/方块；CSL 则支持能量物品/方块/实体、流体物品/方块/实体，以及物品物品/方块/实体，并与 NeoForge 和 Fabric 的传输 API 完全兼容。虽然已经进行了一些初步测试，但项目仍处于非常早期的阶段。

请注意：

Fabric 原生不支持物品中的物品存储、实体中的能量存储或实体中的流体存储。CSL 会在自己的命名空间下注册这些查询接口，因此，选择使用 CSL 实现这些特定能力的模组彼此兼容，但无法与其他模组兼容。这是 Fabric 特有的问题，因为 Fabric 目前没有为这些能力提供 ApiLookup。不过，能量物品/方块、流体物品/方块以及物品实体/方块都兼容更广泛的 Fabric 和 NeoForge 模组生态；NeoForge 也会自动兼容上述查询接口类型。

社交媒体

看看我们的其他项目