✨ AmethystTools
AmethystTools is a customizable Paper / Folia plugin that adds amethyst-themed 3x3 mining tools — pickaxes, shovels and axes in seven tiers — together with an interactive GUI, a tree-felling axe and a fully configurable look.
Inspired by the Amethyst Tools found on DonutSMP. AmethystTools is an independent project and is not affiliated with DonutSMP.
✨ Features
- ⛏️ 3x3 Area Mining — Pickaxes and shovels break a 3x3 area that follows where you look: a wall in front of you, or a floor/ceiling layer when you look steeply up or down.
- 🪓 Tree-Felling Axe — Fell a whole connected tree in one swing, up to 64 logs.
- 🧱 Seven Tiers — Wooden, stone, iron, copper, golden, diamond and netherite.
- 🖼️ Interactive GUI — Browse every tier and obtain tools from a convenient menu.
- 🛡️ Protected Blocks — A configurable blacklist protects ores, containers, bedrock and other selected blocks from area breaking.
- 🏷️ Reliable Item Detection — Plugin-specific PersistentDataContainer tags prevent look-alike items from gaining tool abilities just by sharing the same model ID.
- 🎨 Customizable Appearance — Configure item names, menu titles and messages using MiniMessage,
&color codes and&#RRGGBBhex colors. - 🔄 Two Mining Modes — Choose
NEWfor smart tool behavior orOLDfor classic 3x3 mining with every tool. - 🔊 Configurable Sound Effects — Enable or disable mining sounds and randomize their pitch.
- ✨ Configurable Particle Effects — Enable or disable particle effects through the config.
- 🪄 Enchanting Control — Configure whether enchantments are allowed on AmethystTools.
- 🔔 Update Notifications — Operators are notified when a new version is available on Modrinth.
- 🧩 Paper and Folia Support — Designed for both server platforms.
⛏️ Commands
| Command | Description | Permission |
|---|---|---|
/amethysttools |
Opens the tool menu (players only) | amethysttools.give |
/amethysttools give <tier> <tool> [players] |
Gives a tool to yourself or selected players | amethysttools.give |
/amethysttools reload |
Reloads config.yml and refreshes tool names in online players' inventories |
amethysttools.admin |
Tiers: wooden, stone, iron, copper (1.21.9+ only), golden, diamond, netherite
Tools: pickaxe, shovel, axe
/amethysttools give netherite axe
/amethysttools give golden shovel Steve
/amethysttools give diamond pickaxe @a
All arguments support tab completion. Incorrect or incomplete commands display Minecraft's own error messages.
🔑 Permissions
| Permission | Default | Description |
|---|---|---|
amethysttools.give |
op | Opens the menu and allows giving tools |
amethysttools.admin |
op | Allows reloading the plugin |
🖼️ Screenshots
Main Menu
Tier Menu
Tools
📦 Compatibility
- Minecraft: 1.21 and newer, including 26.x versions.
- Java: 21.
- Platforms: Paper, Purpur, Folia and compatible forks.
- Copper tools are only available in Minecraft
1.21.9and newer. - Starting with version
1.4, the plugin is distributed as a single JAR file.
Tools created by older versions of AmethystTools continue to work after updating. The configuration is updated automatically while preserving your existing values.
❤️ Support
Found a bug or have a suggestion? Open an issue on GitHub.
📄 License
AmethystTools is licensed under the GNU General Public License v3.0.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
AmethystTools 2.0 2.0 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
AmethystTools 1.9 1.9 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
AmethystTools 1.8 1.8 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
AmethystTools 1.7 1.7 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
AmethystTools 1.6 1.6 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
AmethystTools 1.5 1.5 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
AmethystTools 1.4 1.4 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
AmethystTools 1.3 1.3 |
26.1, 26.1.1, 26.1.2
|
bukkit, paper, purpur, spigot
|
Download |
|
AmethystTools 1.3 1.3 |
1.21.9, 1.21.10, 1.21.11
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
AmethystTools 1.3 1.3 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
AmethystTools 1.2 1.2 |
26.1, 26.1.1
|
bukkit, paper, purpur, spigot
|
Download |
|
AmethystTools 1.2 1.2 |
1.21.9, 1.21.10, 1.21.11
|
bukkit, paper, purpur, spigot
|
Download |
|
AmethystTools 1.2 1.2 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8
|
bukkit, paper, purpur, spigot
|
Download |
|
AmethystTools 1.1 1.1 |
1.21.9, 1.21.10, 1.21.11
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
AmethystTools 1.1 1.1 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
AmethystTools 1.0 1.0 |
1.21.9, 1.21.10, 1.21.11
|
bukkit, spigot
|
Download |
|
AmethystTools 1.0 1.0 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8
|
bukkit, spigot
|
Download |
|
AmethystTools 1.0 1.0 |
1.21.9, 1.21.10, 1.21.11
|
folia, paper, purpur
|
Download |
|
AmethystTools 1.0 1.0 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8
|
folia, paper, purpur
|
Download |
|
AmethystTools 1.0 1.0 |
1.21.9, 1.21.10, 1.21.11
|
folia, paper, purpur
|
Download |
|
AmethystTools 1.0 1.0 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8
|
folia, paper, purpur
|
Download |