zEvolutiveTools | Tools That Evolve 1.4.0

📝 Read This First

Your config files no longer lose your edits. Anything missing is filled in on the next start, and anything you wrote or changed is left alone. That applies to enchants, currency lists, multi-tool shapes, styles and quests alike.

Two things that were being eaten before are now safe: quests you added yourself, which used to be deleted on every reload, and your styles.yml colour lines, where switching a token from a gradient to a solid had its color: line removed, leaving raw tag text in your menu titles.

If you deleted something on purpose and want it to stay gone, set sync.restore-missing-defaults: false.

🔨 The Multi-Tool

One tool that becomes whatever the job needs. Break dirt and it is a shovel, chop a log and it is an axe, mine stone and it is a pickaxe, hit a mob and it is a sword. Same tool throughout, with the same balance, upgrades and quests carrying across every shape.

It picks its shape the moment a player starts hitting a block rather than after the block is gone, so breaking dirt and then the stone underneath mines that stone as a pickaxe. morph-on sets when it changes: start, break, or both.

• Each shape sets the item it becomes, the blocks it handles, and the enchants it always carries
• Blocks are matched with * as a wildcard, so "*_LOG" covers every log. The first shape that matches wins, and the last one catches everything left over
• default-form decides what a brand new tool looks like before a player has broken anything
• unbreakable: true keeps it from ever breaking, or set a durability and let it wear down

There is a stripped-back version too. The fixed multi-tool changes shape the same way but does nothing else: no menu, no balance, no upgrades, no quests, with every enchant written in the file per shape. You can turn any tool into a fixed one with fixed: true in its file.

🎨 Custom Skins, Per Shape

Any tool can wear a custom item's texture from ItemsAdder or Oraxen, and each multi-tool shape can have its own. A ruby pickaxe that becomes a ruby shovel, then a ruby axe.

pickaxe:
  material: NETHERITE_PICKAXE
  custom-item-provider: "itemsadder"
  custom-item-id: "mypack:ruby_pickaxe"
  custom-model- -1

• Only the picture is taken. The name, lore, balance, upgrades and quests all stay exactly as they were, it is still one tool
• A shape you leave empty keeps the tool's normal look, so nothing is forced on you
• Using a resource pack instead? custom-model-data does the same job: -1 keeps the tool's own model data, 0 means none, anything else is the model you want

Two skin problems are fixed along with it: a skinned shape no longer leaves its texture behind on the next shape, and changing a skin now shows on tools players are already holding after a reload, instead of waiting for the tool to change shape.

🖼 Images in Your Text

Write an image name between two colons and it renders as the picture from your pack, everywhere the plugin writes text: the tool name, every lore line, menu titles and buttons, chat messages, and your language files.

lore:
  - "<gray>Shift + :right_click: to open the menu"

Oraxen glyphs work the same way with the glyph name. Write a name your pack does not have and the text stays exactly as you typed it, nothing breaks. Turn it off with display.font-images: false if you would rather the colons were left alone.

🛡 Tool Protection

• No vanilla enchanting on top of yours. Tools cannot be put in an anvil, an enchanting table, a grindstone, a smithing table, or a crafting grid, so no books, no combining two tools, and no table enchants stacked over the ones players bought. Each has its own switch
• Dropping a tool takes two presses. The first keeps the tool and warns the player, and a second within five seconds actually drops it. The window is configurable, or turn it off entirely

💬 Text and Colour

Text updates without re-equipping. A reload rewrites the name and lore on every tool players are holding, so a wording or colour change shows up straight away. Switch it off with display.refresh-on-reload.

More ways to colour. Everything you already wrote keeps working, and you now also have #{RRGGBB} and <#RRGGBB> hex, gradients, and 125 extra named colours (&t7 is coral, &u1 is cyan).

One small change: the number in a rainbow tag is now an id rather than a saturation level.

🎲 Drop Boost Tuning

ITEM_DROP_BOOST now takes a secondary-chance, a second roll behind the first, so a tool at 100% can be tuned down to paying out about every other block. Set it to 1.0 for no change from before.

📋 Version Breakdown

📦 Install

Stop the server, replace the old jar in plugins/, and start it again. Nothing to delete by hand, the new keys are added to your files for you.