SuperPickaxe Update – v15.0.7

• 
  
  
  • []Prison Mine Integration – Now you can set a required pickaxe level for any mine created by the Prison plugin. []Level‑Restricted Mining Zones – Every SuperPickaxe mining zone can have its own minimum pickaxe level. []New Admin Commands – /sp minelevel and /sp prisonlevel to configure those level requirements on‑the‑fly. []Config Enhancements – Added prison‑mines section with per‑mine level settings and a global default. []Permission Updates – New bypass permissions: - superpickaxe.zone.bypass - superpickaxe.prison.bypass []Message Localization – New language key mine-required-level-error for clear feedback.

• 
  
  
  • []Prison (official mine system) – Soft‑depend, no extra setup required. []Vault, PlaceholderAPI, MMOItems, ItemsAdder, Oraxen, Nexo – unchanged. (https://www.spigotmc.org/resources/prison.1223/) i used this prison plugins cause of it's open source

1. Enable Prison Integration
Make sure Prison is installed in your plugins folder. The plugin is automatically detected (soft‑depend), no extra configuration needed.

2. Set Minimum Pickaxe Level for a SuperPickaxe Zone

Code (Text):

Example: require level 20 for zone “myzone”
/sp minelevel myzone 20

You can also view the current setting:

Code (Text):

 /sp minelevel myzone

3. Set Minimum Pickaxe Level for a Prison Mine

Code (Text):

Example: require level 30 for Prison mine “A”
/sp prisonlevel A 30

If you omit the level, it will show the current requirement.

4. Bypass Permissions

superpickaxe.zone.bypass – Ignore level checks for SuperPickaxe zones.
superpickaxe.prison.bypass – Ignore level checks for Prison mines.
Give these permissions to staff or your trusted players as needed.

5. Configuration (config.yml)


yaml
mining-zones:
default-required-level: 0 # 0 = no level restriction

prison-mines:
enabled: true
default-required-level: 0
bypass-permission: "superpickaxe.prison.bypass"
mines:
A: 10
B: 25
C: 50
D: 100
Adjust the default-required-level to apply a global minimum.
Add or edit entries under mines: to set per‑mine requirements.
6. Message Customisation

The new language key can be edited in language.yml:


yaml
mine-required-level-error: "&cYour pickaxe needs to be at least &eLevel %level%&c to mine in &e%zone%&c!"
Replace %level% and %zone% with the appropriate values.

Code (Text):

 superpickaxe.admin – Full access (required for new commands) superpickaxe.zone.bypass – Bypass zone level checks superpickaxe.prison.bypass – Bypass Prison mine level checks

• 
  
  
  • []v15.0.5 – Prison integration, level‑restricted zones, new admin commands, config & permission updates. []v15.0.4 – Minor bug fixes and performance improvements.
  • v15.0.3 – Previous stable release.

If you have any questions or run into issues, feel free to open a ticket on our GitHub or drop a message in the discussion thread.

rewrite gem's logic

fix bugs from gems + support materials + sounds + effects, ....

⛏ SuperPickaxe v15.0.1 — Major Update!

9 NEW FEATURES have been added to the plugin! From Mining Contracts and Mining Pets to Stats HUD and Mining Aura — making SuperPickaxe the most complete mining plugin on SpigotMC!


✨ New Features










[HR][/HR]

Permissions


[HR][/HR]

How to Use




[HR][/HR]

⚡ API & Integration

• Vault — Full economy integration
• PlaceholderAPI — All new placeholders supported
• MMOItems — Custom items & blocks support
• ItemsAdder — Custom resource pack support
• Oraxen/Nexo — Custom blocks support
• ViaVersion — Cross-version compatibility (1.8 - 1.21+)

[HR][/HR]

Other Improvements

• Code reorganized — 57 files sorted into 6 sub-packages: manager/, listener/, gui/, hooks/, model/, util/
• ProGuard upgraded — Compatible with Java 25 class files (Oraxen 1.216.0+)
• Multi-language — All new features have English + Vietnamese translations
• Config migration — Auto-migrates old configs on update

nothing changed

nothing changed

⛏ SuperPickaxe v14.0.0 — Full Patch Notes

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✨ What's New

• Progress on ActionBar (not Chat)
  All mining progress notifications (Level Up, Tier Up, Evolution, Combo, Quest Progress) now display on the action bar above the hotbar instead of spamming chat. Cleaner interface, less clutter.
  
• Full Language Customization via language.yml
  Every single message, text, and number displayed to players is now read from language.yml. You can fully customize content, colors, and prefixes without touching any Java code. Supports any language — just edit the file.
  
• Blocks Per Hour on ActionBar
  The blocks/hr counter now appears on the action bar instead of chat, keeping your mining feed clean.

Shape System — Complete Rewrite

All 6 mining shapes have been rewritten with proper directional awareness. Every shape now correctly extends INTO the wall based on the player's facing direction (BlockFace).

• CUBE — Fixed orientation logic. Width (rx), height (ry), and depth (rz) now correctly map to the player's view direction. Looking up/down vs east/west vs north/south all produce the correct 3D cube relative to the wall face.
  
• CROSS — Main arm extends INTO the wall. Perpendicular arms stay at the surface layer. Properly skips duplicate center blocks on deeper layers.
  
• SPHERE — Hemisphere shape: full circle at surface, shrinking radius for each deeper layer. Uses distance-based fill to create a smooth rounded profile.
  
• TUNNEL — Drills straight INTO the wall with a configurable cross-section. Uses raw block coordinates with direction vectors for consistent behavior across all 6 facing directions.
  
• PYRAMID — Base square at surface (full rx size), shrinks by 1 per depth layer until it reaches a single point. Correct orientation for all player facing directions.
  
• DRILL — Now a proper ShapeProfile enum value (no longer a separate toggle that could overlap other shapes). Only activates when player explicitly selects shape=DRILL AND the cup allows abilities. Mines a 1x3 tunnel forward to a configurable depth.

Shape Auto-Correction Fix
If a cup has radius-x/y/z all set to 0 but uses a radius-based shape (CUBE, SPHERE, CROSS, PYRAMID), the system now auto-corrects to radius=1 and logs a warning. This prevents CUBE from accidentally behaving like a single-block tunnel.

Bug Fixes

• Fixed — CUBE shape orientation was inconsistent across different player facing directions
• Fixed — CROSS shape had duplicate center blocks on deeper layers
• Fixed — SPHERE shape didn't properly shrink per depth layer
• Fixed — TUNNEL shape broke on vertical (up/down) facing
• Fixed — PYRAMID shape ignored player facing direction
• Fixed — DRILL mode could overlap/override other shapes (now a proper ShapeProfile)
• Fixed — Zero radius cups causing CUBE to behave like single-block mining
• Fixed — All hardcoded Vietnamese strings replaced with language.yml keys

Compatibility

• CompatUtil — Full 1.8 to Latest Support
  • Material: Auto-fallback 1.13+ names → 1.8 names (with data values for 1.8-1.12)
  • Sound: Auto-fallback 1.13+ names → 1.8 names (cached, safe resolve)
  • ItemStack: Data value support for 1.8-1.12 wool/dye/stone variants
  • Version Detection: Auto-detect major.minor, cached on first call
  • Shortcuts: Glass panes, dyes, player heads, netherite→diamond fallbacks

Files Modified

• language.yml — Added ~30 new entries (usage, error, price-setup, price-gui, blocks-per-hour, setlevel, gem)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

i watched the file again and i saw a problem from the menu and mininglistener. Fixed

I create this update to remake all file yaml and switch to english all. I think that will make you more easier

Thks u for using my plugins

SuperPickaxe v13.0.0 — The Biggest Update Yet!
This update brings 7 brand-new features, expanded plugin support, and full
Minecraft version compatibility from 1.8 all the way to 1.21+.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ACHIEVEMENT SYSTEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• 9 built-in achievements: First Mine, Apprentice/Skilled/Expert/Legendary Miner,
Quest Master, First Blood, Duel Champion, On Fire!
• Fully configurable in config.yml — add your own achievements with custom
icons, rewards, thresholds and types (blocks / quests / duel_wins / streak)
• Broadcast on unlock, money reward, sound effect
• GUI accessible via /sp achievement or the main menu
• Saved per-player in achievements.yml
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
NOTIFICATION SETTINGS GUI
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Players can now toggle individual notification types instead of all-or-nothing
• 8 toggleable types: Level Up, Streak Bonus, Milestone, Lucky Drop,
Auto-Sell, AFK Warning, Achievement, Quest Progress
• Open via /sp notify or the main menu
• Settings saved per-player and persist across restarts
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ORE HEATMAP GUI
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Visual breakdown of the top ores each player has mined
• Top 5 ores displayed with animated progress bars
• Remaining ores listed below sorted by count
• Open via /sp heatmap or the main menu
• Bar length configurable in config.yml
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
MINING PARTY SYSTEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Form a party of up to 4 players to mine together
• Commands: /sp party create | invite | accept | deny | leave | info
• Party members share streak bonuses and active boosters
• Invite timeout and max party size configurable in config.yml
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SCHEDULED EVENTS (Auto-Start)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Schedule mining events to start automatically at specific times
• Configure hour, minute, duration, target blocks, prize and days of week
• Multiple schedules supported (e.g. weekday evening + weekend afternoon)
• Skips automatically if an event is already running
• Fully configurable in config.yml under scheduled-events
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙️ ADMIN DASHBOARD GUI
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• One-click admin overview: online players holding pickaxes, active booster,
active event, top 3 leaderboard, global blocks mined today
• Quick-action buttons: start Money Booster x2, start Quick Event, reload config
• Safe leaderboard reset with 2-click confirmation
• Open via /sp admin (requires superpickaxe.admin)
• Quick event and booster values configurable in config.yml
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
EXPANDED CUSTOM DROP SUPPORT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Previously only MMOItems was supported. Now custom drops work with:
• MMOItems — MMOITEMS|TYPE|ID|min|max|chance
• ItemsAdder — ITEMSADDER|namespace:id|min|max|chance
• Oraxen / Nexo — ORAXEN|item_id|min|max|chance
• Vanilla — VANILLA|MATERIAL|min|max|chance
Custom block detection also works for all 3 plugins when using area mining.
All hooks use reflection — no hard dependency required.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FULL VERSION COMPATIBILITY (1.8 → 1.21+)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Introduced CompatUtil — a centralized compatibility layer:
• All Materials auto-resolve with fallback (e.g. LIME_DYE → INK_SACK:10 on 1.8)
• All Sounds use valueOf + Throwable catch to prevent NoSuchFieldError crashes
(e.g. ENTITY_PLAYER_LEVELUP → LEVEL_UP on older versions)
• Server version detected once on startup and cached
• No more crashes from missing Material or Sound names across versions
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
NEW COMMANDS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
/sp achievement — View your achievements
/sp heatmap — View your ore heatmap
/sp notify — Open notification settings GUI
/sp party <sub> — Party system (create/invite/accept/deny/leave/info)
/sp admin — Admin dashboard (admin only)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SOFT DEPENDENCIES ADDED
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ItemsAdder, Oraxen, Nexo, MMOItems (all optional — plugin works without them)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠️ UPGRADE NOTES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• achievements.yml and player_stats.yml are new data files — created automatically
• All existing pickaxe data, leaderboard and quest progress is preserved

SuperPickaxe v13.0.0 — The Biggest Update Yet!
This update brings 7 brand-new features, expanded plugin support, and full
Minecraft version compatibility from 1.8 all the way to 1.21+.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ACHIEVEMENT SYSTEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• 9 built-in achievements: First Mine, Apprentice/Skilled/Expert/Legendary Miner,
Quest Master, First Blood, Duel Champion, On Fire!
• Fully configurable in config.yml — add your own achievements with custom
icons, rewards, thresholds and types (blocks / quests / duel_wins / streak)
• Broadcast on unlock, money reward, sound effect
• GUI accessible via /sp achievement or the main menu
• Saved per-player in achievements.yml
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
NOTIFICATION SETTINGS GUI
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Players can now toggle individual notification types instead of all-or-nothing
• 8 toggleable types: Level Up, Streak Bonus, Milestone, Lucky Drop,
Auto-Sell, AFK Warning, Achievement, Quest Progress
• Open via /sp notify or the main menu
• Settings saved per-player and persist across restarts
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ORE HEATMAP GUI
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Visual breakdown of the top ores each player has mined
• Top 5 ores displayed with animated progress bars
• Remaining ores listed below sorted by count
• Open via /sp heatmap or the main menu
• Bar length configurable in config.yml
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
MINING PARTY SYSTEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Form a party of up to 4 players to mine together
• Commands: /sp party create | invite | accept | deny | leave | info
• Party members share streak bonuses and active boosters
• Invite timeout and max party size configurable in config.yml
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SCHEDULED EVENTS (Auto-Start)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Schedule mining events to start automatically at specific times
• Configure hour, minute, duration, target blocks, prize and days of week
• Multiple schedules supported (e.g. weekday evening + weekend afternoon)
• Skips automatically if an event is already running
• Fully configurable in config.yml under scheduled-events
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙️ ADMIN DASHBOARD GUI
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• One-click admin overview: online players holding pickaxes, active booster,
active event, top 3 leaderboard, global blocks mined today
• Quick-action buttons: start Money Booster x2, start Quick Event, reload config
• Safe leaderboard reset with 2-click confirmation
• Open via /sp admin (requires superpickaxe.admin)
• Quick event and booster values configurable in config.yml
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
EXPANDED CUSTOM DROP SUPPORT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Previously only MMOItems was supported. Now custom drops work with:
• MMOItems — MMOITEMS|TYPE|ID|min|max|chance
• ItemsAdder — ITEMSADDER|namespace:id|min|max|chance
• Oraxen / Nexo — ORAXEN|item_id|min|max|chance
• Vanilla — VANILLA|MATERIAL|min|max|chance
Custom block detection also works for all 3 plugins when using area mining.
All hooks use reflection — no hard dependency required.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FULL VERSION COMPATIBILITY (1.8 → 1.21+)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Introduced CompatUtil — a centralized compatibility layer:
• All Materials auto-resolve with fallback (e.g. LIME_DYE → INK_SACK:10 on 1.8)
• All Sounds use valueOf + Throwable catch to prevent NoSuchFieldError crashes
(e.g. ENTITY_PLAYER_LEVELUP → LEVEL_UP on older versions)
• Server version detected once on startup and cached
• No more crashes from missing Material or Sound names across versions
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
NEW COMMANDS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
/sp achievement — View your achievements
/sp heatmap — View your ore heatmap
/sp notify — Open notification settings GUI
/sp party <sub> — Party system (create/invite/accept/deny/leave/info)
/sp admin — Admin dashboard (admin only)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SOFT DEPENDENCIES ADDED
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ItemsAdder, Oraxen, Nexo, MMOItems (all optional — plugin works without them)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠️ UPGRADE NOTES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• achievements.yml and player_stats.yml are new data files — created automatically
• All existing pickaxe data, leaderboard and quest progress is preserved

I forgot to save the config.yml file sorry

Hey everyone! We are extremely excited to bring you one of the biggest updates yet for SuperPickaxe. This version introduces brand new server-wide activities, an engaging reward system, and major quality-of-life improvements!

NEW: MINING EVENT SYSTEM
Host thrilling, competitive mining races across the entire server!

• Real-time Progress Bar: Players can see their live standings and progress dynamically.
• Customizable Rewards品: Set specific block targets and monetary rewards easily.
• Admin Command: /sp event start <minutes> <blocks> <money>

NEW: MINING CRATE SYSTEM
Reward your hard-working players with highly engaging mystery crates!

• Smooth GUI Animation: Features a beautiful, rolling CS:GO-style spin animation when opened.
• Randomized Loot: Fully configurable drop chances for items and commands.
• Admin Command: Give crates directly to lucky players as events or milestone rewards!

NEW: MINING WAND SYSTEM
Managing your mining regions and actions is now easier than ever!

• Intuitive Selection: Easily select positions and set up your mining regions with a dedicated physical wand item.
• Fast Configuration: Speed up your admin workflow without typing long coordinates manually.

⚙️ FIX & IMPROVEMENT: AUTO-UPDATE CONFIG
No more manual resets or broken configuration files!

• Seamless Auto-Update: The plugin will now automatically inject new options into your existing config.yml upon updating.
• Safe Migration: Your old settings, custom values, and comments are fully preserved during the process.

i think i will fix it soon

✨ SUPERPICKAXE UPDATE v11.0.0 ✨
Bringing a more thrilling and engaging mining experience than ever before!

---

FEATURE 1: LUCKY SPIN

Description:
When mining blocks with a special pickaxe, players have a small random chance to receive a Spin Ticket (a special Paper item in their inventory). Use the /sp spin command to open a 3x3 GUI wheel with a rolling animation that stops to grant a random reward.

Available Rewards (Fully configurable in config.yml):

• Large Cash Prizes: From $5,000 to $50,000.
• ⚡ 30-Minute Boosters: Money x2 or XP x2.
• Rare Items: Diamonds, Netherite Ingots...
• Free Pickaxe Repair.
• Jackpot: Double drops on the next mine!
• ❌ Nothing: An unlucky slot (no reward) to add more drama and excitement.

️ Gameplay Flow:

1. Mine blocks ➡️ 0.5% random chance to drop a Spin Ticket directly into the inventory.
2. Server broadcast: [LUCKY] %player% just received a Spin Ticket! Use /sp spin
3. Type /sp spin ➡️ Opens a 9-slot GUI, playing a 2-second rolling animation.
4. A random slot flashes ➡️ Rewards are given + Server broadcast if it's a Jackpot.

---

⚔️ FEATURE 2: MINING DUEL

Description:
Players can use the command /sp duel <player> <bet_amount> to challenge someone to a 1v1 match. Both players will mine at the same time for 60 seconds; whoever breaks more blocks wins and takes the entire pool!

️ Gameplay Flow:

1. /sp duel Steve 10000 ➡️ Sends a duel invitation with a bet. Steve receives a notification to accept via /sp duel accept.
2. Once accepted ➡️ Countdown 3 - 2 - 1 ➡️ The 60-second duel begins.
3. During the duel, the ActionBar continuously updates in real-time: [DUEL] You: %blocks% | Steve: %blocks% | %time%s left
4. Time's up ➡️ Server-wide broadcast of the results, and the winner is automatically rewarded.

Rules:

• Players must be holding a special pickaxe to participate in a duel.
• A player cannot participate in or host two duels simultaneously.
• The duel request will automatically expire (Timeout) after 30 seconds if not accepted.
• Block count is tracked accurately using the totalBrokenThisTurn variable from MiningListener.

---

️ PROPOSED CHANGES (CODE STRUCTURE)

• [NEW] SpinManager.java: Manages spin logic, generates Spin Tickets, handles random drops, and calculates rewards based on configuration rates.
• [NEW] SpinGUI.java (Listener): Creates the 9-slot GUI with a fake rolling animation (Uses a Bukkit scheduler running 5 times to update slots), handles click events, and distributes rewards.
• [NEW] MiningDuelManager.java: Manages pending and active duels using a Map: UUID ➡️ DuelSession { opponent, blocks, endTime, bet }. Integrates a scheduler to update the ActionBar every second.
• [MODIFY] MiningListener.java: Adds the random Spin Ticket drop after the processBlockBreak method and increments block count for the DuelSession if the player is in an active duel.
• [MODIFY] SuperPickaxePlugin.java: Initializes the new managers (SpinManager, MiningDuelManager) and registers the SpinGUI listener.
• [MODIFY] SuperPickaxeCommand.java: Implements new subcommands:
  • • /sp spin — Opens the SpinGUI (Only works if holding a ticket).
  • • /sp duel <player> <amount> — Sends a duel invite with a specific bet amount.
  • • /sp duel accept — Accepts the incoming duel invite.
  • • /sp duel cancel — Declines or cancels the current duel.

---

CONFIGURATION & LANGUAGE FILES

⚙️ config.yml
language.yml

• Added all required message strings for the Lucky Spin and Mining Duel systems for easy localization.

---

VERIFICATION PLAN

1. Mine blocks with a special pickaxe ➡️ Wait for a Spin Ticket to drop ➡️ Use /sp spin ➡️ Verify the animation runs smoothly and rewards are given properly according to weights.
2. Run /sp duel <player> <amount> ➡️ Have the target player accept ➡️ Verify countdown ➡️ Confirm the ActionBar updates blocks and time live ➡️ Ensure the winner gets the correct payout at the end.
3. Test edge cases: Prevent duels when not holding a special pickaxe, having insufficient balance, or when already in another duel session.

Try guess A fix + new model

CORE MINING FEATURES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Area Mining (Radius Mode): Mine multiple blocks at once in a configurable radius (e.g., 3x3, 5x5, 7x7). The radius can be set per pickaxe dynamically in config.yml.
• Directional Mining: Mine exactly in the direction you are facing. Configure width, height, and length independently (e.g., a 3x3x5 tunnel straight forward).
• Shape Profiles: Switch between 4 distinct mining shapes on the fly using /sp shape <CUBE|CROSS|TUNNEL|SPHERE>
  • CUBE: Standard box area mining (Default).
  • CROSS: Plus-sign mining pattern, skipping the corner blocks.
  • SPHERE: Ellipsoid-shaped mining area calculated using Euclidean distance.
  • TUNNEL: A 1x3 vertical slice pattern, ideal for fast tunneling.
• Vein Miner: Automatically mines entire connected ore veins. Supports an optional Smart Vein mode that detects any ore chain regardless of the block material.
• Drill Mode (/sp drill): Instantly bores a 1x3 tunnel straight in your facing direction up to a configurable depth (Default: 10 blocks).
• Turbo Mode (/sp turbo): Doubles durability consumption but expands your mining radius by +1 in all directions (Requires the ability to be enabled on the item).
• Mining Trail: Displays interactive smoke particles around the targeted area, allowing players to preview their exact break radius before swinging.

PICKAXE PROGRESSION SYSTEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Level & Tier System: Every pickaxe tracks its own independent Level and Tier progression. Players earn XP/levels by mining blocks. Reaching the max level automatically upgrades the pickaxe's Tier.
• Prestige System (/sp prestige): When a pickaxe reaches its absolute max level and tier, players can reset it via a full GUI for a price. Prestige grants permanent bonuses:
  • Bonus economy money multiplier percentage per prestige.
  • Bonus block drop multiplier percentage per prestige.
  • Configurable maximum prestige limits per item key.
  • Intuitive GUI layout tracking stats, requirements (Green/Red indicators), and costs.
• Evolution (Tracker): Tracks total lifetime blocks mined with that tool. Reaching major milestones evolves the pickaxe, granting permanent bonus radius, width, or money multipliers.
• Fortune per Level: Bind Fortune stats to your tool's progression. The block drop multiplier automatically scales as the pickaxe levels up.
• Mining Speed per Tier: Grants background Haste effects based on the current Tier of the tool (e.g., Tier 1 = Haste I, Tier 5 = Haste V).

ECONOMY FEATURES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Auto-Sell: Instantly sells broken blocks at prices managed inside your config. Integrates seamlessly with Vault.
• Tax System: Configure custom tax percentages per pickaxe. A percentage of all auto-sell earnings will be deducted as a server tax sink.
• Streak Bonus: Mine continuously to build a combo streak. The longer a player keeps mining without stopping, the higher their financial bonus multiplier.
• Auto-Smelt: Automatically converts raw ores into processed ingots (e.g., Iron Ore ➔ Iron Ingot) via a fully customizable auto-smelt-map.
• Auto-Block: Automatically compresses inventory drops into block forms (e.g., 9 Diamonds ➔ 1 Diamond Block) to save inventory space.
• Auto-Pickup: Instantly places mined drops into the player's inventory. Includes a built-in whitelist/blacklist filter to fine-tune pickups.

️ CUSTOM DURABILITY SYSTEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Custom Durability: Uses a proprietary durability engine separate from vanilla Minecraft mechanics. Displays dynamically inside the item's lore and updates in real-time.
• Durability Warning: When a tool drops below 10% durability, its display name turns red and plays an audio alert. At 0%, it converts to a "Broken" status and cannot mine.
• Repair (/sp repair): Spend server currency to fully restore the tool's durability, safely resetting its cosmetic display name back to original conditions.
• Auto-Repair: Background repair task that automatically restores fixed durability values on a customizable timer interval.

QUESTS, LEADERBOARDS & COMMUNITY
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Daily Quest System (/sp quest): Selects a random mining assignment from a pool every day. Features an interactive GUI containing active assignments, progress bars, completion tracking, and rewards (Money + Items). Resets automatically at midnight with a global broadcast.
• Leaderboard (/sp top): Tracks total blocks mined per player with support for daily, weekly, monthly, or permanent rotation cycles. Features top-tier rewards for Top 3 rankings alongside full GUI moderation capabilities for admins.
• Community Challenge (/sp goal): A cooperative server-wide goal. When the cumulative network block count hits the target, all online players receive a global money multiplier buff for a limited time.
• Mining Milestones: Triggers financial bonuses and server-wide praise when an individual reaches lifetime mining counts (e.g., 1k, 10k, 100k blocks).
• Lucky Drop: Introduces a tiered lottery system with low percentage chances to drop custom Jackpots (money and items) while mining, alongside network alerts.
• Custom Drop Table System: Override vanilla drop configurations completely. Supports vanilla assets and custom MMOItems block/item IDs. Can be modified visually in-game using the /sp wand.
• Anti-AFK Mining Guard: Actively monitors players mining in fixed spatial coordinates for too long. Deploys warning prompts and penalty efficiency reductions until movement is verified.

⚙️ GUI MENUS & PERSONAL SETTINGS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Main Menu Hub (/sp menu): A central GUI command center giving quick access to progression data, active quests, leaderboards, community targets, personal metrics, and toggle shortcuts.
• Personal Settings (/sp ignoredblocks): Allows individual users to open a personal GUI menu and whitelist blocks they want area mining and vein miner scripts to completely ignore.
• Notification Toggles (/sp notify): Allows heavy players to mute level-ups, streak alerts, transactional sell invoices, durability warnings, and quest milestones to keep their chat feed clean.

PERMISSION-BASED RANK SYSTEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Manage command nodes effortlessly using permission managers like LuckPerms or PermissionsEx.

• Rank D — superpickaxe.rank.d
  • Unlocks: /sp quest, /sp top
• Rank C — superpickaxe.rank.c
  • Unlocks: /sp repair, /sp shape (Includes all lower Rank nodes)
• Rank B — superpickaxe.rank.b
  • Unlocks: /sp drill, /sp turbo (Includes all lower Rank nodes)
• Rank A — superpickaxe.rank.a
  • Unlocks: /sp prestige, /sp goal (Includes all lower Rank nodes)
• Rank S — superpickaxe.rank.s
  • Unlocks: /sp ignoredblocks (Includes all lower Rank nodes)
• Admin Authority — superpickaxe.admin
  • Unlocks full bypass access and developer commands: /sp give, /sp reload, /sp wand, /sp pricegui, /sp setlevel, /sp inspect, /sp broadcast, /sp top reset

COMMANDS REFERENCE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▶️ Player Commands:
▶️ Admin Commands:
PLACEHOLDERS & DEPENDENCIES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PlaceholderAPI Variables:

• %superpickaxe_level% — Fetches the active tool level.
• %superpickaxe_tier% — Fetches the active tool tier index.
• %superpickaxe_prestige% — Fetches the current tool prestige tier.
• Perfect for Scoreboards, Tablists, Chat formats, and DecentHolograms setups.

Required Dependencies: Vault (Economy infrastructure)
Optional Hook Support: PlaceholderAPI, MMOItems, DecentHolograms

Changelog v6.0.1 - Auto-Fill Configuration Feature

Hello everyone, here is a quick but essential update for SuperPickaxe to make managing your configuration files much easier!

What's New?

• Auto-Configuration Updater: Added a new built-in feature that automatically detects and injects any missing sections or keys into your existing .yml files.
• No More Resets: You no longer need to delete your old configuration files or manually copy-paste new options when updating the plugin. Your custom settings are 100% safe!

[HR][/HR]
If you encounter any bugs or have any suggestions, please report them on my Discord server or the discussion section. Thank you for using SuperPickaxe!

NEW FEATURES & HIGHLIGHTS

1. Automated Daily Quests System
Keep your players engaged every day with dynamically generated mining challenges and exciting rewards!

• Automatically rolls a random quest (e.g., mine 500 Stone) at the start of each day.
• Smart Auto-Reset Mechanism at a configurable time (default 00:00) with a global server-wide broadcast.
• Supports flexible multi-rewards: direct money deposits (Vault Economy supported) and custom items.
• Players can instantly check their live progress with the new /sp quest command.

2. Auto-Reset Mining Leaderboards
Honor your most dedicated grinders with a robust, highly optimized, and automated ranking system.

• Multiple Reset Schedules: Choose between Daily, Weekly, Monthly, or Never.
• PlaceholderAPI & DecentHolograms Hooking: Display live data directly onto your holographic displays using %superpickaxe_top_N% (player name) and %superpickaxe_top_N_blocks% (block count).
• Highly optimized Asynchronous Auto-Save loops every 5 minutes to guarantee absolute zero server lag.

3. Lucky Drops & Jackpot Reward System
Add thrilling moments to the standard mining loop with unexpected surprise rewards!

• Trigger randomized loot drops based on a tiny percentage chance per block mined (fully configurable).
• Massive jackpot rewards including vault cash and rare item arrays (items automatically drop to the ground safely if the inventory is completely full).
• Broadcasts grand, customizable celebratory server alerts to announce lucky winners.

4. Custom Drop GUI - Interactive Chat Input
A groundbreaking quality-of-life feature dedicated to Server Admins! Forget dealing with tedious config files or entering complex commands:

• Simply Right-Click any item inside the Custom Drop configuration GUI.
• Type the new drop rate percentage (Chance) or quantity (Min/Max Amount) straight into the standard Chat box.
• The system instantly processes, validates, saves the input, and automatically re-opens the GUI for a seamless workflow! Fully compatible with vanilla items and MMOItems.

DEVELOPER CORNER (NEW API & CORE MANAGERS)
We have fully refactored the core infrastructure into isolated, developer-friendly modules for extreme reliability:

• DailyQuestManager: Handles quest lifecycles, active generation seeds, and independent persistent data mapping per player UUID.
• LeaderboardManager: Features high-performance sorting algorithms running in real-time, matching system clock timezone criteria.
• LuckyDropManager: Controls jackpot rolling probabilities using perfectly distributed randomization seeds.
• DropChatInputListener: Thread-safe chat session tracker hooking directly into `AsyncPlayerChatEvent` to cleanly intercept and filter admin entries.

⛏️ SuperPickaxe - Update v5.0.5 ⛏️
Custom Drop Toggles & Full Language Customization[/ALIGN]

[HR][/HR]

Hey players and server owners! A new update for SuperPickaxe is officially live. This update reworks the core drop mechanics and grants you full control over every single message in the plugin.

Changelog

• REWORK Vanilla Override Mechanic
  The vanilla override feature has been completely redesigned to give you better control over your server economy:
  • When Enabled (ON): Mining blocks will successfully reward players with your configured Custom Drops.
  • When Disabled (OFF): Mining blocks will fall back to standard Vanilla Drops.
• NEW Full Language Customization
  • No more hardcoded text! You can now customize, translate, and modify 100% of the messages and language strings directly inside the configuration file. Perfect for non-English servers!

[HR][/HR]

⚠️ Important Notes
To ensure everything works perfectly, please regenerate your configuration file (delete/rename the old one and restart the server) or manually add the new language and toggle nodes to your existing config.

Thank you for supporting SuperPickaxe! If you encounter any bugs or have suggestions, feel free to drop them in the discussion section! ⭐[/ALIGN]

NEW FEATURES

• Full MMOItems Support in GUI: You can now directly drag and drop items from MMOItems into the Custom Drops interface to set up block/ore drop rewards seamlessly and intuitively!

BUG FIXES & IMPROVEMENTS

• Fixed MMOItems turning into DIRT/Vanilla items: Resolved a critical issue on newer Paper/Spigot 1.20+ versions where NBT data was automatically stripped when opening or closing inventories. The system now utilizes a smart Hidden Lore Mechanism (Hidden Metadata Storage) to ensure 100% item data preservation.
• Optimized GUI Toggle Button: Fixed a compilation error and optimized the logic for the "Override Vanilla Drops" toggle function, ensuring smooth state transitions without freezing or data loss during saves..

A brand new, robust system to fully manage items dropped upon breaking blocks! Turn ordinary stone or dirt into valuable treasures, or seamlessly integrate your mining mechanics with today's top RPG plugins.
✨ Key Highlights & Features:

• Full MMOItems & MMOBlocks Integration: Drop custom items from MMOItems or recognize custom blocks placed via MMOBlocks. Built using an ultra-smooth Reflection system, meaning it is completely safe and won't cause any errors even if MMOItems/MMOBlocks aren't installed on your server!
• Replace Vanilla / Additive Modes: Highly flexible configuration. Choose to completely wipe out standard Minecraft drops (e.g., breaking iron ore rewards custom loot instead of iron) or let them drop alongside vanilla items.
• Dynamic Random Amounts (Min/Max): Define quantitative boundaries for drop entries (e.g., dynamically drops anywhere between 1 and 5 diamonds).
• Precise Drop Rates (Chance): Set exact drop probabilities ranging from 0% to 100% (represented mathematically as 0.0 to 1.0) for every single entry.
• Performance Optimized (Lag-Free): Data profiles are cached completely in memory upon loading. Zero constant file-reading overhead, ensuring flawless performance during high-speed instamine or multi-block breaks.

The plugin will automatically generate a clean, well-structured custom_drops.yml file inside your plugin directory:

[NEW GUI] SuperPickaxe | Radius & VeinMiner Control | Prestige & Auto-Sell
SuperPickaxe v3.0.0 - Major Update!

Welcome to the latest version of SuperPickaxe. This update brings massive improvements to player personalization, customization, and plugin security.

✨ What's New?
Personalized Settings GUI
Players now have full control over their tools without needing complex commands!

• Command: /sp ignoredblocks
  
  
• Features:
  
  • Radius Toggle: Enable or disable wide-area mining on the fly.
    
    
  • Vein Miner Toggle: Control chain-mining functionality individually.
    
    
  • Ignored Blocks Manager: Easily add or remove materials you don't want to mine in a user-friendly GUI. All settings are saved automatically per player.
    

Security & Performance Improvements

• Optimized event handling to prevent block-related exploits.
  
  
• Enhanced permission checks across all commands and GUI actions.
  
  
• Fixed configuration synchronization issues for stable tool performance.
  

Commands

• /sp give <pickaxe_name> <player> - Get a special pickaxe.
  
  
• /sp reload - Reload plugin configurations.
  
  
• /sp repair - Repair your custom pickaxe.
  
  
• /sp prestige - Reset Level/Tier to increase Prestige rank.
  
  
• /sp goal - View progress of the Community Mining Goal.
  
  
• /sp ignoredblocks - Open the personal settings GUI for blocks.
  
  
• /sp pricegui - Open the Item Pricing management GUI.
  

⚙️ Setup Guide

1. Download the .jar file and drop it into your plugins folder.
   
   
2. Restart your server to generate configuration files.
   
   
3. Edit pickaxes.yml to define your custom mining tools.
   
   
4. Vault is required for the Auto-Sell feature.
   

Note: After updating, please check your player_settings.yml to ensure player data transitions smoothly. If you experience issues, double-check that the display-name in your pickaxes.yml exactly matches the item name in-game.

Thank you for using SuperPickaxe. If you find this plugin helpful, please consider leaving a 5-star review!

i just want to see how many server using my plugins

I just add bstat into the latest -_-

SuperPickaxe Version 1.9 is here! This major update introduces a brand new core progression mechanic to keep your players grinding and fully integrates with your server's UI/Chat via PlaceholderAPI.

What's New?

• Pickaxe Level & Tier (Prestige) System:
  
  • Players can now level up their pickaxes simply by mining blocks.
    
    
  • Automatic Prestige Logic: Once a pickaxe reaches its maximum level (e.g., Level 10), it will automatically evolve to the next Tier and reset its level back to 1 seamlessly while mining!
    
• PlaceholderAPI Expansion Added:
  
  • You can now display pickaxe stats anywhere (Scoreboard, Tab, Chat, or DeluxeMenus) using these two new placeholders:
    
    
  • %superpickaxe_level% — Displays the current level of the held pickaxe.
    
    
  • %superpickaxe_tier% — Displays the current prestige tier of the held pickaxe.
    

️ Improvements & Bug Fixes

• Dependency Upgrade: Updated and compiled against the latest PlaceholderAPI 2.12.2 for optimal performance and stability.
  
  
• Fixed compilation & runtime errors regarding ConfigurationSection casing in PriceGUIListener. The configuration parsing is now completely bulletproof.
  

Thank you for using SuperPickaxe! If you encounter any bugs or need support with the new tier configurations, please reach out via the discussion section.

SuperPickaxe v1.8.3 - Evolution & Permission Update



Hello everyone!
I am happy to bring you the latest update for SuperPickaxe. This update focuses on adding more control for server owners regarding the pickaxe evolution system.

✨ Key Changes:

• [] Permission-based Evolution: Evolution is now restricted by permissions. Even if players have broken enough blocks, they now need the [.evolve] node to successfully evolve their pickaxe[cite: 10].
  [] Custom Denied Messages: Added a new [evolution-denied] message in the language file. Now you can fully customize what players see when they don't have permission to evolve their items.
• Language Localization: The [language.yml] file has been fully translated into English to better support international servers.

⚙️ Configuration Example:

⚙️ UPDATE LOG v1.8.2 - CRITICAL BUG FIXES & STABILITY IMPROVEMENTS
Hello everyone! We are bringing you an essential update that addresses severe duplication bugs, performance issues, and security loopholes within the Price GUI system. It is highly recommended that all servers upgrade to this version immediately.
What's New in this Version?
1. CRITICAL DUPLICATION EXPLOIT PATCHED
- Fixed a major glitch in the SuperPickaxeCommand where an unintentional duplicate event handler registration caused the menu listener to trigger multiple times simultaneously.
- This completely stops players from using click-tricks to multiply or clone items inside the Price GUI container.
2. SYNC & ASYNC THREAD SAFETY IMPROVEMENTS
- Resolved an internal server crash related to the AsyncPlayerChatEvent inside the PriceSetupListener.
- All chat prompt interactions for assigning values to blocks have been properly bound to the Server Main Thread, preventing thread safety violations and asynchronous block data corruption.
3. ️ ADMIN PRIVILEGE & EXPLOIT SECURITY HARDENING
- Fixed a security loophole where regular players could manipulate custom inventory actions via container renames.
- Price GUI controls now strictly validate the "superpickaxe.admin" permission nodes for ALL interactive slot clicks. Normal players can no longer bypass or corrupt the price matrix file (prices.yml) under any circumstances.
4. CODE CLEANUP
- Removed corrupted characters, missing syntax braces, and standardized the underlying loop parsing logic for custom item enchantments.
How to upgrade:
1. Stop your server.
2. Replace your old SuperPickaxe.jar file with the new v1.8.2 version.
3. Restart your server and enjoy a secure, stable experience!
Thank you for your continuous support. If you encounter any bugs, please report them via our official channels before leaving a negative review! ⭐⭐⭐⭐⭐