Multi-Tool

MultiTool

Paper 1.21 – 1.21.11 Plugin

Author: MrSilent | Version: 1.0.0 | API: Paper 1.21 – 1.21.11

A fully configurable, modular multi-mode tool plugin. One item, unlimited modes — each with its own material, name, lore, enchantments, attributes, NBT, sounds, and titles.

---

Features

• Unlimited multitools via items/*.yml
• GUI mode selector (Sneak + Right-Click)
• Per-type materials, names, lore, enchants, attributes, NBT
• Full flag system (12 flags)
• PlaceholderAPI integration (%multitool_id%, %multitool_type%, etc.)
• ExcellentEnchants — reflection-based, zero hard dependency
• Hex colour + MiniMessage support (&#RRGGBB, &X)
• Switch titles, subtitles, sounds per type
• Zero interference with other plugins (ExcellentShop, ExcellentCrates, Auction GUIs, chest GUIs)
• /multitool reload rebuilds held tools for all online players

---

Installation

1. Drop MultiTool-1.0.0.jar into your plugins/ folder.
2. (Optional) Install PlaceholderAPI and/or ExcellentEnchants.
3. Start/restart your server.
4. Edit plugins/MultiTool/config.yml and plugins/MultiTool/items/*.yml.
5. Run /multitool reload.

---

Commands

Alias: /mt

---

Permissions

---

Flags

---

PlaceholderAPI Placeholders

---

Item YAML Structure

multitool:
  id: "my_tool"
  display-name: "&#FFD700My Tool"
  material: NETHERITE_PICKAXE
  unbreakable: true
  lore:
    - "&7A cool tool"
  enchants:
    - "mending:1"
  excellent-enchants:
    - "veinminer:3"
  flags:
    - "UNSTACKABLE"
    - "ONLY_SNEAK_SWITCH"

  gui:
    rows: 2
    title: "&bSelect Mode"

  types:
    pickaxe:
      name: "&bMining Mode"
      material: NETHERITE_PICKAXE
      slot: 10
      enchants:
        - "efficiency:8"
      attributes:
        GENERIC_ATTACK_DAMAGE: 4.0
      nbt:
        mode: "pickaxe"
      switch-title: "&bMining Mode"
      switch-subtitle: "&7VeinMiner Active"
      sound: BLOCK_AMETHYST_BLOCK_RESONATE

---

[GitHub] - (https://github.com/Craft-Void/MultiTool/)

**Soft dependencies** (not required to compile or run):
- PlaceholderAPI
- ExcellentEnchants (reflection-only; no compile dependency)

---

## Compatibility

- Paper 1.21 – 1.21.11 (1.21.1 – 1.21.4)
- ExcellentShop, ExcellentCrates, Auction GUIs: **fully compatible** — the plugin **never** cancels events unless the player is sneaking + right-clicking while holding a multitool.