Curios API (Fabric)

作者：TheIllusiveC4

面向玩家和开发者的灵活、可扩展的饰品/装备前置库。

模组 Fabric 冒险前置库装备

介绍

介绍由机器翻译自 CurseForge 原页面，仅供参考。

此项目适用于 Fabric 加载器。如需查看对应的 Forge 加载器版本，请点击这里。

注意！Fabric 版 Curios 已停止为 1.17 及更高版本提供支持。

请改用 Trinkets API。我参与了它针对 1.17 的重写工作，它应该包含 Curios 的所有必要功能，可作为合适的替代方案。

概述

Curios 是一个灵活且可扩展的饰品/装备前置库，面向用户和开发者。它旨在为开发者提供便捷且兼容的方式，以添加额外的饰品/装备栏位，同时让用户能够按照自己的偏好配置这些栏位。默认情况下，Curios 除了一个物品栏界面外不会添加任何内容。它不包含任何栏位，只有两件物品；后者只能通过创造模式菜单获取，主要作为示例，供开发者在编写自己的兼容内容时使用。

需要 Fabric API。

功能

通过中央前置库扩展装备栏位。 可以通过标识符注册表轻松创建和管理新的装备栏位。相同的标识符会合并在一起，以避免功能重复，并尽可能兼容潜在适用的物品；在适当情况下，也可以使用独特的标识符标记特殊类型。
栏位仅在需要时创建。 默认情况下不包含任何栏位，只有在需要时才会创建。这样可以减少出现多余栏位的情况，避免栏位中没有适用物品可放入。
栏位完全可自定义和调整。 栏位可以使用自定义背景、不同尺寸，甚至可以默认禁用或隐藏。但玩家要如何使用已禁用的栏位呢？开发者可以通过 API 使用相关功能，为玩家启用或禁用栏位，也可以添加或移除指定类型的一定数量栏位。
使用原版标签系统灵活关联物品与饰品。潜在的饰品通过原版标签系统进行选择，因此只需在 data/curios/tags 文件夹中创建 .json 文件，就能轻松将物品归类到饰品类型中。只要在相应文件中添加标签，物品就可以归入任意数量的饰品类型；这些设置甚至可以被完全覆盖。更多信息请参阅原版标签系统。
与其他物品栏机制全面集成。 所有装备在饰品栏位中的适用物品都可以受到修补和诅咒效果的影响。此外，还提供了多种面向开发者的小功能，让他们更轻松地将现有物品或机制集成到饰品系统中。
通过单一 GUI 轻松访问。 Curios 自带一个可从物品栏打开的 GUI，其中会显示玩家可用的所有栏位。玩家可以在一个集中位置查看所有扩展装备栏位，无需打开不同的物品栏 GUI。不过，开发者仍可按需为其模组专属栏位提供自定义 GUI。默认 GUI 按键为“g”。