📦 Stack Size Adjuster

🎮 Version Compatibility

This mod is actively maintained and updated:

• Minecraft 26.2+: Fully supported with open-ended forward compatibility.

Take Control of Your Inventory. Custom Limits, No Boundaries.

Tired of inventory clutter? Or do you want to create a harder, more restricted survival experience? Stack Size Adjuster grants you full authority over item stack limits. Scale weapons, armor, blocks, and consumables dynamically at runtime.

Part of the Instant Gratification Collection — mods that respect the player's time.

---

✨ Features

🎚️ Category-Based Customization

Configure limits for the three standard Minecraft item categories:

• 64-Stack Limit: Standard stackable items (blocks, raw food, ores, building materials). Default: 128.
• 16-Stack Limit: Semi-stackable items (ender pearls, snowballs, eggs, signs). Default: 32.
• 1-Stack Limit: Unstackable items (weapons, tools, armor, potions, stews, beds). Default: 1.

🔢 Raw Integer Values

No more artificial caps! Adjust limits dynamically to any integer value from 1 up to 2,147,483,647.

• Overflow Protection Warning: The configuration GUI features a dynamic warning tooltip that alerts you if a limit is set above 39,768,215. This threshold is specifically to prevent total-container overflows when filling containers completely with the same item type. Change it at your own risk!

  • ⚠️ Performance Note: Moving or sorting extremely large item stacks (millions or billions) can cause transient game lag or frame stutter due to CPU calculation load.

  • 🎒 Modded Container / Backpack Safety Formula: If you are using custom containers or modded backpacks, you can calculate the maximum safe stack size to fully fill the container without overflow using this formula:

    Safe Stack Limit = 2,147,483,647 / [Total Slots in Container]

    • 100-slot backpack: 21,474,836 max per slot
    • 200-slot backpack: 10,737,418 max per slot

  • Safe Reference List (for identical items):

    • Hopper (5 slots): 429,496,729 max per slot
    • Dispenser / Dropper (9 slots): 238,609,294 max per slot
    • Single Chest / Shulker Box / Barrel (27 slots): 79,536,431 max per slot
    • Double Chest / Large Chest (54 slots): 39,768,215 max per slot
  • Note on Different Items: If you are storing different item types in the same container, you can safely go up to the absolute limit of 2,147,483,647 per slot since the game saves and tracks different item types independently!
  • Flat vs. Nested Storage Safety:
    • Player Inventory (Fully Immune): The player inventory is saved flatly as direct separate tags inside the player .dat files. Because individual slot counts are never summed up during saving, you can safely set and fill all 36 slots of your player inventory up to the absolute maximum limit of 2,147,483,647 with identical items without any overflow or deletion issues!
    • Chests, Barrels, and Shulker Boxes (Vulnerable to Overflow): World containers (like Chests, Double Chests, and Barrels) and nested container items (like Shulker Boxes and Bundles) are vulnerable. Tooltip renderers, inventory sorters, or game functions sum up their total contents. If the total count of identical items inside exceeds 2.14 billion, it triggers a signed 32-bit integer overflow and deletes your items. Make sure slots in these containers stay under the safe per-slot limits!
    • Storage Networks & Mod Compatibility: Works with storage network mods (like Tom's Simple Storage, etc.) at normal and moderately high values. Extreme limits (100M+) inside very large networks may cause items to be lost or trigger extraction loops due to third-party integer limitations (truncations in external mod logic). Change it at your own risk!

🔓 Slot Capacity Bypass

Say goodbye to the standard slot stack limit of 99 items. Stack Size Adjuster overrides the default container and stack serializer limits, allowing you to hold massive stacks (e.g., 640 or 1000) in any chest, hopper, or inventory slot.

📐 Dynamic Font Scale-Down

Worried about large numbers overlapping slots? When stack counts exceed 99, the client-side renderer dynamically scales down the count numbers to fit perfectly within slot boundaries, ensuring text never overlaps.

🛡️ Container Destruction Protection & Item Clumps

Includes the Max Drop Entities GameRule (stack-size-adjuster:max_drop_entities, default: 8) and integrates with Item Clumps to cap spawned item entities when containers break or players die, preventing severe server and client lag spikes.

🎯 Drag-Splitting & Consolidation Precision

Overrides container drag-splitting with double-precision math during QUICK_CRAFT and ItemStack consolidation to prevent item duplication or desync glitches when organizing massive stacks.

🛠️ Give Command Integer Overflow Safeguard

Re-routes /give command calculations with long math and safe clamping to Integer.MAX_VALUE so players can safely /give items even with extreme stack limits active.

🔌 Programmatic Addon Override API

Exposes StackSizeManager.registerOverride(...) allowing third-party addon mods (like Potion Stacker Addon) to dynamically inject custom stack rules without mixin conflicts.

🔒 Forward Compatibility & Version Guard

Pre-configured with "minecraft": ">=26.2-" open-ended bounds and zero-dependency ModVersionGuard startup protection to prevent world save corruption on unsupported game drops.

---

⚙️ Configuration (Native Game Rules)

[!IMPORTANT] Config vs. In-Game GameRules: The global configuration file only defines default values for new worlds at creation time. If you have already created/opened a world, changing the config file will have no effect. You must change the settings in-game using the Edit Game Rules UI screen or the /gamerule command.

Configure options in-game using /gamerule or via the integrated YACL config GUI:

• stack-size-adjuster:items_64_limit (Default: 128)
• stack-size-adjuster:items_16_limit (Default: 32)
• stack-size-adjuster:items_1_limit (Default: 1)
• stack-size-adjuster:max_drop_entities (Default: 8)

---

📦 Installation

1. Install Fabric API.
2. Install Item Clumps (Required dependency for item entity compression).
3. Download the mod jar and place it in your mods folder.
4. Launch the game.

---

☕ Support

If you enjoy the Instant Gratification collection, consider supporting development!

[!NOTE] Indonesian Users: SocioBuzz and Saweria support local payment methods (Gopay, OVO, Dana, etc.) if you want to support me without using PayPal/Ko-fi!

---

[!IMPORTANT] 📦 Modpack Permissions & Distribution: You are free to include this mod in any modpack on any platform. However, the mod itself must be downloaded from its official distribution pages on Modrinth or CurseForge. Re-uploading or redistributing the mod jar file to third-party sites is strictly prohibited unless explicitly permitted by the creator.

License & Forks: Since the source code is licensed under GNU GPLv3, you are fully permitted to fork the repository, make modifications, build your own versions, and distribute them under the terms of the GPLv3. The prohibition on third-party redistribution applies exclusively to the official compiled releases/jars published by the original creator (Dasik/Rifaditya). Forks must be published as distinct projects, not direct re-uploads of official builds.

---

📜 Credits

Role	Author
Creator	Dasik (Rifaditya)
Collection	Instant Gratification
License	GPLv3

---