Amethyst Drill – The Ultimate 3x3 Mining Tool



Tired of slow, block-by-block mining? Do you want to clear tunnels and veins with lightning speed, just like on popular servers like DonutSMP? Amethyst Drill is the lightweight, high-performance solution that brings powerful 3x3 area mining to your server, complete with custom features and player-controlled effects.

This plugin introduces a single, powerful tool designed to make mining faster, more satisfying, and fully configurable. With a custom durability system, unique particle effects, and simple commands, Amethyst Drill offers a premium experience without complex setups.



⚡ Features

• Massive Area Mining: Break blocks in a 3x3 area with a single swing, dramatically speeding up branch mining, tunnel clearing, and resource gathering.
  
  
• Custom Durability System: Forget vanilla durability. The Amethyst Drill comes with 3000 uses. Each 3x3 break consumes one use, and the item disappears when it reaches zero, preventing item clutter.
  
  
• No Vanilla Durability Loss: The tool is Unbreakable in the vanilla sense, meaning it won't take damage from regular use, relying solely on its custom "Uses" counter.
  
  
• Pre-Enchanted for Peak Performance: Spawns with a perfect combination of enchantments to ensure maximum speed and longevity: Efficiency V, Unbreaking III, and Mending.
  
  
• Custom Amethyst Particles: Each break creates a burst of purple portal particles, giving the tool a unique and magical feel inspired by its amethyst theme.
  
  
• Player-Controlled Effects: Don't like the particles? Each player can disable them for themselves with a simple command, ensuring a personalized experience without affecting others.
  
  
• Admin-Friendly Commands: Admins can easily spawn the Amethyst Drill for players, events, or rewards.
  
  
• Full Tab-Completion: All commands and subcommands feature intuitive tab-completion for ease of use.
  
  
• Lightweight and Performant: Designed with performance in mind. The 3x3 logic is optimized to prevent server lag, even during rapid use.
  

Performance and Design


The Amethyst Drill is more than just a powerful tool; it's built to be server-friendly. The plugin avoids recursive loops and includes a check to disable the 3x3 effect while sneaking, allowing for precise, single-block mining when needed. The custom durability is handled through Persistent Data Containers, the modern and efficient way to store item data without impacting performance.



Commands & Permissions

• amethystdrill.get (Default: OP) - Allows a player to spawn the Amethyst Drill.
  
  
• amethystdrill.particles (Default: everyone) - Allows a player to control their own particle effects.
  

Player & Admin Commands:

• /amethystpickaxe get - Gives the player one Amethyst Drill.
  
  • Aliases: /ap get, /drill get
    
• /amethystpickaxe particles <on|off> - Enables or disables the particle effects for the player using the command.
  
  • Aliases: /ap particles, /drill particles
    

Configuration (config.yml)


This plugin is designed to work perfectly out-of-the-box with zero configuration required. For those who want deep customization, a future update will include a config.yml. Here is a preview of what you'll be able to control:

YAML
# A preview of planned configuration options. Not yet implemented.
item:
name: "&5Amethyst Drill"
material: "NETHERITE_PICKAXE"
lore:
- "&7Breaks blocks in a 3x3 area."
- "&d&oA legendary tool from DonutSMP."
- ""
- "&fUses: &a%current_uses%/%max_uses%"
uses: 3000
unbreakable: true
enchantments:
- "EFFICIENCY:5"
- "UNBREAKING:3"
- "MENDING:1"

particles:
enabled-by-default: true
type: "PORTAL"
count: 20

messages:
prefix: "&5[AmethystDrill] &r"
receive_item: "&aYou have received an &5Amethyst Drill&a!"
particles_on: "&aDrill particles have been enabled."
particles_off: "&aDrill particles have been disabled."
no_permission: "&cYou do not have permission."

Bring a new level of efficiency and fun to your server's mining experience with the Amethyst Drill!