🔧 Solução de Problemas e Perguntas Frecuentes

📌 Isenção de responsabilidade da fonte do repositório: A documentação nesta Wiki reflete o estado atual do código-fonte no repositório, que pode incluir commits recentes não lançados ou recursos em desenvolvimento à frente dos lançamentos públicos no CurseForge e Modrinth.

1. Bowl Return Behavior & Full Inventory Handling

When consuming stews from a stack:

Stack Size > 1: The stack count decrements by 1, and an empty wooden bowl (minecraft:bowl) is deposited into your inventory.
Full Inventory Safety: If your inventory has zero free slots, the empty bowl is safely dropped at your feet, preventing item deletion.
Last Stew in Stack (Count = 1): Consuming the final stew replaces the item in your active hand with the empty bowl.

2. Coexistence with Potion Stacker Addon

Priority Delegation: Potion Stacker Addon explicitly checks if stew-stacker-addon is present:

java

if (FabricLoader.getInstance().isModLoaded("stew-stacker-addon")) {
    return -1; // Defers stew logic
}

When Stew Stacker Addon is loaded, it takes exclusive, authoritative control over all soup and stew stacking calculations.

3. Ghost Items & Desynchronization Prevention

When GameRule limits change on a server:

Network Sync Packet: Server broadcasts StewLimitSyncPayload to all connected clients.
Dynamic Menu Refresh: Server invokes broadcastFullState() on container and inventory menus.

java

if (player.containerMenu != null) {
    player.containerMenu.broadcastFullState();
}
if (player.inventoryMenu != null && player.containerMenu != player.inventoryMenu) {
    player.inventoryMenu.broadcastFullState();
}

4. Maximum Stack Limits & Integer Safety

Under the Player Agency & Anti-Nanny Invariant, players and server owners are given total freedom to set stack limits up to Integer.MAX_VALUE (2,147,483,647).

A standard Large Chest has 54 inventory slots.
If every slot contains 39,768,215 items: $$\text{Total Items} = 54 \times 39{,}768{,}215 = 2{,}147{,}483{,}610 \le 2{,}147{,}483{,}647$$
Setting values greater than 39,768,215 can cause vanilla integer overflow in 32-bit container math. Values below 39,768,215 are 100% mathematically safe across all vanilla containers.

5. ASCII Diagnostic Decision Tree

[ Player Encounters Stew Stacking Issue ]
                     |
                     v
          Is item a Stew or Soup?
         /                       \
       YES                        NO
       /                           \
Check GameRule:             Handled by Vanilla
stew-stacker:stew_limit     or other overrides
  (Default: 16)

🔧 Solução de Problemas e Perguntas Frecuentes ​

1. Bowl Return Behavior & Full Inventory Handling ​

2. Coexistence with Potion Stacker Addon ​

3. Ghost Items & Desynchronization Prevention ​

4. Maximum Stack Limits & Integer Safety ​

5. ASCII Diagnostic Decision Tree ​