Curios API Continuation

Важное примечание

Это неофициальное продолжение CuriosAPI от TheIllusiveC4 для NeoForge (в текущем состоянии) и Forge (в будущем). Пожалуйста, не сообщайте TheIllusiveC4 о проблемах с этим портом, вместо этого используйте отдельную страницу проблем на GitHub или приглашение в Discord. Описание и документация мода скоро будут обновлены, так что следите за обновлениями!

Обзор

Curios — это гибкий и расширяемый API аксессуаров/оборудования для пользователей и разработчиков. Цель состоит в том, чтобы предоставить разработчикам возможность добавлять дополнительные слоты для аксессуаров/оборудования удобным и совместимым способом, а также предоставить пользователям возможность настраивать эти слоты по своим предпочтениям. По умолчанию Curios не добавляет никакого контента, кроме графического интерфейса инвентаря. Здесь нет слотов и есть только два элемента, последний доступен только через меню Creative и в основном служит примером для разработчиков, которые они могут использовать при кодировании своей собственной интеграции.

Особенности

• Расширяемые слоты для оборудования через центральную библиотеку. Новые слоты для оборудования можно легко создавать и управлять ими с помощью реестра идентификаторов. Идентичные идентификаторы будут объединены вместе, чтобы избежать функционального дублирования и обеспечить максимальную совместимость с потенциальными элементами, в то время как уникальные идентификаторы по-прежнему могут использоваться для обозначения специальных типов, когда это необходимо.

• Слоты создаются только под заказ. По умолчанию слоты не включены, все слоты создаются только по мере необходимости. Это уменьшает количество случаев, когда один или несколько лишних слотов присутствуют без каких-либо подходящих предметов для помещения в слот.

• Слоты полностью настраиваемы и управляемы. Слоты могут иметь собственный фон, разные размеры и даже могут быть отключены или скрыты по умолчанию. Но как игрок сможет получить доступ к отключенным слотам? Через API разработчики могут получить доступ к функциям включения/отключения слотов игрока или добавления/удаления определенного количества слотов заданного типа.

• Гибкие связи между предметами и диковинками с использованием ванильной системы тегов. Потенциальные сувениры выбираются с помощью системы тегов vanilla, а это означает, что классифицировать предметы по типам сувениров так же просто, как создать файл .json в папке data/curios/tags. Предметы можно разделить на любое количество типов антиквариата, если они помечены в соответствующих файлах, и эти настройки можно даже полностью переопределить. Для получения дополнительной информации см. Ванильную систему тегов. Полная интеграция с другими механиками инвентаря. «Починка» и «Проклятия» будут работать со всеми предметами, установленными в слотах для сувениров. Для разработчиков также предусмотрены различные мелкие функции, которые упрощают интеграцию имеющихся у них предметов или механик в систему сувениров.

• Доступен из одного графического интерфейса. Curios имеет собственный графический интерфейс, доступный из инвентаря, который показывает игроку все доступные слоты. Это позволяет игрокам видеть все расширенные слоты для оборудования в одном месте без необходимости доступа к различным графическим интерфейсам инвентаря. Тем не менее, разработчики по-прежнему могут предоставлять свои собственные графические интерфейсы для своих слотов, специфичных для модов, если захотят. По умолчанию для графического интерфейса используется клавиша «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, которую вы хотите использовать.

Более подробную информацию можно найти здесь.