Modify Drops API

Modify Drops API предоставляет разработчикам расширенные возможности для управления выпадением предметов в Minecraft. Этот инструмент создаёт сложные и контекстно-зависимые системы дропа, изначально разработанный для модов Chest Cavity и Hellish Materials, но одинаково полезный для любого создателя контента, желающего получить полный контроль над таблицами лута.

Принцип работы

Когда игра генерирует лут из таблицы дропа (даже если результат — пустота), API последовательно запускает три события: GenerateLootCallbackAddLoot, GenerateLootCallbackModifyLoot и GenerateLootCallbackAddUnmodifiableLoot.

Обработчики GenerateLootCallbackAddLoot принимают тип контекста лута (LootContextType) и сам контекст (LootContext), возвращая список предметов (List). Все элементы из этого списка добавляются к существующему дропу. Для удобства доступны специализированные события GenerateEntity и GenerateBlockLootCallbackAddLoot, которые автоматически срабатывают для соответствующих типов контекста.

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

GenerateLootCallbackAddUnmodifiableLoot функционирует аналогично AddLoot, но выполняется после ModifyLoot, что делает его идеальным для добавления предметов, которые не должны изменяться другими обработчиками.

Подключение к проекту

Для использования Modify Drops API в своём моде добавьте в раздел зависимостей файла build.gradle следующую строку:

modApi "com.github.tigereye504:modify-drops-api:x.x.x"

При необходимости можно встроить API непосредственно в свой мод, добавив дополнительную зависимость:

include "com.github.tigereye504:modify-drops-api:x.x.x"

Где x.x.x — версия API, которую вы хотите использовать.