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](https://www.spigotmc.org/resources/placeholderapi.6245/) and/or [ExcellentEnchants](https://www.spigotmc.org/resources/excellentenchants.6169… 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.