26.1.2 Architecture and Mixins

Architecture & Mixins Breakdown (MC 26.1.2)

This document details the internal package layout, class hierarchy, Mixin target breakdown, shadow members, and injection points for Item Clumps on Minecraft 26.1.2.

---

🌳 Package Hierarchy & Class Diagram

net.instantgratification.item_clumps
│
├── ItemClumpsFabric.java                   [Main Entrypoint / GameRules Registration]
│
├── config/
│   ├── ItemClumpsConfig.java               [Configuration POJO / Gson Persistence]
│   ├── ModMenuIntegration.java             [ModMenuApi Provider / Cloth Config Factory]
│   └── ClothConfigScreenHelper.java        [Cloth Config v2 Screen Factory]
│
└── mixin/
    ├── HopperBlockEntityMixin.java         [Hopper Drip Extraction Mixin]
    └── ItemEntityMixin.java                [Mega-Stack Aggregation & Smart Pickup Mixin]

---

🛠️ Complete Mixin Targets & Injection Breakdown

1. ItemEntityMixin.java

• Target Class: net.minecraft.world.entity.item.ItemEntity
• Superclass Extension: extends net.minecraft.world.entity.Entity

Member / Method	Annotation	Injection Point	Purpose
getItem()	@Shadow	N/A	Accesses the item stack.
setItem(ItemStack)	@Shadow	N/A	Mutates the item stack and updates tracker data.
target	@Shadow	N/A	UUID of the targeting player.
pickupDelay	@Shadow	N/A	Pickup cooldown timer ticks.
age	@Shadow	N/A	Despawn age timer ticks ($0\text{ to }6000$).
tick	@Inject	@At("HEAD")	Refreshes custom name tag visibility dynamically.
setItem	@Inject	@At("TAIL")	Triggers custom name tag update when stack changes.
isMergable	@Inject	@At("HEAD"), cancellable = true	Overrides max stack check with max_clump_size GameRule.
mergeWithNeighbours	@ModifyArgs	INVOKE -> AABB.inflate(DDD)	Modifies horizontal inflation args ($0$ and $2$) to match merge_radius.
tryToMerge	@Inject	@At("HEAD"), cancellable = true	Executes merge math and youngest age inheritance.
playerTouch	@Inject	@At("HEAD"), cancellable = true	Dispatches chunked inventory intake in clean vanilla stacks.

---

2. HopperBlockEntityMixin.java

• Target Class: net.minecraft.world.level.block.entity.HopperBlockEntity

Method	Annotation	Injection Point	Purpose
addItem(Container, ItemEntity)	@Inject	@At("HEAD"), cancellable = true	Extracts 1-item slices from mega-clumps ($2.5\text{ items/s}$) into hopper containers.

---

🔗 Related Documentation (MC 26.1.2)

• 26.1.2 Mega-Stack Clumping
• 26.1.2 Hopper Integration
• 26.1.2 Developer Setup