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[Tools] &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 blocks per chop	128
timber.break-leaves	Break leaves too	true
timber.auto-replant	Replant saplings automatically	true
timber.log-types	Log types that trigger timber	All vanilla logs

Shovel-Specific (abilities.shovel:)

Option	Description	Default
excavate.size	Excavation area size	3
excavate.shovel-blocks-only	Only break shovel-appropriate blocks	true

Hoe-Specific (abilities.hoe:)

Option	Description	Default
harvest.size	Harvest/till area size	5
harvest.auto-replant	Auto replant crops	true
harvest.crop-types	Harvestable crops	WHEAT, CARROTS, POTATOES, BEETROOTS, NETHER_WART

Totem-Specific (abilities.totem:)

Option	Description	Default
architect.reach-distance	Extended reach distance	12
architect.replace-radius	Block replace radius	3

---

Commands

Command	Description	Permission
/rt	Open the upgrade/recharge GUI	rechargeabletools.use
/rt help	Show command help	None
/rt info	Show info about held tool	rechargeabletools.use
/rt on	Enable abilities on held tool	rechargeabletools.use
/rt off	Disable abilities on held tool	rechargeabletools.use
/rt toggle	Toggle abilities on held tool	rechargeabletools.use
/rt reload	Reload plugin configuration	rechargeabletools.admin
/rt give <player> <tool> [charges]	Give an upgraded tool to a player	rechargeabletools.admin

Command Aliases: /rechargetools, /rtools

Tool types for give command: pickaxe, axe, shovel, hoe, totem

---

Permissions

Permission	Description	Default
rechargeabletools.use	Allows using rechargeable tool abilities	true (all players)
rechargeabletools.upgrade	Allows upgrading tools via GUI	true (all players)
rechargeabletools.recharge	Allows recharging tools via GUI	true (all players)
rechargeabletools.admin	Admin commands (reload, give, etc.)	op (operators only)