ToolMods

Version 1.0.0 · Paper/Purpur 1.21.x · Java 21

Server-side modifications for tools, weapons, armor and the elytra, sold in a GUI shop. Players buy permanent mods with in-game currency; each mod is stored in the item's PersistentData Container and can be toggled on or off. Over 50 mods span mining utility, PvP abilities and survival quality-of-life — no client mod or resource pack required.

Features

• GUI shop — /mods opens a categorized shop; /mods manage shows and toggles the mods on the item you are holding.
• 50+ mods across pickaxe, axe, shovel, hoe, sword, spear/trident, shield, mace, bow/crossbow, elytra, armor and universal categories (full list below).
• Permanent and per-item — mods live in the item's PDC and survive normal use; each can be switched on or off individually.
• Economy-gated — every mod has a configurable price. Purchase debits before applying and refunds on failure, with a double-click guard and re-validation after async payment.
• Protection-aware — area/vein mining and AoE effects run block breaks and damage through the normal event pipeline, so land-claim and PvP protection plugins can veto them. Optional LandClaim, AntiXRAY and BuildersDream hooks are detected automatically.
• Sell bonus — selling a modded item to a server shop adds a configurable bonus per mod (mod-sell-bonus-multiplier).
• Every mod configurable — prices, tuning values and per-mod enable/disable are all in config.yml. Disabled mods do not appear in the shop.
• Per-player language — English, Portuguese and French, honouring PlayerSettings when present.

Commands

Command	Description	Permission
/mods	Open the tool mods shop	(none — gated by economy)
/mods manage	Show and toggle the mods on your held item	(none — gated by economy)
/mods reload	Reload the configuration	toolmods.admin

Alias: /toolmods.

Permissions

Node	Description	Default
toolmods.admin	Allows /mods reload	op

The shop itself has no permission gate by design — access is limited by whether a player can afford a mod.

Mod catalog

Prices below are the defaults from config.yml and are fully configurable. All effects are taken from the plugin's own in-game descriptions.

Pickaxe

Mod	Effect	Price
Area Mine 3×3	Mines a 3×3 area on the face you hit; crouch to mine a single block (9 durability/swing)	15000
Area Mine 5×5	Mines a 5×5 area; requires Area Mine 3×3 (25 durability/swing)	50000
Auto Smelt	Raw ores drop as smelted ingots; Silk Touch overrides, Fortune applies	8000
Telepathy	Mined drops go straight into your inventory; if full, they drop normally	12000
Vein Miner	Crouch + mine an ore to break the whole connected vein (max 64 blocks)	1600

Axe

Mod	Effect	Price
Tree Feller	Crouch + break a log to fell the whole tree and auto-replant a sapling (max 128 blocks)	800

Shovel

Mod	Effect	Price
Excavator 3×3	Digs a 3×3 area of shovel blocks; crouch for a single block (9 durability/swing)	12000
Excavator 5×5	Digs a 5×5 area; requires Excavator 3×3 (25 durability/swing)	40000
Path Maker	Right-click grass/dirt to create a 3-wide dirt path	5000

Hoe

Mod	Effect	Price
Harvester 3×3	Break a mature crop to harvest a 3×3 area and auto-replant	10000
Harvester 5×5	Harvest a 5×5 area; requires Harvester 3×3	35000
Tiller	Right-click to till a 3×3 area of dirt into farmland (9 durability/use)	4000

Sword

Mod	Effect	Price
Lifesteal	Heal 15% of damage dealt to hostile mobs and players (max 2 hearts/second)	30000
Thunderstrike	After 7 consecutive hits on one target, lightning strikes for +2 hearts (10s cooldown)	30000
Decapitator	Kills may drop the victim's head — players 100%, mobs 5%	15000
Evoker Fangs	After 5 consecutive hits, summon a line of armor-ignoring evoker fangs (5 fangs, 3 dmg, 8s cooldown)	25000

Spear

Mod	Effect	Price
Cripple	Hits slow the target — jab Slowness I (3s), charge Slowness II (4s)	6000
Bleed	Hits bleed the target for 1 heart every 2s over 6s; new hits reset the timer	8000
Dash Impact	Charge hits create a shockwave hitting enemies within 2 blocks for 40% damage	10000
Spear Sweep	Crouch-jab hits all enemies in a 180° arc for 60% damage	12000
Momentum	Charge hits deal +10% damage per block run, up to +100% (double damage)	15000
Evoker Fangs (Spear)	Charge hits summon a line of armor-ignoring evoker fangs (5 fangs, 3 dmg, 8s cooldown)	25000

Trident

Mod	Effect	Price
Riptide	Right-click to launch forward with no water needed (costs 1 water bucket, free in rain); no fall damage after launch	20000
Loyalty+	Trident returns twice as fast and damages enemies on its return path; requires the Loyalty enchant	15000
Chain Lightning	On hit, lightning chains to up to 3 nearby enemies with reduced damage per jump (6s cooldown)	25000
Anchor	On hit, grounds the target (no jumping or elytra) with Slowness V for 2s (10s cooldown)	18000
Poseidon's Call	Throw the trident into water to create a whirlpool that pulls enemies toward the impact (12s cooldown)	30000

