StackableTools (Kotlin Edition)

---

• 🇫🇷 Français : README_FR.md
• 🇬🇧 English : this file

StackableTools is a powerful Minecraft Fabric mod rewritten in Kotlin that makes tools stackable, revolutionizing your inventory management without breaking the game's balance.

Download Links

Platform	Link
CurseForge	Download on CurseForge
Modrinth	Download on Modrinth

Version Support

Minecraft Version	Fabric Loader	Fabric API	Status	Notes
1.21	≥0.16.9	≥0.107.0	✅ Supported	Community-tested (untested)
1.21.1	≥0.16.9	≥0.107.0	✅ Supported	Community-tested (untested)
1.21.2	≥0.16.9	≥0.107.0	✅ Supported	Community-tested (untested)
1.21.3	≥0.16.9	≥0.107.0	✅ Supported	Community-tested (untested)
1.21.4	≥0.16.10	≥0.117.0	✅ Tested	Fully tested & recommended
1.21.5+	≥0.16.14	≥0.120.0	⚠️ Untested	May require code updates

Main Features

• Stackable Tools: Swords, pickaxes, shovels, axes, and more are now stackable!
• Potions Support: Stack your potions (up to 16 by default).
• Durability Isolation: Only the item you are using takes damage. The rest of the stack stays pristine!
• Fully Configurable: Fine-tune stack sizes for each category (Tools, Potions, Enchants).
• Mending Compatible: Works perfectly with Mending and Unbreaking.
• Smart Insertion: Picked-up items will automatically merge into existing stacks.

Configuration (Developer)

Important

To build the mod yourself, you must configure your environment first.

1. Open compile_config.json (or copy it from compile_config_sample.json).
2. Update the fields to match your local environment:

   {
     "output_path": "path/to/your/custom/output",
     "minecraft_version": "1.21.4",
     "fabric_loader_version": "0.16.9"
   }

3. Run the build script:

   ./compile.sh

Installation (User)

1. Download the latest .jar from the Releases page.
2. Install Fabric Loader and Fabric API.
3. Place the .jar in your mods/ folder.
4. Launch and enjoy a cleaner inventory!

Tip

We recommend using Freesm Launcher (a fork of Prism) for the best modding experience.

Requirements

• Java 21+ (Targeting latest stable JVM)
• Gradle 8.11+
• Fabric Loader

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create.

1. Fork the Project.
2. Create your Feature Branch (git checkout -b feature/AmazingFeature).
3. Commit your Changes (git commit -m 'Add some AmazingFeature').
4. Push to the Branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

License

CC0 1.0 Universal. See LICENSE for details.