⛏️ ✦Miner Minion ✦ Upgrades ✦ Customise Skins ✦ Actions ✦ Animations ✦ Robots ✦⛏️ -----
Transform your mining experience with intelligent, upgradeable minions that work for you 24/7!━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
The Ultimate Automated Mining Solution for Your Server!
Transform your mining experience with intelligent, upgradeable minions that work for you 24/7!
✨ Fully Customizable | 21 Upgrade Levels | Auto-Smelting | ⚡ Fortune System
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ KEY FEATURES
INTELLIGENT MINING SYSTEM
- Smart Mining: Minions automatically detect and mine blocks directly in front of them
- Directional Placement: Minions face the direction you're looking when placed
- Ultra-Fast Mining: Mine at 5ms intervals (200 cycles per second) at all levels
- Multi-Block Mining: Higher levels mine multiple blocks simultaneously (up to 30 blocks at once!)
- Visual Effects: Breaking particles and sounds for realistic mining experience
21-LEVEL PROGRESSION SYSTEM
- Level 1: 1x1 mining area (1 block at once)
- Level 8: 3x3 mining area (9 blocks at once)
- Level 21: 5x6 mining area (30 blocks at once!)
- Horizontal Range: Progressively increases from 1 to 5 blocks forward
- Vertical Range: Grows from 1 to 6 blocks tall
- Upgradeable: Purchase upgrades with in-game currency
- Fully Configurable: Customize upgrade costs and mining stats per level
AUTO-SMELTING UPGRADE
- Separate Purchase: Buy once for $10,000 (configurable)
- Toggle On/Off: Enable or disable smelting anytime in the GUI
- Automatic Processing: Converts raw ores to ingots instantly
- Works On: Raw Iron → Iron Ingot, Raw Gold → Gold Ingot, Raw Copper → Copper Ingot, Cobblestone → Stone
- Persistent: Saved when minion is picked up
FORTUNE UPGRADE SYSTEM
- 10 Upgrade Levels: Fortune I through Fortune X (configurable max)
- Exponential Pricing: Level 1 costs $500,000, each level doubles in price (2x multiplier)
- Toggle On/Off: Enable or disable fortune anytime
- Affects Ores: Coal, Diamond, Emerald, Lapis Lazuli, Redstone
- Independent System: Not tied to minion level, upgrade as much as you can afford
- Visual Indicator: Shows current fortune level and status in GUI
FULL CUSTOMIZATION OPTIONS
- Custom Names: Rename with name tags (supports color codes & formatting)
- 21 Armor Colors: Red, Orange, Yellow, Lime, Green, Aqua, Blue, Purple, Pink, White, Black, Brown, and more!
- Color Picker GUI: Easy-to-use interface for changing armor appearance
- Player Head: Each minion displays the owner's minecraft head
- Persistent: Names and colors save when picked up
CHEST LINKING SYSTEM
- Auto-Storage: Link minions to any chest for automatic item deposit
- Overflow Protection: If chest is full, items go to minion's internal inventory
- Easy Setup: Click "Link Chest" in GUI, then right-click any chest
- Unlink Anytime: Remove chest connection whenever needed
- Visual Indicator: GUI shows if chest is linked or not
BUILT-IN SHOP SYSTEM
- Purchase Minions: Buy new minions with in-game currency via /minionshop
- Configurable Price: Set minion cost in config (default: $5,000)
- Placement Limits: Permission-based limits (1, 5, 10, 20, 50, 100)
- Easy Interface: Clean GUI showing price and current minion count
- Vault Integration: Works with any economy plugin
COMPLETE DATA PERSISTENCE
- Pick Up & Place: Remove minions and place them elsewhere without losing progress
- All Data Saved: Level, upgrades, name, color, and toggle states preserved
- Item Lore Display: Shows all upgrades on the minion item
- Server Restart Safe: All minions automatically reload on restart
- No Data Loss: Never lose your expensive upgrades!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
HOW TO USE
GETTING A MINION
Code (Text):
Method 1 - Shop:
1. Run /minionshop
2. Click the Miner Minion item
3. Confirm purchase (default: $5,000)
4. Receive minion item in inventory
Method 2 - Admin Command:
/minion give <player> [amount]
Code (Text):
1. Hold the Miner Minion item (player head)
2. Right-click on the ground where you want it
3. Minion faces the direction YOU'RE facing
4. Position in front of blocks you want mined
5. Watch it start working immediately!
Code (Text):
Right-Click Minion = Open Management GUI
Shift + Right-Click with Name Tag = Rename minion
Information Panel
- View owner, level, total blocks mined
- See current mining area (e.g., "5x6 = 30 blocks")
- Check mining speed
- View active abilities and status
- Check chest link status
⬆️ Upgrade Minion
- Shows current level stats vs next level stats
- Displays upgrade cost
- Compare mining area improvements
- See what changes with upgrade
- Click to purchase upgrade
Auto-Smelting Control
- Not Purchased: Shows purchase button ($10,000)
- Purchased + ON: Green blast furnace icon - click to disable
- Purchased + OFF: Red furnace icon - click to enable
- Instant toggle, no cooldown
Fortune Control
- Level 0: Shows purchase button for Fortune I ($500,000)
- Level 1-9: Left-click to upgrade | Right-click to toggle
- Level 10 (Max): Click to toggle on/off
- Shows exponential pricing for next level
- Visual indicator of current status
Armor Color Customization
- Opens color picker with 21 colors
- Click any color to apply instantly
- See RGB values for each color
- Changes visible immediately on minion
- Colors persist when picked up
Link Chest
- Not Linked: Click then right-click any chest
- Already Linked: Click to unlink
- Works with single chests and double chests
- Minion auto-deposits mined items
️ Collect Items
- Shows number of items in minion's inventory
- Click to transfer all items to your inventory
- Used when chest is full or not linked
Remove Minion
- Collects all items first
- Gives you the minion item
- ALL data saved: level, upgrades, name, color
- Can be placed again anywhere
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙️ CONFIGURATION
️ FULLY CUSTOMIZABLE CONFIG.YML
General Settings
Code (Text):
default-limit: 5 # Default minion limit per player
max-level: 21 # Maximum minion level
max-fortune-level: 10 # Maximum fortune upgrade level
Code (Text):
shop:
minion-price: 5000.0 # Cost to buy a minion
smelting-upgrade-price: 10000.0 # Cost for auto-smelting
fortune-base-price: 500000.0 # Cost for Fortune I
fortune-price-multiplier: 2.0 # Multiplier for each fortune level
Code (Text):
mineable-blocks:
- STONE
- COBBLESTONE
- COAL_ORE
- IRON_ORE
- DIAMOND_ORE
- DEEPSLATE_COAL_ORE
# ... Add any block type you want!
# Fully customizable - make minions mine ANYTHING
Code (Text):
levels:
1:
mining-speed: 5 # Milliseconds between mining cycles
mining-range: 1 # Blocks forward
vertical-range: 1 # Blocks tall
upgrade-cost: 1000 # Cost to upgrade to this level
21:
mining-speed: 5
mining-range: 5
vertical-range: 6
upgrade-cost: 0 # No cost (max level)
# Customize ALL 21 levels individually!
# Set different speeds, ranges, and costs
# Create your own progression system
Code (Text):
minerminion.limit.1 # Can place 1 minion
minerminion.limit.5 # Can place 5 minions (default)
minerminion.limit.10 # Can place 10 minions
minerminion.limit.20 # Can place 20 minions
minerminion.limit.50 # Can place 50 minions
minerminion.limit.100 # Can place 100 minions
COMMANDS & PERMISSIONS
PLAYER COMMANDS
Code (Text):
/minionshop Open the minion shop
/minion list List your minions
/minion list <player> List another player's minions
Code (Text):
/minion give <player> [amount] Give minion(s) to a player
/minion remove <player> Remove all of a player's minions
/minion reload Reload configuration
/minion debug Check mineable blocks configuration
Code (Text):
minerminion.use Use basic commands (default: true)
minerminion.shop Access the shop (default: true)
minerminion.admin Use admin commands (default: op)
minerminion.limit.1 Can place 1 minion
minerminion.limit.5 Can place 5 minions (default)
minerminion.limit.10 Can place 10 minions
minerminion.limit.20 Can place 20 minions
minerminion.limit.50 Can place 50 minions
minerminion.limit.100 Can place 100 minions
USE CASES & EXAMPLES
⛏️ Strip Mining
Place minions facing horizontal tunnels. They'll mine straight ahead, creating perfect mining corridors.
️ Mountain Excavation
Use high-level minions (5x6 range) to clear massive areas instantly. Perfect for terraforming projects.
Resource Farming
Link minions to chests in your base. They'll continuously mine and auto-deposit resources while you're offline.
VIP Perks
Give VIP players higher minion limits and pre-upgraded minions as rewards.
Server Economy
Set high prices for fortune upgrades to create a valuable end-game progression system.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
TECHNICAL DETAILS
⚡ PERFORMANCE
- Optimized Mining Task: Runs async every tick (20 times per second)
- Smart Block Detection: Only processes minions when mining cooldown is ready
- Efficient Storage: Minimal data storage, lightweight on server
- No Lag: Tested with 100+ active minions simultaneously
REQUIREMENTS
- Minecraft Version: 1.21+ (Paper/Spigot/Purpur)
- Java Version: Java 21+ (Temurin 25 recommended)
- Dependencies: Vault + Any economy plugin (EssentialsX, etc.)
DATA STORAGE
- File System: Uses YAML for data storage (minions.yml)
- Persistent Data: NBT data containers for item storage
- Auto-Save: Saves on minion changes and server shutdown
- Safe Reload: Supports /reload and server restarts
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
WHAT MAKES THIS UNIQUE?
- Separate Upgrade Systems: Unlike other plugins, smelting and fortune are independent purchases with toggle controls
- Full Cosmetic Control: 21 armor colors + custom naming with complete persistence
- Ultra-Fast Mining: 5ms mining speed means 6,000 blocks per second at max level
- Smart Inventory: Choose between chest storage or internal inventory
- True Portability: Pick up and move minions without losing ANY progress
- Directional Placement: Minions face where YOU face for precise positioning
- Exponential Fortune: Creates engaging end-game economy with million-dollar upgrades
- ️ Fully Configurable: Everything from mineable blocks to level progression is customizable
- Permission Scaling: Perfect for rank systems with different minion limits
- Visual Feedback: Comprehensive GUIs with before/after upgrade comparisons
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SCREENSHOTS
https://gyazo.com/98668f0908cf2167702e56ae4473795b
Minion Management GUI - Full control at your fingertips
https://gyazo.com/2a0e9d97fb40cc22baa8feee17129c0d
Color Selection Menu - 21 vibrant colors to choose from
https://gyazo.com/442753d824208b8ca495404b5975396a
Minion In Action - Mining with particles and effects
https://gyazo.com/172bd0f7ad6ad4c55c995796157b5eac
Shop Interface - Easy purchasing system
https://gyazo.com/3739956e93fec57094653ee32724c57f
Name Change - Using nametag to change name
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
https://gyazo.com/2a0e9d97fb40cc22baa8feee17129c0d
Color Selection Menu - 21 vibrant colors to choose from
https://gyazo.com/442753d824208b8ca495404b5975396a
Minion In Action - Mining with particles and effects
https://gyazo.com/172bd0f7ad6ad4c55c995796157b5eac
Shop Interface - Easy purchasing system
https://gyazo.com/3739956e93fec57094653ee32724c57f
Name Change - Using nametag to change name
❓ FREQUENTLY ASKED QUESTIONS
Q: Do minions work when I'm offline?
A: Yes! Minions continue mining as long as the server is running and the chunk is loaded.
Q: Can I move a minion to a different location?
A: Absolutely! Just pick it up (remove button in GUI) and place it anywhere. All progress is saved.
Q: What happens if the chest gets full?
A: Items overflow into the minion's internal inventory. Collect them using the "Collect Items" button.
Q: Can I have different colored minions?
A: Yes! Each minion can have its own unique armor color chosen from 21 options.
Q: Do upgrades transfer when I pick up a minion?
A: Yes! Level, smelting, fortune, name, and color are ALL saved to the item.
Q: Can minions mine in the Nether or End?
A: Yes! Add Netherrack, Ancient Debris, End Stone, etc. to the mineable-blocks list in config.
Q: How do I limit minions for different ranks?
A: Use permission nodes: minerminion.limit.5 for regulars, minerminion.limit.20 for VIPs, etc.
Q: Can I customize what blocks minions can mine?
A: Absolutely! Edit the mineable-blocks list in config.yml to add or remove any block type.
Q: What happens during server restart?
A: All minions automatically reload with all data intact. They resume mining immediately.
Q: Can I change fortune level after purchasing?
A: Yes! You can upgrade from Fortune I to Fortune X (configurable max). Each level costs exponentially more.
A: Yes! Minions continue mining as long as the server is running and the chunk is loaded.
Q: Can I move a minion to a different location?
A: Absolutely! Just pick it up (remove button in GUI) and place it anywhere. All progress is saved.
Q: What happens if the chest gets full?
A: Items overflow into the minion's internal inventory. Collect them using the "Collect Items" button.
Q: Can I have different colored minions?
A: Yes! Each minion can have its own unique armor color chosen from 21 options.
Q: Do upgrades transfer when I pick up a minion?
A: Yes! Level, smelting, fortune, name, and color are ALL saved to the item.
Q: Can minions mine in the Nether or End?
A: Yes! Add Netherrack, Ancient Debris, End Stone, etc. to the mineable-blocks list in config.
Q: How do I limit minions for different ranks?
A: Use permission nodes: minerminion.limit.5 for regulars, minerminion.limit.20 for VIPs, etc.
Q: Can I customize what blocks minions can mine?
A: Absolutely! Edit the mineable-blocks list in config.yml to add or remove any block type.
Q: What happens during server restart?
A: All minions automatically reload with all data intact. They resume mining immediately.
Q: Can I change fortune level after purchasing?
A: Yes! You can upgrade from Fortune I to Fortune X (configurable max). Each level costs exponentially more.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SUPPORT & UPDATES
Need Help?
- Join our Discord: https://discord.com/invite/PX5sscHGZr
Updates Included
- Lifetime updates for all buyers
- Bug fixes and improvements
- New features based on community feedback
- Version compatibility updates
⭐ Leave a Review
If you enjoy this plugin, please leave a 5-star review! Your feedback helps improve the plugin and supports future development.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ TRANSFORM YOUR SERVER TODAY! ✨
Give your players the power of automation with Miner Minion!
Lifetime Updates | ️ Professional Support
No refunds
Give your players the power of automation with Miner Minion!
Lifetime Updates | ️ Professional Support
No refunds
Resource Information
Author:
----------
Total Downloads:
4
First Release:
Oct 23, 2025
Last Update:
Nov 11, 2025
Category:
---------------
All-Time Rating:
1 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings