Détail de l'Architecture & Mixins (MC 26.1.2)
Ce document détaille l'organisation des paquets, la hiérarchie des classes, les cibles Mixin, membres shadow et points d'injection pour Item Clumps sur Minecraft 26.1.2.
🌳 Hiérarchie des Paquets & Diagramme de Classes
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]🛠️ Cibles Complètes de Mixin & Analyse des Injections
1. ItemEntityMixin.java
- Classe Cible :
net.minecraft.world.entity.item.ItemEntity - Extension de Superclasse :
extends net.minecraft.world.entity.Entity
| Membre / Méthode | Annotation | Point d'Injection | Rôle |
|---|---|---|---|
getItem() | @Shadow | N/A | Accède à la pile d'items. |
setItem(ItemStack) | @Shadow | N/A | Modifie la pile d'items et met à jour les données. |
target | @Shadow | N/A | UUID du joueur ciblé. |
pickupDelay | @Shadow | N/A | Ticks du délai de ramassage. |
age | @Shadow | N/A | Ticks de durée de vie avant disparition ($0\text{ à }6000$). |
tick | @Inject | @At("HEAD") | Actualise dynamiquement la visibilité de l'étiquette. |
setItem | @Inject | @At("TAIL") | Déclenche la mise à jour de l'étiquette quand la pile change. |
isMergable | @Inject | @At("HEAD"), cancellable = true | Remplace la limite de pile par la GameRule max_clump_size. |
mergeWithNeighbours | @ModifyArgs | INVOKE -> AABB.inflate(DDD) | Modifie les arguments d'expansion horizontale ($0$ et $2$) selon merge_radius. |
tryToMerge | @Inject | @At("HEAD"), cancellable = true | Exécute les calculs de fusion et l'héritage d'âge récent. |
playerTouch | @Inject | @At("HEAD"), cancellable = true | Injecte par lots sous forme de piles vanilla propres. |
2. HopperBlockEntityMixin.java
- Classe Cible :
net.minecraft.world.level.block.entity.HopperBlockEntity
| Méthode | Annotation | Point d'Injection | Rôle |
|---|---|---|---|
addItem(Container, ItemEntity) | @Inject | @At("HEAD"), cancellable = true | Prélève des portions de 1 item ($2.5\text{ items/s}$) vers les entonnoirs. |