Multi-Tool

MultiTool

Paper 1.21 – 1.21.11 Plugin

API: MrSilent | API: 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

```yaml 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: never — the plugin never cancels events unless the player is sneaking + right-clicking while holding a multitool.