Trichter- & Automations-Integration (MC 26.2)
Dieses Dokument beschreibt die Trichter-Extraktionsmechanik, Transferraten-Parität, Redstone-Sortierer-Stabilität und Behälterintegration in Item Clumps für Minecraft 26.2.
📊 Feature-Infobox
| Eigenschaft | Spezifikation |
|---|---|
| Systemname | Trichter-Tröpfchen-Extraktions-Engine |
| Zielklasse | net.minecraft.world.level.block.entity.HopperBlockEntity |
| Extraktionsmethode | HopperBlockEntity.addItem(Container, ItemEntity) |
| Extraktionsrate | $1\text{ Item pro } 8\text{ Ticks}$ ($2.5\text{ Items/Sekunde}$) |
| Reduktionsstrategie | originalStack.shrink(1) mit Metadaten-Aktualisierung über entity.setItem() |
| Automations-Kompatibilität | 100 % kompatibel mit Vanilla-Redstone-Sortierern & Filtern |
⚙️ Die Automations-Tröpfchen-Architektur
In Vanilla Minecraft saugen Trichter ganze ItemEntity-Instanzen ein, wenn deren Stapelgröße $\le 64$ ist und Platz vorhanden ist. Würde ein Trichter unkontrolliert einen Stapel mit $5.000$ Items aufnehmen, liefe er sofort über oder Items würden gelöscht.
Item Clumps fängt HopperBlockEntity.addItem ab, um die Tröpfchen-Extraktion durchzusetzen:
┌────────────────────────────┐
│ 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. │
└───────────────────┘ └───────────────┘⏱️ Übertragungsrate & Redstone-Sortier-Parität
Trichter in Vanilla Minecraft arbeiten mit einer Abklingzeit von 8 Ticks ($0.4\text{ Sekunden}$):
$$\text{Hopper Transfer Rate} = \frac{1\text{ item}}{8\text{ ticks}} = \frac{20\text{ ticks/s}}{8\text{ ticks}} = 2.5\text{ items/second}$$
Da Item Clumps exakt $1\text{ Item}$ pro Zyklus entnimmt:
- Standard-Itemsortierer: Filtertrichter (mit 41-1-1-1-1-Konfiguration) leeren Stapel in der vorgesehenen Geschwindigkeit, ohne Komparatorsignale zu stören oder benachbarte Leitungen zu überlasten.
- Wasserstrom-Sortierer: Große Stapel über Trichterstraßen werden schrittweise geleert, ohne den Wasserfluss zu stauen oder Kollisionen zu verursachen.
- Trichterlore: Sammelt Items mit doppelter Trichtergeschwindigkeit ($1\text{ Item pro } 1\text{ Tick} = 20\text{ Items/s}$), vollkommen konform zum Vanilla-Verhalten.
💻 Reale Java-Quellcode-Implementierung
Aus HopperBlockEntityMixin.java in 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);
}
}
}