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

Command	Description	Permission
/multitool give <id> [player]	Give a multitool	multitool.give
/multitool list	List loaded tools	multitool.list
/multitool reload	Reload config & items	multitool.reload
/multitool create <id>	Create template YAML	multitool.create
/multitool export excellentshop <id>	Export for ExcellentShop	multitool.export
/multitool export excellentcrates <id>	Export for ExcellentCrates	multitool.export

Alias: /mt

---

Permissions

Permission	Default	Description
multitool.admin	OP	All admin commands
multitool.use	true	Use any multitool
multitool.use.<id>.<type>	true	Use a specific mode
multitool.give	OP	Give multitools
multitool.reload	OP	Reload plugin

---

Flags

Flag	Effect
REQUIRE_PERMISSION	Needs multitool.use.<id>.<type> to switch
NO_SWITCH	Mode cannot be selected in GUI
ONLY_SNEAK_SWITCH	GUI only opens while sneaking
UNSTACKABLE	Forces amount = 1
PRESERVE_AMOUNT	Keeps current stack size on switch
NO_PLUGIN_GUI_BLOCK	Doesn't cancel interact event (lets other GUIs also fire)
NO_DOUBLE_CHEST_PROTECT	Doesn't block double-chest opening
HIDE_ATTRIBUTES	Hides attribute tooltip lines
NO_ENCHANTS	Skips all enchant application
KEEP_CUSTOM_MODEL_DATA	Preserves CustomModelData on switch
NO_BREAK	Prevents block breaking
NO_PLACE	Prevents block placing

---

PlaceholderAPI Placeholders

Placeholder	Returns
%multitool_id%	ID of held multitool
%multitool_type%	Current mode/type key
%multitool_owner%	Player name who was given the tool
%multitool_has%	true / false

---

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

---

**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.