Интеграция с воронками и автоматизацией (MC 26.1.2)
Этот документ описывает механику извлечения воронками, соответствие скорости передачи, стабильность сортировщиков и работу с контейнерами в Minecraft 26.1.2.
📊 Информационный блок функции
| Свойство | Спецификация |
|---|---|
| Имя системы | Движок капельного извлечения в воронки |
| Целевой класс | net.minecraft.world.level.block.entity.HopperBlockEntity |
| Метод извлечения | HopperBlockEntity.addItem(Container, ItemEntity) |
| Скорость извлечения | $1\text{ предмет за } 8\text{ тиков}$ ($2.5\text{ предм/с}$) |
| Стратегия среза предмета | baseItem.setCount(1) |
| Совместимость с автоматизацией | 100% совместимость с ванильными сортировщиками и фильтрами |
⚙️ Архитектура капельного извлечения в автоматизации
В ванильном Minecraft воронки втягивают сущность целиком, если размер стака $\le 64$ и в воронке есть место. Если бы воронка попыталась поглотить скопление из $5,000$ предметов, это переполнило бы воронку или уничтожило тысячи предметов.
Item Clumps перехватывает метод HopperBlockEntity.addItem, обеспечивая капельное извлечение:
┌────────────────────────────┐
│ Hopper Tick Cycle │
│ (Every 8 Game Ticks) │
└─────────────┬──────────────┘
│
▼
┌────────────────────────────┐
│ Is Item Entity Count > 1? │
└─────────────┬──────────────┘
│
┌────────────────┴────────────────┐
│ (Yes) │ (No)
▼ ▼
┌───────────────────────────┐ ┌───────────────────────────┐
│ Clone Single Item Slice │ │ Native Vanilla Extraction │
│ baseItem = stack.copy() │ │ (Standard 1-item / stack) │
│ baseItem.setCount(1) │ └───────────────────────────┘
└─────────────┬─────────────┘
│
▼
┌───────────────────────────┐
│ Try Insert Into Hopper │
│ HopperBlockEntity.addItem │
└─────────────┬─────────────┘
│
┌────────┴────────┐
│ │
(Success) (Failed / Full)
│ │
▼ ▼
┌───────────────────┐ ┌───────────────┐
│ Shrink Ground │ │ Abort Transfer│
│ Clump by 1; │ │ Entity Retains│
│ Refresh Name Tag. │ │ Full Count. │
└───────────────────┘ └───────────────┘💻 Исходный код реализации на Java
Из HopperBlockEntityMixin.java в Minecraft 26.1.2:
java
@Inject(method = "addItem(Lnet/minecraft/world/Container;Lnet/minecraft/world/entity/item/ItemEntity;)Z", at = @At("HEAD"), cancellable = true)
private static void item_clumps$customHopperExtract(Container container, ItemEntity entity, CallbackInfoReturnable<Boolean> cir) {
ItemStack itemStack = entity.getItem();
int count = itemStack.getCount();
if (count > 1) {
// Entity is a clump. Extract exactly 1 item.
ItemStack baseItem = itemStack.copy();
baseItem.setCount(1);
ItemStack result = HopperBlockEntity.addItem(null, container, baseItem, null);
if (result.isEmpty()) {
// Hopper successfully absorbed the 1 item. Shrink entity stack.
ItemStack originalStack = entity.getItem();
originalStack.shrink(1);
entity.setItem(originalStack); // Updates standard item tracker and custom name
cir.setReturnValue(true);
} else {
// Hopper was full or couldn't take it
cir.setReturnValue(false);
}
}
}