ToolMods

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

Alias: /toolmods.

Permissions

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

Axe

Shovel

Hoe

Sword

Spear

Trident

Shield

Mace

Bow / Crossbow

Elytra

Armor — Helmet

Armor — Chestplate

Armor — Leggings

Armor — Boots

Universal (any tool / weapon)

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