IG: Stack Size Adjuster
- By
Stack Size Adjuster grants you full authority over item stack limits. Scale weapons, armor, blocks, and consumables dynamically at runtime.
Come on
Create your game server with 
📦 Stack Size Adjuster
“Take Control of Your Inventory. Custom Limits, No Boundaries.”
1 Jar 1 Version Policy: I build 1 dedicated JAR for each Minecraft version (e.g. MC 26.2, MC 26.3). Please download the exact build that matches your Minecraft installation.
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 with zero mixin conflicts and full container safety.
Part of the Instant Gratification Collection — mods that respect the player's time.
✨ Features
Hold massive item stacks (from 64 up to 2.14 Billion) across chests, inventories, and nested Shulker Boxes with dynamic font scaling
🎚️ Category-Based Customization
Configure limits dynamically across 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 Limits & Dynamic Range
No more artificial caps! Adjust limits dynamically to any integer value from 1 up to 2,147,483,647 (Integer.MAX_VALUE).
- Dynamic Warning Tooltip: The configuration GUI features a dynamic warning tooltip that alerts you if a limit is set above
39,768,215. This threshold prevents total-container overflows when completely filling containers with identical items. - Flat vs. Nested Storage Safety:
- Player Inventory (Fully Immune): Player inventories are saved flatly as direct separate tags inside
.datfiles without slot summing. You can safely fill all 36 player slots up to2,147,483,647with identical items! - Chests, Barrels & Shulker Boxes (Vulnerable to Overflow): World containers sum up total contents during tooltips and saving. Keep individual slot counts within the safe capacity thresholds to prevent 32-bit signed integer overflow deletion.
- Player Inventory (Fully Immune): Player inventories are saved flatly as direct separate tags inside
🔓 Slot Capacity Bypass
Say goodbye to the standard slot stack limit of 99 items. Stack Size Adjuster overrides default container and stack serializer limits, allowing you to hold massive stacks (e.g., 640, 1,000, or 100,000) in any chest, hopper, or inventory slot.
📐 Dynamic Font Scale-Down
Worried about large numbers overflowing slot boxes? When stack counts exceed 2 digits (> 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 natively with Item Clumps to compress dropped item entities when large containers break or players die, preventing severe server lag and client FPS drops.
Breaking containers with millions of items merges drops into single clean 3D text entities, locking framerates at a smooth 60 FPS
🎯 Drag-Splitting & Consolidation Precision
Overrides container drag-splitting with double-precision math during QUICK_CRAFT operations and ItemStack consolidation, preventing item duplication or leftovers when distributing massive stacks.
🛠️ Give Command Integer Overflow Safeguard
Re-routes /give command calculations with long math and safe clamping to Integer.MAX_VALUE, ensuring players can safely /give items even with extreme stack limits active.
🔌 Programmatic Addon Override API
Exposes StackSizeManager.registerOverride(...) and CustomStackSizeOverride, allowing companion addon mods (such as Potion Stacker Addon or Stew Stacker Addon) to programmatically register custom item stack limits without colliding with general category rules.
Stack 16-limit items to billions, and stack soups, stews, and potions (x16) via companion Addons
🔒 Forward Compatibility & Version Guard
Pre-configured with "minecraft": ">=26.2-" open-ended bounds and zero-dependency ModVersionGuard Knot ClassLoader startup protection to display human-readable guidance if an incompatible Minecraft API version is encountered.
🧩 Compatibility & HUD Integration
- Item Clumps: Full native integration for ground item compression.
- YetAnotherConfigLib (YACL) & ModMenu: Optional clean in-game GUI configuration screen.
- Server-Side Vanilla Client Support: Synchronizes limits to vanilla clients via standard networking packets.
Full Jade / WTHIT tooltip HUD support displaying real-time massive container stack counts
📊 Quick Reference & Mechanics Matrix
| Item Category / Storage Type | Vanilla Limit | SSA Default | Maximum Safe Limit | Key Behavior & Safety Notes |
|---|---|---|---|---|
| 64-Stack Items | 64 | 128 | 2,147,483,647 |
Blocks, ores, crops, materials. Scale up for bulk storage. |
| 16-Stack Items | 16 | 32 | 2,147,483,647 |
Ender pearls, snowballs, eggs, buckets. |
| 1-Stack Items | 1 | 1 | 2,147,483,647 |
Tools, weapons, armor, beds. Keeps vanilla balance by default. |
| Player Inventory (36 slots) | 64 | — | 2,147,483,647 |
Fully Immune: Flat NBT serialization prevents slot count summing. |
| Hopper (5 slots) | 64 | — | 429,496,729 |
Safe per-slot limit to prevent hopper sum overflow. |
| Dispenser / Dropper (9 slots) | 64 | — | 238,609,294 |
Safe per-slot limit when filled with identical items. |
| Single Chest / Shulker Box (27 slots) | 64 | — | 79,536,431 |
Safe per-slot limit to avoid Shulker Box NBT overflow. |
| Double Chest (54 slots) | 64 | — | 39,768,215 |
Safe per-slot limit when storing 54 identical item slots. |
| Custom / Modded Backpack (N slots) | — | — | 2,147,483,647 / N |
Apply formula: Safe Limit = 2,147,483,647 / [Total Slots]. |
🚀 In-Game Commands & Quick Start
Stack sizes can be adjusted live in-game without restarting using standard Minecraft /gamerule commands:
/gamerule stack-size-adjuster:items_64_limit <value>
/gamerule stack-size-adjuster:items_16_limit <value>
/gamerule stack-size-adjuster:items_1_limit <value>
/gamerule stack-size-adjuster:max_drop_entities <value>Changes made via /gamerule immediately sync to all connected clients and refresh active container screens.
⚙️ Configuration (Native GameRules)
💡 Important: Config vs. In-Game GameRules: The global configuration file (
config/stack-size-adjuster.json) only defines default values for newly created worlds. In existing worlds, change settings in-game via the Edit Game Rules UI screen or the/gamerulecommand.
| GameRule Name | Type | Default | Valid Range | Description |
|---|---|---|---|---|
stack-size-adjuster:items_64_limit |
Integer |
128 |
1 to 2,147,483,647 |
Maximum stack size for standard 64-stack items. |
stack-size-adjuster:items_16_limit |
Integer |
32 |
1 to 2,147,483,647 |
Maximum stack size for semi-stackable 16-stack items. |
stack-size-adjuster:items_1_limit |
Integer |
1 |
1 to 2,147,483,647 |
Maximum stack size for unstackable 1-stack items. |
stack-size-adjuster:max_drop_entities |
Integer |
8 |
1 to 64 |
Maximum item entities spawned per slot on container break. |
Native in-game Edit Game Rules menu with bold Stack Size Adjuster (4 rules) category
Optional YetAnotherConfigLib (YACL) GUI configuration screen with safe limit presets & detailed tooltips
📖 In-Depth How-To & Operational Playbook
1. Drop-In Setup & Baseline Initialization
- Drop
stack-size-adjuster-<version>.jaralong with Fabric API, Dasik Library, and Item Clumps into yourmodsfolder. - On first launch, the mod auto-generates
config/stack-size-adjuster.jsonwith recommended baseline defaults (128for 64-stack items,32for 16-stack items,1for 1-stack items, and8for max drop entities).
2. Live In-Game Tuning vs. Global Template
- For New Worlds: Modify values in
config/stack-size-adjuster.jsonor through the ModMenu / YACL GUI before creating a world. The game copies these baseline defaults into the world's GameRules on initialization. - For Existing Worlds: Use
/gamerule stack-size-adjuster:<rule> <value>or the Edit Game Rules menu. The mod will instantly push updated stack boundaries to all clients and force-refresh open inventories.
3. Container Safety Math & Calculations
- When configuring stack limits in the millions or billions, use the Safe Container Capacity Formula:
Safe Per-Slot Limit = 2,147,483,647 / [Total Container Slots] - Different Items: Storing different item types in the same container is 100% safe up to
2,147,483,647per slot because Minecraft tracks distinct items independently in NBT. - Identical Items: Keep identical items below the container threshold (e.g.
39,768,215for Double Chests,79,536,431for Shulker Boxes) to prevent total-count integer wrapping.
4. Companion Addon Integration
Stack Size Adjuster includes an Addon Override API. Dedicated addon mods (such as Potion Stacker Addon) seamlessly register specific overrides for targeted items (e.g., allowing Potions to stack to 16 while keeping Weapons/Armor at 1).
5. Troubleshooting & Crash Prevention
- Loot Table Protection: Includes automated safeguards against negative stack sizes (
≤ 0) during mob drops and egg laying. - Give Command Safety: Safe
longcalculations ensure large/givecommands never overflow into negative quantities.
☕ Support
If you enjoy the Instant Gratification collection, consider supporting development!
🇮🇩 Indonesian Users: SocioBuzz and Saweria support local payment methods (Gopay, OVO, Dana, etc.) if you want to support me without using PayPal/Ko-fi!
📦 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 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 |
Made with ❤️ for the Minecraft community
Part of the Instant Gratification Collection
The IG: Stack Size Adjuster Team
