Curios API Continuation [Frozen]

作者：SSKirillSS

一个灵活且可扩展的饰品/装备前置库，适用于玩家和开发者【已冻结】

模组 NeoForge 冒险前置库装备

介绍

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

由于原版 CuriosAPI 已恢复开发，此分支现已冻结

重要说明

这是 CuriosAPI 面向 NeoForge 的非官方延续版本。请不要将此移植版的问题反馈给 TheIllusiveC4，请改用单独的 GitHub 问题页面或Discord 邀请链接。模组介绍和文档很快就会更新，敬请期待！

概述

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

功能

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

更多信息请参阅：