Curios API Continuation - Curios API 延续版

重要说明

这是由 TheIllusiveC4 的 CuriosAPI 针对 NeoForge（当前）和 Forge（未来）进行的非官方延续版本。请不要将此移植版本的问题反馈给 TheIllusiveC4，而是使用单独的 github issues 页面或 discord 邀请链接。Mod 描述和文档将很快更新，敬请期待！

概述

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

特性

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

更多信息可在这里找到。