# AmethystTools<\/p>\n
AmethystTools is a Paper plugin that adds configurable custom mining tools, starting with the Amethyst Pickaxe.<\/p>\n
It is built for server owners who want powerful utility tools with safe defaults, clean permissions, and simple config-based expansion.<\/p>\n
## Why AmethystTools<\/p>\n
– Area mining with configurable radius and depth
\n– Expiring tools with automatic lore countdown updates
\n– Automatic removal of expired tools
\n– Per-item config system for easy future tool additions
\n– Block protection via configurable blocked-materials list
\n– Area-mining exclusions via `mining.excluded-materials`
\n– Separate messages.yml for fully editable text
\n– Config\/message version checks to help with safe updates<\/p>\n
## Features<\/p>\n
– 3×3 style mining by default (`radius: 1`, `depth: 1`)
\n– Blocks in `mining.excluded-materials` are only mineable directly (not as 3×3 side-breaks)
\n– Expiry system (`expiry.days`) with `%time%` placeholder in lore
\n– Dynamic `\/at give` item input from config aliases
\n– Admin reload command for config and messages
\n– LuckPerms-friendly permission nodes<\/p>\n
## Commands<\/p>\n
– \/at give ## Permissions<\/p>\n – amethysttools.use ## Config Structure<\/p>\n The plugin uses an item map so you can add more tools later without editing Java code.<\/p>\n “`yml Add more tools by creating new keys under `items` and giving each key aliases.<\/p>\n ## Protected Blocks (Default)<\/p>\n – BEDROCK ## Area-Mining Exclusions (Default)<\/p>\n – OBSIDIAN<\/p>\n ## Messages<\/p>\n All user-facing text is editable in messages.yml:<\/p>\n – no-permission ## Compatibility<\/p>\n – Server software: Paper ## Install<\/p>\n 1. Build or download the release jar. This minecraft plugin adds Amethyst tools from Donut SMP to minecraft with customisable properties.<\/p>\n","protected":false},"featured_media":13544,"template":"","meta":{"_minecraft_slug":"amethysttools-dsmp","_minecraft_project_id":"bHLDOCDM","_minecraft_author":"dominik-kaspar-dev","_minecraft_license":"MIT","_minecraft_downloads":91,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"amethysttools-dsmp.zip","_minecraft_size_bytes":119961,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T20:08:51.713598Z","_minecraft_date_created":"2026-04-17T03:12:24.825652Z","_minecraft_date_modified":"2026-05-13T08:51:51.134917Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/amethysttools-dsmp","_minecraft_icon_attachment_id":13544,"_minecraft_imported_at":"2026-05-31T17:32:34+00:00","_minecraft_import_hash":"b49f5ef08cf185f7e4849004ec1d68da","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,88,127,123,92],"mod_loader":[130,132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-13543","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-equipment","mod_category-paper","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– \/at reload<\/p>\n
\n– amethysttools.admin<\/p>\n
\nitems:
\n amethyst_pickaxe:
\n aliases:
\n – pickaxe
\n – amethystpickaxe
\n – amethyst_pickaxe
\n material: NETHERITE_PICKAXE
\n name: “&dAmethyst Pickaxe”
\n lore:
\n – “&7Mines in a configurable area”
\n – “&7Expires in: &e%time%”
\n unbreakable: false
\n glow: true
\n enchantments:
\n EFFICIENCY: 5
\n UNBREAKING: 3
\n SILKTOUCH: 1
\n“`<\/p>\n
\n– SPAWNER
\n– CRYING_OBSIDIAN
\n– END_PORTAL_FRAME
\n– END_PORTAL
\n– END_GATEWAY
\n– NETHER_PORTAL
\n– REINFORCED_DEEPSLATE<\/p>\n
\n– usage
\n– invalid-player
\n– invalid-item
\n– gave-item
\n– received-item
\n– reloaded
\n– tool-expired<\/p>\n
\n– Minecraft API target: 1.21.x
\n– Java: 21<\/p>\n
\n2. Place it in your server plugins folder.
\n3. Start server once to generate config files.
\n4. Edit config.yml and messages.yml.
\n5. Run \/at reload.<\/p>\n","protected":false},"excerpt":{"rendered":"