Configuration

Configuration Guide

Where Is the Config File?

The configuration file is located at:

.minecraft/config/stackabletools.toml

It is created automatically on first launch with default values.

Configuration Options

Logging Section

[logging]
enable = true              # Enable logging output
level = "INFO"             # Log level: DEBUG, INFO, WARN, ERROR
in_file = true             # Log to file (config/stackabletools.log)
in_console = true          # Log to console

Stacking Section

[stacking]
enable = true              # Enable/disable all stacking features

# Maximum stack sizes for each category
max_stack_size = 64                # Default stack size
max_tool_stack_size = 8            # Pickaxes, shovels, axes, hoes
max_potion_stack_size = 16         # Potions
max_enchanted_book_stack_size = 4  # Enchanted books
max_weapon_stack_size = 1          # Swords, tridents (1 = no stacking)
max_elytra_stack_size = 1          # Elytra (1 = no stacking)
max_armor_piece_stack_size = 1     # Armor pieces (1 = no stacking)

# Active item categories for stacking
active_categories = [
    "TOOLS",
    "POTIONS",
    "ENCHANTED_BOOKS",
    "WEAPONS",
    "ARMORS",
    "ELYTRA"
]

# Exclude specific items from stacking (by registry ID)
excluded_item_ids = [
    # "minecraft:netherite_pickaxe"
]

# Manually enable stacking for specific items
manual_stackable_item_ids = [
    # "modname:custom_tool"
]

Example Configurations

Minimal Stacking (Tools Only)

[stacking]
enable = true
active_categories = ["TOOLS"]
max_tool_stack_size = 4

Aggressive Stacking (Everything Stackable)

[stacking]
enable = true
active_categories = [
    "TOOLS",
    "POTIONS",
    "ENCHANTED_BOOKS",
    "WEAPONS",
    "ARMORS",
    "ELYTRA"
]
max_tool_stack_size = 32
max_potion_stack_size = 32
max_weapon_stack_size = 8
max_armor_piece_stack_size = 8
max_elytra_stack_size = 4

Durability-Focused (Large Stacks, Low Potion Stacks)

[stacking]
enable = true
max_tool_stack_size = 16
max_potion_stack_size = 4    # Potions are fragile
max_weapon_stack_size = 1

Reloading Configuration

After editing the TOML file, run:

/reload

Or restart Minecraft. The mod will automatically detect and load the new configuration.