🏛️ Arquitectura y Ganchos de Expansión (Minecraft 26.3)

📌 Descargo de responsabilidad de la fuente del repositorio: La documentación de esta Wiki refleja el estado actual del código fuente en el repositorio, que puede incluir confirmaciones recientes no publicadas o características en desarrollo antes de las compilaciones públicas en CurseForge y Modrinth.

1. Official Infobox

Parameter	Technical Details
Subsystem Name	Architecture & Addon Extension Hooks
Root Package	`net.instantgratification.potionstacker`
Core Entrypoint	`PotionStackerFabric.java` (`ModInitializer`)
Client Entrypoint	`PotionStackerFabricClient.java` (`ClientModInitializer`)
ModMenu Entrypoint	`ModMenuIntegration.java` (`ModMenuApi`)
Core Manager	`PotionStackerManager.java`
Network Payload	`PotionLimitSyncPayload.java`
Configuration	`PotionStackerConfig.java`, `YaclScreenHelper.java`
Mixin Count	0 Mixins (100% Pure Addon Delegation)
Upstream Framework	Stack Size Adjuster (`StackSizeManager`)

2. Step-by-Step Subsystem Lifecycle

onInitialize() Lifecycle Execution:
- Step A: Load configuration baseline via PotionStackerConfig.load(...).
- Step B: Register functional override callback into StackSizeManager.registerOverride(...).
- Step C: Register POTION_LIMIT and STEW_LIMIT GameRules under namespaced category.
- Step D: Register S2C payload type and codec via PayloadTypeRegistry.clientboundPlay().
- Step E: Attach ServerPlayConnectionEvents.JOIN listener for client sync.
- Step F: Attach ServerLifecycleEvents.SERVER_STARTED listener for world initialization checks.
Client Initialization (onInitializeClient):
- Register global receiver for PotionLimitSyncPayload.TYPE on ClientPlayNetworking.
Stack Query Resolution:
- When Minecraft queries item stack limit, Stack Size Adjuster iterates registered overrides.
- Potion Stacker Addon inspects item class; returns potionLimit if potion, stewLimit if soup (and stew mod absent), or -1 to continue chain.

3. Algorithmic Complexity & Zero-Allocation Path

Time Complexity: $O(1)$ constant time lookup.
Space Complexity: $O(1)$ zero heap allocation on the hot path.

4. Visual ASCII Architecture Diagram

+-------------------------------------------------------------------------+
|                            Minecraft Engine                             |
+------------------------------------+------------------------------------+
                                     |
                                     v
+-------------------------------------------------------------------------+
|                       Stack Size Adjuster (Core)                        |
|                     StackSizeManager.getStackSize()                     |
+------------------------------------+------------------------------------+
                                     |
              +----------------------+----------------------+
              | CustomStackSizeOverride                     |
              v                                             v
+-----------------------------+             +-----------------------------+
|    Potion Stacker Addon     |             |     Stew Stacker Addon      |
|  PotionStackerManager.java  |             |      (Sibling Addon)        |
+--------------+--------------+             +-----------------------------+
               |                                            ^
               |-- isModLoaded("stew-stacker-addon")? ------|
               |   If TRUE: returns -1 (defers stew logic)
               |
               v
+-------------------------------------------------------------------------+
|                           DasikLibrary (API)                            |
|       DynamicGameRuleManager  |  ConfigHelper  |  GuiHelper             |
+-------------------------------------------------------------------------+

5. Addon Hook Registration Schema

java

@FunctionalInterface
public interface CustomStackSizeOverride {
    int getModifiedStackSize(Item item, int originalSize);
}

🏛️ Arquitectura y Ganchos de Expansión (Minecraft 26.3) ​

1. Official Infobox ​

2. Step-by-Step Subsystem Lifecycle ​

3. Algorithmic Complexity & Zero-Allocation Path ​

4. Visual ASCII Architecture Diagram ​

5. Addon Hook Registration Schema ​

6. Enlaces Globales y Externos ​

🏛️ Arquitectura y Ganchos de Expansión (Minecraft 26.3)

1. Official Infobox

2. Step-by-Step Subsystem Lifecycle

3. Algorithmic Complexity & Zero-Allocation Path

4. Visual ASCII Architecture Diagram

5. Addon Hook Registration Schema

6. Enlaces Globales y Externos