AutoTools - Smart Tool Switching for Minecraft
Overview
AutoTools brings the beloved functionality of the AutoTools mod to Spigot servers! This lightweight, performance-optimized plugin automatically switches to the best tool in your hotbar when breaking blocks. No more fumbling through your inventory or wearing down the wrong tools!

Perfect for survival servers, skyblock, prison servers, or any gamemode where efficiency matters.

✨ Key Features
Intelligent Tool Detection

• Automatically identifies the optimal tool for any block
• Supports all vanilla tools: Pickaxes, Axes, Shovels, Hoes, and Shears
• Smart material hierarchy: Netherite > Diamond > Iron > Gold > Stone > Wood

⚡ Advanced Tool Scoring System

• Prioritizes tools with beneficial enchantments (Efficiency, Fortune, Silk Touch)
• Avoids nearly broken tools to prevent item loss
• Configurable tool material priorities

Player-Friendly

• Simple toggle command: /autotools
• Per-player settings that persist across sessions
• Optional creative mode support
• No lag or performance impact

⚙️ Highly Configurable

• Extensive configuration options
• Customizable messages with color support
• Debug mode for server administrators
• Enable/disable by default for new players

Installation

1. Download the latest AutoTools.jar
2. Place it in your server's plugins folder
3. Restart your server or reload plugins
4. Configure settings in plugins/AutoTools/config.yml (optional)
5. Ready to use!

Requirements:

• Spigot/Paper 1.21 or higher
• Java 17 or higher

Commands & Permissions
Commands

Command Description Permission
/autotools Toggle AutoTools on/off for yourself autotools.use
Permissions

Permission Description Default
autotools.use Allows players to use the AutoTools feature Everyone
autotools.admin Access to reload config (future feature) OP only
⚙️ Configuration
How It Works
Supported Block Categories:
Pickaxe Blocks:

• All stone variants (Stone, Cobblestone, Deepslate, etc.)
• All ores (Iron, Gold, Diamond, Copper, etc.)
• Bricks, Concrete, Terracotta
• Nether blocks (Netherrack, Basalt, Blackstone)
• Utility blocks (Furnaces, Hoppers, Anvils)

Axe Blocks:

• All wood types and variants
• Logs, Planks, Stripped logs
• Wooden items (Chests, Crafting Tables, Signs)
• Bamboo and related blocks
• Mushroom blocks

Shovel Blocks:

• Dirt, Grass, Podzol, Mycelium
• Sand, Gravel, Clay
• Snow and Powder Snow
• Soul Sand/Soil

Hoe Blocks:

• Leaves (all types)
• Hay Blocks, Dried Kelp Blocks
• Moss, Sculk blocks
• Nether/Warped Wart blocks

✂️ Shears Blocks:

• Wool and Carpets
• Cobwebs
• Vines and Glow Lichen
• Tall Grass and Ferns

Usage Examples

1. Mining: Start breaking stone with your hand, and AutoTools instantly switches to your best pickaxe
2. Deforestation: Punch a tree, and your axe appears in hand
3. Landscaping: Switch seamlessly between shovel for dirt and pickaxe for stone
4. Building: No more manual tool switching when working with mixed materials

Performance

• Lightweight: Minimal server impact with event-based activation
• Optimized: Only checks tools when actually breaking blocks
• Smart Caching: Player preferences stored efficiently
• No TPS Impact: Tested on servers with 100+ players

Compatibility
✅ Compatible with:

• Paper, Purpur, and other Spigot forks
• MCMMO (respects custom block behaviors)
• Jobs Reborn
• Custom enchantment plugins
• WorldGuard regions

Future Features
Planned for future updates:

• [ ] Customizable tool switching animations
• [ ] Sound effects toggle
• [ ] Per-world configuration
• [ ] API for developers
• [ ] Custom tool support
• [ ] Block blacklist/whitelist
• [ ] Tool switching cooldown options

❤️ Credits

• Inspired by the original AutoTools mod
• Built with love for the Minecraft community
• Special thanks to beta testers