Steadfast Rechargeable Tools

# RechargeableTools Demo video: https://www.youtube.com/watch?v=Ia9xGDNCbmo **Vein Miner, Timber, 3x3 Mining, Tree Felling, Excavator, Auto Harvest** - All in one lightweight plugin with a unique charge-based economy system. ## Why RechargeableTools? Most "super tools" plugins give players unlimited power. RechargeableTools adds **resource cost** to every ability use, creating an engaging economy loop where players must farm rare materials to fuel their powerful tools. **Your existing tools become upgradeable** - no custom items, no recipe conflicts, just upgrade your Netherite pickaxe and keep mining. --- ## Features ### 🔨 Pickaxe - Vein Miner + 3x3 Mining - **3x3 Mode**: Mine a 3x3 area based on the face you're looking at - **Vein Mode**: Mine entire ore veins (up to 64 connected blocks) - Toggle between modes with `/rt` ### 🪓 Axe - Timber / Tree Felling - Chop entire trees instantly (up to 128 blocks) - Breaks leaves automatically - **Auto-replants saplings** on the original stump ### ⛏️ Shovel - Excavator + Flatten - **3x3 Mode**: Excavate dirt, sand, gravel in a 3x3 pattern - **Flatten Mode**: Level terrain to your Y-level (fills holes, removes hills) ### 🌾 Hoe - Mass Harvest + Till - **Harvest Mode**: Harvest 5x5 area of mature crops with **auto-replant** - **Till Mode**: Till 5x5 area of dirt into farmland ### 🏗️ Architect's Totem (Bonus Tool) Convert a Totem of Undying into a builder's tool: - **Extended Reach**: Place blocks up to 12 blocks away - **Block Replace**: Swap all blocks of one type in a 7x7x7 area - ⚠️ *Trade-off: No longer saves you from death* --- ## Vanilla-Friendly Design | Feature | Behavior | | ---------------- | -------------------------------------------------- | | **Durability** | Tools take damage normally - Unbreaking helps | | **Enchantments** | Fortune, Silk Touch, Efficiency all work | | **Drops** | Uses vanilla drop tables and loot | | **Combat** | Tools work normally in combat | | **Death** | Configurable: drop tool, lose 25% charges, or both | Your upgraded Netherite pickaxe is still a Netherite pickaxe. It just has extra abilities. --- ## Charge Economy System ### Upgrading Upgrade any Netherite tool with **1 Netherite Ingot** via the `/rt` GUI. ### Recharging (Configurable) | Material | Charges | Notes | | ---------------- | ------- | ------------------------ | | Amethyst Shard | 500 | Renewable, easy to farm | | Heart of the Sea | 3,000 | Treasure hunting reward | | Echo Shard | 6,000 | Ancient City exploration | | Nether Star | 12,000 | Boss reward, high value | **Why these materials?** They're non-minable, preventing infinite charge exploit loops. Players must actually gather resources. ### Charge Usage - **1 charge per block** broken with abilities - **50,000 max charges** per tool (configurable) - **25% charge loss on death** (configurable) ## Configuration Options ### General Settings (`settings:`) | Option | Description | Default | |--------|-------------|---------| | `show-particles` | Show particles when abilities activate | `true` | | `play-sounds` | Play sounds when abilities activate | `true` | | `drop-on-death` | Drop upgraded tool on death (true) or keep it (false) | `true` | | `lose-charges-on-death` | Lose 25% of charges on death | `true` | | `prefix` | Message prefix for all plugin messages | `&6 &r` | ### Charge Tiers (`charge-tiers:`) | Tier | Material | Charges | Display Name | |------|----------|---------|--------------| | tier0 | `AMETHYST_SHARD` | 500 | Amethyst Shard | | tier1 | `HEART_OF_THE_SEA` | 3,000 | Heart of the Sea | | tier2 | `ECHO_SHARD` | 6,000 | Echo Shard | | tier3 | `NETHER_STAR` | 12,000 | Nether Star | ### Tool Abilities (`abilities:`) | Option | Description | Default | |--------|-------------|---------| | `enabled` | Enable/disable this tool ability | `true` | | `ability-name` | Display name of the ability | Varies by tool | | `upgrade-material` | Material required to upgrade | `NETHERITE_INGOT` | | `upgrade-amount` | Amount of material needed | `1` | | `charges-per-use` | Charges consumed per use | `1` | | `max-charges` | Maximum charges the tool can hold | `50000` | | `initial-charges` | Starting charges when upgraded | `3000` | #### Pickaxe-Specific (`abilities.pickaxe:`) | Option | Description | Default | |--------|-------------|---------| | `max-blocks` | Max blocks for vein mining | `64` | | `mining.size` | 3x3 mining area size (must be odd) | `3` | | `mining.same-block-only` | Only break matching blocks | `false` | | `mining.blacklist` | Blocks that won't trigger 3x3 | BEDROCK, OBSIDIAN, SPAWNER, etc. | | `mining.whitelist` | Only break these (empty = all) | `` | #### Axe-Specific (`abilities.axe:`) | Option | Description | Default | |--------|-------------|---------| | `timber.max-blocks` | Max bloc