[ALIGN=center]
============================================================ SUPER PICKAXE EVOLUTION DOCUMENTATION (v1.9) ============================================================ [/ALIGN]
1. COMMANDS & PERMISSIONS -----------------------------------------------------------
•
Command:/sp give <player> <id> ->
Description: Grants a specific custom evolutionary pickaxe directly to an online player.
->
Permission:superpickaxe.admin.give •
Command:/sp reload ->
Description: Instantly reloads config.yml, language.yml, and active database hooks without restarting the server.
->
Permission:superpickaxe.admin.reload
2. AUTOMATED LEVEL & TIER SYSTEM (PRESTIGE) [NEW v1.9] -----------------------------------------------------------
SuperPickaxe v1.9 introduces a real-time, hands-free tool progression engine driven directly by player mining activity:
•
Leveling Up: Every block broken increments the pickaxe's internal progress counter. Upon reaching the configured
blocks-per-level milestone, the tool levels up.
•
Automatic Prestige (Tier Up): When a pickaxe reaches its peak level limit specified by
max-level-per-tier (e.g., Level 10):
-> The next successful level-up trigger will
automatically ascend the pickaxe to the next
Tier.
-> The pickaxe
Level is instantly reset back to 1, allowing players to start the next ceding loop seamlessly mid-mining.
3. PLACEHOLDERAPI INTEGRATION [NEW v1.9] -----------------------------------------------------------
The plugin now natively exposes live tool statistics via
PlaceholderAPI (v2.12.2+). You can implement these placeholders globally across your server infrastructure (Scoreboards, Chat formats, Tablists, or DeluxeMenus):
•
%superpickaxe_level% — Fetches and displays the current level of the pickaxe currently held in the player's main hand.
•
%superpickaxe_tier% — Fetches and displays the active prestige tier/quality of the held pickaxe.
4. MULTI-LANGUAGE LOCALIZATION -----------------------------------------------------------
The plugin automatically generates a comprehensive "language.yml" file inside its data folder upon the first boot. Every single message can be fully customized, including:
• System message prefixes and administrative alerts.
• No-permission and player-offline warnings.
• Custom durability tracker energy lore formats.
•
Progression Notifications [UPDATED v1.9]: Fully customizable ActionBars and Chat alerts for both
Level Up milestones and automatic
Tier Up (Prestige) events.
5. ADVANCED MINING ALGORITHMS -----------------------------------------------------------
SuperPickaxe features two state-of-the-art multi-block mining behaviors:
•
Radius-Based Mode: Mines blocks in a classic cubical area centered around the broken block using standard Radius X/Y/Z parameters.
•
Smart Cuboid Mode: Dynamically detects the exact
BlockFace the player is looking at to accurately calculate Width, Height, and Length, providing an immersive spatial mining mechanic.
6. INSTALLATION GUIDE -----------------------------------------------------------
•
Step 1: Download the latest
SuperPickaxe-1.9.jar file.
•
Step 2:(Highly Recommended) Download and install
PlaceholderAPI (Version 2.12.2 or higher) into your plugins folder.
•
Step 3: Drop the
SuperPickaxe.jar file directly into your server's
"plugins" directory.
•
Step 4: Restart or boot up your Minecraft Server to generate all default files.
•
Step 5: Navigate to
plugins/SuperPickaxe to tweak your configurations, then type
/sp reload ingame to apply changes instantly.