zEvolutiveTools | Tools That Evolve v1.0.2

zEvolutiveTools is a powerful tool progression plugin that transforms ordinary tools into evolving companions.​

---

---

Overview

zEvolutiveTools turns ordinary tools into evolving gear. Every tool earns its own currency as it's used, and that currency is spent inside an in-tool menu to buy enchantments, unlock effects, and complete quests. All progress is stored on the item itself, so a tool keeps its levels through death, drops, and trades. No central player data to wipe, the value lives in the gear.

---

The Menu Hub

Sneak and right-click to open the tool's hub: Enchantments, Effects, Settings, Quests, and Leaderboards, all in one place. The balance updates live while the menu stays open.

---

Per-Tool Currency

• Every tool type earns its own separate currency from its own action: mining, chopping, digging, harvesting, killing mobs, or catching fish
• Earn rates are set per block, mob, or caught item in each tool's config
• Currency-gain notices can route to the action bar or to chat

---

Enchantments

Unlock enchant levels from the menu, each with its own max level and cost curve, then pick which unlocked level is active. Left-click buys the next level or raises the active level for free, right-click lowers it.

---

Effects

Unlock and upgrade abilities per tool. Radius mining is bought in order, 1x1, then 2x2, then 3x3.

• Autosmelt (pickaxe)
• Auto-replant (hoe)
• Radius Mining 1x1 / 2x2 / 3x3 (pickaxe, axe, shovel, hoe)
• Telekinesis drops go straight to the inventory (all tools)
• Currency Multiplier (all tools)
• Auto-Sell (all tools, uses Vault when present)
• Item Drop Boost (all tools)

---

🗺 Quests

• A linear quest chain plus a daily rotation per tool
• Currency rewards, with a bonus for clearing all of a day's quests
• Rewards can require a manual claim, and when they do, the next chain quest unlocks only after the finished one is claimed
• Configurable daily reset time and timezone

---

Leaderboards

• Rankings for lifetime currency earned, blocks mined, and quests completed
• Viewable in a menu or with /et top
• The in-menu board can show just the tool you opened, the whole server, or a toggle between the two
• Players can opt out of being ranked, and rankings refresh on a configurable interval without ever blocking the main thread

---

Supported Tools

• Pickaxe (Netherite Pickaxe) breaking blocks, 1.18+
• Axe (Netherite Axe) chopping logs, 1.18+
• Shovel (Netherite Shovel) digging blocks, 1.18+
• Hoe (Netherite Hoe) harvesting crops, 1.18+
• Sword (Netherite Sword) killing mobs, 1.18+
• Fishing Rod catching fish, 1.18+
• Trident killing mobs, 1.18+
• Mace killing mobs, 1.21+
• Spear (Netherite Spear) killing mobs, 1.21.11+

Each tool's material, currency name, earn rates, enchants, and effects live in its own file. Tools using newer items (Trident, Mace, Spear) are skipped automatically with a console note on older servers, so everything else keeps working. Turn any tool off with enabled: false in its file.

---

Storage & Languages

• Storage: SQLite by default or MySQL. Every tool's state is mirrored to the database so an admin can restore a lost tool by its id.
• 10 bundled languages with automatic fallback to English for any missing line. Every menu, lore line, and chat message follows the active language.
• Flexible styling: named color tokens, hex shorthand, gradients, rainbows, and legacy codes, all configurable.

---

Dependencies

Required: None
zEvolutiveTools works out of the box with no required dependencies.

Optional

• Vault only needed if you want the auto-sell effect to pay through your economy plugin
  https://www.spigotmc.org/resources/vault.34315/
• PlaceholderAPI only needed if you want to use the %zet_...% placeholders
  https://www.spigotmc.org/resources/placeholderapi.6245/

---

Commands

Base command /evolutivetools (aliases /et, /zet).

• /et help
  List the commands you can use
• /et stats [player]
  Show tool totals (yours, or another player's with admin)
• /et top [currency|blocks|quests] [page]
  Show a leaderboard (currency by default)
• /et top <hide|show>
  Hide or show yourself on the leaderboards
• /et give <player> <tool> [amount]
  Give a tool to a player
• /et currency <add|set> <player> <hand|tool_uuid> <amount>
  Adjust a tool's balance (hand targets the held tool)
• /et restore <tool_uuid> <player>
  Restore a tool from its database backup
• /et reset <tool_uuid>
  Reset a held tool back to zero
• /et reload
  Reload every config file

---

Permissions

• zevolutivetools.use (everyone)
  Base command, opening the menu, viewing your own stats
• zevolutivetools.admin (op)
  Parent of all admin subcommands below
• zevolutivetools.admin.give / .currency / .restore / .reset / .reload (op)
  Individual admin command access

---

Requirements

• Minecraft: Spigot or Paper 1.18+
• Java: 17 or higher
• Optional: Vault (auto-sell economy) and PlaceholderAPI (placeholders)

---

Installation

1. Drop the jar into your plugins/ folder.
2. Start the server once to generate the config and language files.
3. Edit the configs to taste and run /et reload.

First start needs internet once so the server can download the plugin's runtime libraries (cached afterward).

---

Metrics

This plugin uses bStats to collect anonymous usage stats. You can opt out anytime with bstats.enabled: false in the config, or in plugins/bStats/config.yml.

---

Support & Docs

Full setup and configuration guides are in the documentation. Need help, found a bug, or want to suggest a feature? Join the Discord.