Integração com Funis e Automação (MC 26.2)
Este documento detalha a mecânica de extração por funil, paridade de taxa de transferência, estabilidade de separadores de redstone e integração com recipientes do Item Clumps para Minecraft 26.2.
📊 Ficha Técnica do Recurso
| Propriedade | Especificação |
|---|---|
| Nome do Sistema | Motor de Extração por Gotejamento em Funis |
| Classe Alvo | net.minecraft.world.level.block.entity.HopperBlockEntity |
| Método de Extração | HopperBlockEntity.addItem(Container, ItemEntity) |
| Taxa de Extração | $1\text{ item a cada } 8\text{ ticks}$ ($2.5\text{ itens/segundo}$) |
| Estratégia de Redução | originalStack.shrink(1) com atualização de metadados em entity.setItem() |
| Compatibilidade com Automação | 100% compatível com separadores e filtros de itens de Redstone Vanilla |
⚙️ A Arquitetura de Extração por Gotejamento para Automação
No Minecraft Vanilla, os funis extraem instâncias inteiras de ItemEntity se o tamanho da pilha for $\le 64$ e o funil tiver espaço adequado. Se um mod permitisse cegamente que um funil absorvesse um mega-agrupamento com $5.000$ itens, isso transbordaria o funil instantaneamente ou apagaria milhares de itens.
O Item Clumps intercepta HopperBlockEntity.addItem para aplicar a Extração por Gotejamento:
┌────────────────────────────┐
│ Hopper Tick Cycle │
│ (Every 8 Game Ticks) │
└─────────────┬──────────────┘
│
▼
┌────────────────────────────┐
│ Is Item Entity Count > 1? │
└─────────────┬──────────────┘
│
┌────────────────┴────────────────┐
│ (Yes) │ (No)
▼ ▼
┌───────────────────────────┐ ┌───────────────────────────┐
│ Clone Single Item Slice │ │ Native Vanilla Extraction │
│ baseItem = stack.copy(1) │ │ (Standard 1-item / stack) │
└─────────────┬─────────────┘ └───────────────────────────┘
│
▼
┌───────────────────────────┐
│ Try Insert Into Hopper │
│ HopperBlockEntity.addItem │
└─────────────┬─────────────┘
│
┌────────┴────────┐
│ │
(Success) (Failed / Full)
│ │
▼ ▼
┌───────────────────┐ ┌───────────────┐
│ Shrink Ground │ │ Abort Transfer│
│ Clump by 1; │ │ Entity Retains│
│ Refresh Name Tag. │ │ Full Count. │
└───────────────────┘ └───────────────┘⏱️ Taxa de Transferência e Paridade com Classificadores de Redstone
Os funis do Minecraft Vanilla operam em um tempo de espera de 8 ticks ($0.4\text{ segundos}$):
$$\text{Hopper Transfer Rate} = \frac{1\text{ item}}{8\text{ ticks}} = \frac{20\text{ ticks/s}}{8\text{ ticks}} = 2.5\text{ items/second}$$
Como o Item Clumps extrai precisamente $1\text{ item}$ por ciclo:
- Separadores de Itens Padrão: Funis de filtro (com configuração 41-1-1-1-1) drenam os agrupamentos na velocidade exata planejada, sem destravar sinais de comparador ou quebrar a fiação de redstone vizinha.
- Separadores por Correnteza de Água: Agrupamentos massivos fluindo sobre linhas de funis são drenados gradualmente sem entupir o fluxo de água ou causar colisões de entidades.
- Carrinho com Funil: Coleta itens de mega-agrupamentos com o dobro da taxa de funis normais ($1\text{ item por } 1\text{ tick} = 20\text{ itens/s}$), em total conformidade com o comportamento vanilla.
💻 Implementação do Código-Fonte Java Real
De HopperBlockEntityMixin.java no Minecraft 26.2:
@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 slice.
ItemStack baseItem = itemStack.copyWithCount(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().copy();
originalStack.shrink(1);
entity.setItem(originalStack); // Updates standard item tracker and custom name
cir.setReturnValue(true);
} else {
// Hopper was full or couldn't accept item
cir.setReturnValue(false);
}
}
}