promotional bannermobile promotional banner

Amethyst Tools

AmethystTools is a Paper plugin that adds configurable custom mining tools, starting with the Amethyst Pickaxe. It is built for server owners who want powerful utility tools with safe defaults, clean permissions, and simple config-based expansion.

AmethystTools

AmethystTools is a Paper plugin that adds configurable custom mining tools, starting with the Amethyst Pickaxe.

It is built for server owners who want powerful utility tools with safe defaults, clean permissions, and simple config-based expansion.

Why AmethystTools

  • Area mining with configurable radius and depth
  • Expiring tools with automatic lore countdown updates
  • Automatic removal of expired tools
  • Per-item config system for easy future tool additions
  • Block protection via configurable blocked-materials list
  • Area-mining exclusions via mining.excluded-materials
  • Separate messages.yml for fully editable text
  • Config/message version checks to help with safe updates

Features

  • 3x3 style mining by default (radius: 1, depth: 1)
  • Blocks in mining.excluded-materials are only mineable directly (not as 3x3 side-breaks)
  • Expiry system (expiry.days) with %time% placeholder in lore
  • Dynamic /at give item input from config aliases
  • Admin reload command for config and messages
  • LuckPerms-friendly permission nodes

Commands

  • /at give <player> [item] [amount]
  • /at reload

Permissions

  • amethysttools.use
  • amethysttools.admin

Config Structure

The plugin uses an item map so you can add more tools later without editing Java code.

items:
  amethyst_pickaxe:
    aliases:
      - pickaxe
      - amethystpickaxe
      - amethyst_pickaxe
    material: NETHERITE_PICKAXE
    name: "&dAmethyst Pickaxe"
    lore:
      - "&7Mines in a configurable area"
      - "&7Expires in: &e%time%"
    unbreakable: false
    glow: true
    enchantments:
      EFFICIENCY: 5
      UNBREAKING: 3
      SILKTOUCH: 1

Add more tools by creating new keys under items and giving each key aliases.

Protected Blocks (Default)

  • BEDROCK
  • SPAWNER
  • CRYING_OBSIDIAN
  • END_PORTAL_FRAME
  • END_PORTAL
  • END_GATEWAY
  • NETHER_PORTAL
  • REINFORCED_DEEPSLATE

Area-Mining Exclusions (Default)

  • OBSIDIAN

Messages

All user-facing text is editable in messages.yml:

  • no-permission
  • usage
  • invalid-player
  • invalid-item
  • gave-item
  • received-item
  • reloaded
  • tool-expired

Compatibility

  • Server software: Paper
  • Minecraft API target: 1.21.x
  • Java: 21

Install

  1. Build or download the release jar.
  2. Place it in your server plugins folder.
  3. Start server once to generate config files.
  4. Edit config.yml and messages.yml.
  5. Run /at reload.

The Amethyst Tools Team

profile avatar
  • 8
    Projects
  • 314
    Downloads

More from dominikkaspardevView all

  • MSG DonutSMP project image

    MSG DonutSMP

    • 24
    • Bukkit Plugins

    A highly-configurable DonutSMP-style private messaging system for Paper servers (Java 17). Features vanish-aware messaging, persistent ignore lists with GUI management, MiniMessage formatting, PlaceholderAPI placeholders, and optional bStats metrics.

    • 24
    • May 14, 2026
    • Bukkit Plugins
    • +3
  • TPA DonutSMP project image

    TPA DonutSMP

    • 38
    • Bukkit Plugins

    This plugin brings TPA from Donut SMP to your server. Fully customisable for easy use with permissions for roles.

    • 38
    • May 14, 2026
    • Bukkit Plugins
    • +1
  • Shop DonutSMP project image

    Shop DonutSMP

    • 63
    • Bukkit Plugins

    Brings Donut SMP's shop into your own server. Fully customisable with vault currency and PlayerPoints

    • 63
    • May 13, 2026
    • Bukkit Plugins
  • RTP DonutSMP project image

    RTP DonutSMP

    • 31
    • Bukkit Plugins

    This plugin adds Random TelePort system from Donut SMP with customisable gui, permissions, messages and teleport zones for each world.

    • 31
    • May 13, 2026
    • Bukkit Plugins
    • +3
  • MSG DonutSMP project image

    MSG DonutSMP

    • 24
    • Bukkit Plugins

    A highly-configurable DonutSMP-style private messaging system for Paper servers (Java 17). Features vanish-aware messaging, persistent ignore lists with GUI management, MiniMessage formatting, PlaceholderAPI placeholders, and optional bStats metrics.

    • 24
    • May 14, 2026
    • Bukkit Plugins
    • +3
  • TPA DonutSMP project image

    TPA DonutSMP

    • 38
    • Bukkit Plugins

    This plugin brings TPA from Donut SMP to your server. Fully customisable for easy use with permissions for roles.

    • 38
    • May 14, 2026
    • Bukkit Plugins
    • +1
  • Shop DonutSMP project image

    Shop DonutSMP

    • 63
    • Bukkit Plugins

    Brings Donut SMP's shop into your own server. Fully customisable with vault currency and PlayerPoints

    • 63
    • May 13, 2026
    • Bukkit Plugins
  • RTP DonutSMP project image

    RTP DonutSMP

    • 31
    • Bukkit Plugins

    This plugin adds Random TelePort system from Donut SMP with customisable gui, permissions, messages and teleport zones for each world.

    • 31
    • May 13, 2026
    • Bukkit Plugins
    • +3