Unified API

О проекте

Unified API — это кросс-загрузочный API для Fabric и NeoForge, который позволяет создавать мультизагрузочные моды без дополнительных усилий.

Это также библиотека, ориентированная на данные, которая предоставляет мощные новые возможности для датапаков и ресурспаков, включая блоки, предметы, варианты сущностей на основе данных и многое другое.

Кроме того, эта библиотека представляет собой продвинутый генератор данных для моддеров с унифицированными генераторами регистрации, которые объединяют весь ваш код блоков, предметов и сущностей в одном месте.

Цель этого проекта — предоставить актуальный, эффективный и гибкий способ создания модифицированного контента гораздо быстрее, чем это обычно позволяют как конкурирующие мультизагрузочные проекты, так и сами официальные загрузчики.

Чтобы убедиться в истинном масштабе этих возможностей, вам нужно посетить Документацию Unified API.

Ключевые возможности

Генерация регистрации «всё в одном».

Регистрируйте свой контент в одном месте. Всё поведение обрабатывается ванильным JSON и JSON, специфичным для Unified API, сгенерированным из этого кода. Затем JSON может быть переопределён пользователями или другими проектами для полной кастомизации.

public static final SuppliedItem EXAMPLE_ITEM = ITEMS.register(
        "example_item",
        VanillaItemCodecs.ITEM.create(),
        builder -> builder
                .properties(properties -> properties
                        .stacksTo(16)
                        .rarity(Rarity.UNCOMMON)
                )
                .assets(assets -> assets
                        .handheld()
                )
                .data(data -> data
                        .dropSelf()
                )
);

Реестры на основе данных

Блоки, предметы, сущности, творческие вкладки, звуковые события и многое другое можно создавать через JSON.

{
  "type": "minecraft:block",
  "properties": {
     // properties go here
  }
}

Традиционное отложенное выполнение для мультизагрузчиков

В мультизагрузочной среде ваш контент должен быть отложен. UnifiedRegistries в связке с `Supplied

Обширные события и помощники

Изменяйте атрибуты или особенности биомов, меняйте стандартные компоненты, внедряйте таблицы добычи или изменяйте отдельные записи, создавайте варианты мобов и многое другое — всё это поддерживается как через события в коде, так и через слушатели на основе данных.

Кроме того, здесь есть полноценный API для сетевого взаимодействия, привязки данных, музыка для конкретных структур и всё остальное, что может понадобиться при создании сложных модов.

Мгновенное создание целых наборов

Обычный, утомительный в создании контент, такой как наборы древесины, наборы кирпичей, цветные наборы, наборы экипировки и многое другое, можно сгенерировать как JSON в один миг, со всей функциональностью, на которую вы обычно тратите уйму времени вручную. Сокращение бессмысленной рутины было главным мотиватором при создании Unified API вместо использования уже существующих решений.

И ещё невероятно много всего

Цель Unified API — кардинально сократить время, необходимое для добавления модифицированного контента, а также открыть множество новых возможностей для немоддеров. Вам не нужно использовать другой API вместе с этим, а миграция с ваших существующих систем должна быть относительно простой, учитывая наличие более традиционных реестров наряду с новыми, более гибкими возможностями.

И снова: обязательно загляните на unified-api.dev, чтобы ознакомиться с документацией и полным набором возможностей!