Curios API Continuation

重要说明

这是 TheIllusiveC4 的 CuriosAPI 的非官方延续版本，目前支持 NeoForge，未来将支持 Forge。请不要将此移植版的问题报告给 TheIllusiveC4，请使用独立的 GitHub issues 页面或 Discord 邀请链接。模组描述和文档将很快更新，敬请期待！

概述

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

功能

• 通过中央库实现可扩展的装备槽位。可以通过标识符注册表轻松创建和管理新的装备槽位。相同的标识符将合并在一起，以避免功能冗余并为潜在物品提供最大兼容性，而独特的标识符仍可在适当时用于标记特殊类型。
• 槽位仅在需要时创建。默认不包含任何槽位，所有槽位仅在需要时创建。这减少了存在一个或多个多余槽位却没有合适物品放入其中的情况。
• 槽位完全可自定义和操作。槽位可以具有自定义背景、不同尺寸，甚至可以默认禁用或隐藏。但玩家如何访问禁用的槽位？通过 API，开发者可以访问函数来启用/禁用玩家的槽位，或添加/移除给定类型的若干槽位。
• 使用原版标签系统实现灵活的物品 → 饰品关系。潜在的饰品通过原版标签系统选择，这意味着将物品分类为饰品类型就像在 data/curios/tags 文件夹中创建一个 .json 文件一样简单。只要在适当的文件中标记，物品就可以分类为你想要的任意多种饰品类型，这些设置甚至可以完全覆盖。更多信息请参阅原版标签系统。
• 与其他物品栏机制完全集成。经验修补和诅咒将适用于装备在饰品槽位中的所有适用物品。还有各种为开发者提供的次要功能，使其更简单地将当前物品或机制集成到饰品系统中。
• 从单个 GUI 访问。Curios 自带一个可从物品栏访问的 GUI，显示玩家所有可用的槽位。这允许玩家在中心位置查看所有扩展装备槽位，而无需访问不同的物品栏 GUI。但是，如果需要，开发者仍然可以为他们特定模组的槽位提供自己的 GUI。GUI 的默认按键为 'g'。

文档

如果你是开发者，请将以下内容添加到你的 build.gradle 文件中：

repositories {
    maven {
        name = "OctoStudios"
        url = uri("https://maven.octo-studios.com/releases")
    }
}

dependencies {
    implementation 'top.theillusivec4.curios:curios-neoforge:${version}'
}

将 ${version} 替换为你想要使用的 Curios 版本。

更多信息可以在此处找到。