Shield

Mod	Effect	Price
Magnetic Shield	While blocking, arrows within 2 blocks are attracted to the shield and destroyed	8000
Shield Bash	Sprint + block and run into an enemy to bash for 3 hearts and heavy knockback (5s cooldown)	10000
Phalanx	While blocking, allies within 3 blocks behind you gain Resistance I	12000
Reflective Shield	Blocking reflects 25% of damage; arrows are reflected as real projectiles	18000

Mace

Mod	Effect	Price
Tremor	Smash attacks apply Slowness II and Nausea to nearby enemies for 3s	20000
Seismic Slam	Smash AoE radius expanded to 5 blocks; enemies in range take 50% of the main hit	35000
Graviton Pulse	After a smash, enemies within 6 blocks are pulled to the impact for 1.5s (15s cooldown)	40000
Meteor Strike	Fall 15+ blocks before smashing to set nearby enemies on fire for 5s (visual fire trail)	50000

Bow / Crossbow

Mod	Effect	Price
Homing Arrow	Arrows curve slightly toward the nearest hostile mob or player (corrects near-misses, not aimbot)	25000
Explosive Arrow	Arrows explode on impact for 5 hearts of AoE damage (no block damage; 2s cooldown)	18000

Elytra

Mod	Effect	Price
Firework Efficiency	Firework rockets last 50% longer during flight	8000
Safe Landing	75% less fall damage; auto Slow Falling right before a crash (30s cooldown)	12000
Aerodynamic	30% less speed decay while gliding	15000
Boost	Crouch while gliding for a free speed boost, like a rocket without the rocket (18s cooldown)	20000
Phantom Cloak	Become invisible after 3s of continuous flight; landing, attacking or taking damage decloaks	25000
Sonic Boom	At high speed, enemies near your flight path take 4 damage and knockback	35000

Armor — Helmet

Mod	Effect	Price
Night Owl	Permanent Night Vision	30000
Aqua Lung	Permanent Water Breathing	25000
Hunter's Sight	Hostile mobs within 15 blocks glow through walls (only you see them; not players)	20000

Armor — Chestplate

Mod	Effect	Price
Vitality	+2 extra hearts while equipped	30000
Last Stand	Below 3 hearts, gain Resistance II and Strength I for 5s (60s cooldown)	30000
Thorns Aura	Attackers take 1 heart back, 100% consistent (not random like Thorns)	18000

Armor — Leggings

Mod	Effect	Price
Swift	Permanent Speed I; stacks with beacons and potions	20000
Dodger	20% chance to fully dodge melee and projectile attacks (1s internal cooldown)	35000

Armor — Boots

Mod	Effect	Price
Featherweight	50% less fall damage; stacks with Feather Falling	10000
Double Jump	Jump once more in the air (80% of first-jump height, 5s cooldown)	55000
Frost Walker Plus	Enhanced Frost Walker — 4-block radius, ice lasts 10s, speed boost on ice	20000

Universal (any tool / weapon)

Mod	Effect	Price
Soulbound	The item is kept on death and returned to your inventory on respawn	100000
Experienced	+50% XP from all activities with this item	6000
Unbreakable	The item never loses durability	500000

Configuration

The full config.yml is generated on first run. Each mod block exposes enabled, a price, and mod-specific tuning values. Example:

economy:
  mode: auto            # or "multibank" / "vault"
  priority: [MultiBank, Vault]
  currency-symbol: "$"
  currency-format: "#,##0.00"

mods:
  # Selling a modded item to a server shop adds (mod price × this) per mod.
  mod-sell-bonus-multiplier: 0.10

  pickaxe:
    vein-miner:
      enabled: true
      price: 1600
      max-blocks: 64
  sword:
    lifesteal:
      enabled: true
      price: 30000
      heal-percent: 0.15
      max-heal-per-second: 4.0

Set any mod's enabled: false to hide it from the shop, and adjust price and tuning values to fit your server's balance.

Installation

1. Requires Paper or Purpur 1.21.x and Java 21.
2. Install an economy provider — MultiBank (recommended) or Vault — since mods are purchased with in-game currency.
3. Drop ToolMods-1.0.0.jar into your server's plugins/ folder.
4. Start the server, edit plugins/ToolMods/config.yml, then run /mods reload.

Dependencies

• MultiBank — primary economy provider (async, precise currency). Recommended.
• Vault (optional) — alternative economy provider; used as a fallback when MultiBank is not present. One economy provider is required for the shop to charge for mods.
• PlayerSettings (optional) — per-player language selection.
• LandClaim (optional) — area/vein mining respects claim boundaries.
• AntiXRAY (optional) — integration hook detected automatically when present.
• BuildersDream (optional) — integration hook detected automatically when present.

Support / Source

Source code: https://github.com/henriquescrrrr/carrageis-toolmods