/
⛏️ xPickaxes
xPickaxes is a professional Spigot/Paper plugin that adds fully customizable pickaxes with area mining, an intuitive GUI, permission-based access, and special effects — all configurable without touching a single line of Java.
Compatible with Minecraft 1.19 – 1.21+ (Paper & Spigot)
✨ Features
- Area Mining — Mine 3×3, 5×5, 7×7, or 9×9 areas with a single block break
- In-game GUI — Right-click any custom pickaxe to open a clean configuration menu
- Special Effects
- 🔥 Auto-Smelting — Ores are smelted directly into ingots
- ✨ Fortune Boost — Increased drops on all mined blocks
- ⛏ Vein Miner — Mines entire connected ore veins at once (up to 64 blocks)
- 🔍 Ore Highlight — Visual glow effect on nearby ores (framework ready)
- Per-player Settings — Each player can toggle area mining and effects individually
- Permission System — Fine-grained control over which players access which pickaxes and effects
- Custom Area Sizes — Players can choose their preferred area size from the GUI
- Blacklist Support — Prevent area mining on specific blocks (bedrock, command blocks, etc.)
- WorldGuard Compatible — Respects protected regions
- Sound & Particle Effects — Satisfying feedback on area mines (toggleable)
- Fully Config-Driven — Add or edit pickaxe types entirely from
config.yml
📦 Pickaxe Tiers
| Tier | Area | Material | Effects | Permission |
|---|---|---|---|---|
| Novice | 3×3 | Iron Pickaxe | — | xpickaxes.pickaxe.novice |
| Adept | 5×5 | Golden Pickaxe | Fortune Boost | xpickaxes.pickaxe.adept |
| Master | 7×7 | Diamond Pickaxe | Fortune + Auto-Smelting | xpickaxes.pickaxe.master |
| Titan | 9×9 | Netherite Pickaxe | Fortune + Auto-Smelting + Vein Miner | xpickaxes.pickaxe.titan |
All tiers are fully editable or removable in config.yml. You can also add your own!
🎮 Commands
| Command | Description | Permission |
|---|---|---|
/xpickaxe give <type> [player] | Give a custom pickaxe | xpickaxes.give |
/xpickaxe list | List all available pickaxe types | xpickaxes.use |
/xpickaxe menu | Open the GUI for your held pickaxe | xpickaxes.use |
/xpickaxe reload | Reload the plugin config | xpickaxes.reload |
/xpickaxe help | Show help | — |
Aliases: /xpick, /xp
🔑 Permissions
| Permission | Default | Description |
|---|---|---|
xpickaxes.use | Everyone | Use custom pickaxes |
xpickaxes.give | OP | Give custom pickaxes |
xpickaxes.reload | OP | Reload the plugin |
xpickaxes.admin | OP | Full admin access (includes give + reload) |
xpickaxes.pickaxe.novice | Everyone | Access to Novice pickaxe |
xpickaxes.pickaxe.adept | OP | Access to Adept pickaxe |
xpickaxes.pickaxe.master | OP | Access to Master pickaxe |
xpickaxes.pickaxe.titan | OP | Access to Titan pickaxe |
xpickaxes.effect.autosmelting | OP | Use Auto-Smelting effect |
xpickaxes.effect.veinminer | OP | Use Vein Miner effect |
xpickaxes.effect.fortune | OP | Use Fortune Boost effect |
xpickaxes.effect.xray | OP | Use Ore Highlight effect |
🖥️ GUI Overview
Right-click any xPickaxes custom pickaxe (or run /xpickaxe menu) to open the configuration panel:
┌─────────────────────────────────────────────────────┐
│ [Pickaxe] [Pickaxe Configuration] │
│ │
│ [Toggle Area] [Compass] 3x37x7[✗]│
│ │
│ [★] [Effect1] [Effect2] [Effect3] [Effect4] │
│ │
│ [ℹ Info] │
│ [✖ Close] │
└─────────────────────────────────────────────────────┘
- Toggle Area Mining — Enable/disable area mining for this session
- Area Size — Select 3×3, 5×5, 7×7, or 9×9 (or reset to pickaxe default)
- Effects — Toggle each special effect independently (respects permissions)
⚙️ Configuration
All pickaxe types, effects, messages, and behavior is defined in config.yml. Here's an example of adding a custom pickaxe:
pickaxes:
my_custom_pick:
enabled: true
display-name: "&5✦ Void Pickaxe"
lore:
- "&7Area Mining: &e11x11"
- ""
- "&8▸ Right-click to configure"
material: NETHERITE_PICKAXE
area-size: 11
durability-multiplier: 4.0
enchantments:
EFFICIENCY: 5
UNBREAKING: 3
FORTUNE: 3
effects:
- FORTUNE
- AUTOSMELTING
- VEINMINER
permission: myplugin.voidpickaxe
give-command-enabled: true
custom-model-data: 0
Auto-Smelt Mappings
Add custom smelting recipes in config.yml:
smelt-map:
IRON_ORE: IRON_INGOT
GOLD_ORE: GOLD_INGOT
SAND: GLASS
# Add your own!
🔧 Installation
- Download
xPickaxes-1.0.0.jar - Drop it into your
plugins/folder - Restart or reload your server
- Edit
plugins/xPickaxes/config.ymlto customize - Run
/xpickaxe reloadto apply changes live
Requirements:
- Java 17+
- Paper or Spigot 1.19+
