Troubleshooting

Troubleshooting

Common Issues & Solutions

Issue: "Error parsing Mixin config" on Launch

Symptoms:

java.lang.RuntimeException: Error parsing or using Mixin config stackabletools.mixins.json

Solutions:

1. Ensure Fabric Loader ≥0.18.5 is installed
2. Verify Fabric API is installed for your Minecraft version
3. Delete the mod and reinstall the latest version from CurseForge or Modrinth

Issue: Items Still Don't Stack

Symptoms:

• Configuration is correct, but items won't stack

Solutions:

1. Run /reload in-game to reload the configuration
2. Check stackabletools.toml for typos in category names
3. Verify the mod appears in /mods list
4. Restart Minecraft entirely (don't just reload)

Issue: Performance Lag When Stacking Many Items

Symptoms:

• Frame rate drops when managing large stacks
• Inventory feels sluggish

Solutions:

1. Reduce max_*_stack_size values in config
2. Limit the number of active categories
3. Update Fabric Loader to the latest version
4. Allocate more RAM to Minecraft (increase -Xmx in launcher settings)

Issue: Mending Enchantment Not Working With Stacked Tools

Symptoms:

• Tools with Mending enchantment don't repair

Solutions:

1. Ensure only one tool is in use (not stacked)
2. The Mending enchantment must be on the tool being held
3. This is expected behavior — Mending only applies to the active tool

Issue: Crashes in Multiplayer

Symptoms:

• Crash occurs only on servers
• Works fine in single-player

Solutions:

1. Install StackableTools on the server as well
2. Ensure server and client have matching mod versions
3. Check server logs for error messages

Debug Commands

StackableTools includes debug commands for troubleshooting:

# Give yourself test items (OP only)
/debug-test

# Reload configuration (OP only)
/reload

# Open configuration file (OP only)
/config-mod

Getting Help

If issues persist:

1. Check the GitHub Issues page
2. Provide:
   • Your Minecraft version
   • Fabric Loader version
   • Fabric API version
   • Your stackabletools.toml file
   • Full crash log (if applicable)