Curios API - Curios API（饰品接口）

概述

Curios 是一个灵活且可扩展的饰品/装备 API，面向用户和开发者。其目的是为开发者提供一种方便且兼容的方式来添加额外的饰品/装备槽位，同时也让用户能够根据自己的偏好配置这些槽位。默认情况下，Curios 除了一个物品栏 GUI 之外不会添加任何内容。默认没有任何槽位，且只有两个物品，后者只能通过创造模式菜单获得，主要作为开发者在编写自己的集成时使用的示例。

特性

• 通过中央库扩展装备槽位。 新的装备槽位可以通过标识符注册表轻松创建和管理。相同的标识符会被合并，以避免功能冗余并为潜在物品提供最大兼容性；而唯一标识符在适当情况下仍可用于标记特殊类型。
• 槽位仅按需创建。 默认不包含任何槽位，所有槽位都只会在需要时创建。这减少了在没有合适物品可放入时出现一个或多个多余槽位的情况。
• 槽位可完全自定义和操作。 槽位可以拥有自定义背景、不同尺寸，甚至默认禁用或隐藏。但玩家要如何访问被禁用的槽位呢？通过 API，开发者可以调用函数来启用/禁用玩家的槽位，或为给定类型添加/移除一定数量的槽位。
• 使用原版标签系统实现灵活的 item->curio 关系。 潜在的 curios 通过原版标签系统进行选择，这意味着将物品归类到 curio 类型就像在 data/curios/tags 文件夹中创建一个 .json 文件一样简单。只要在相应文件中打上标签，物品就可以被归入任意多个 curio 类型，并且这些设置甚至可以被完全覆盖。更多信息请参见原版标签系统。
• 与其他物品栏机制完整集成。 经验修补和诅咒会对所有装备在 curio 槽位中的适用物品生效。对于开发者而言，还有各种小功能，使他们更容易将现有物品或机制集成到 curio 系统中。
• 可从单一 GUI 访问。 Curios 自带一个可从物品栏打开的 GUI，用于显示玩家所有可用的槽位。这使玩家无需访问不同的物品栏 GUI，就能在一个中心位置查看所有扩展装备槽位。不过，如果开发者愿意，仍然可以为其模组专属槽位提供自己的 GUI。该 GUI 的默认按键绑定为 g。

文档

• 搭建开发环境
• 槽位
• 示例数据包
• 槽位配置
• 命令
• 适用于 1.19.x 及以下版本的旧版文档