🔧 Panduan Pemecahan Masalah & FAQ

📌 Pernyataan Sumber Repositori: Dokumentasi dalam Wiki ini mencerminkan status kode sumber saat ini di repositori, yang mungkin mencakup komit terbaru yang belum dirilis atau fitur dalam tahap pengembangan mendahului build rilis publik di CurseForge dan 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)

🔧 Panduan Pemecahan Masalah & FAQ ​

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 ​