IMPORTANT

add this line into your config file after line '
default-limit: 5'


# Maximum number of items a minion's internal inventory can hold
# When full, the minion will stop mining until items are collected
# Default : 15 Items
inventory-limit: 15



Update V3.4.5

config.yml — added inventory-limit: 15 (configurable, default 15 items)

• Skips the entire mining cycle if the internal inventory is full (no chest linked)

• Won't add a new drop to internal inventory if at/above the limit

• Chest overflow fallback also respects the limit

MinerMinion v3.4.4

✨ Changes & Improvements

• Fortune Rework — Fortune is now a single one-time upgrade, just like Auto-Smelting. Buy it once, then toggle it on/off from the minion GUI. No more fortune levels.
• Admin Minion Access — Players with the minerminion.admin permission can now open, modify, and rename any player's minion. Great for staff.
• Improved /minion reload — The reload command now fully reloads all config options, all messages, and automatically closes any open minion GUIs for online players so changes take effect immediately.

Bug Fixes

• Fixed stale config values persisting after reload
• Fixed GUI items not reflecting updated message keys after reload
• Cleaned up unused fortune level keys from save data

⚠️ Migration Notes

Config Changes

Removed:

• max-fortune-level
• shop.fortune-base-price
• shop.fortune-price-multiplier

Added:

• shop.fortune-upgrade-price — flat one-time cost for the fortune upgrade (default: 500000.0)

Permissions

Permission	Description	Default
minerminion.admin	Access admin commands and open any player's minion	OP

Maven Dependency Updated

Forgot for update for update 3.4.3

Thanks for patience!

⛏️ MinerMinion v3.4.3 - Hotfix

Bug Fix

Fixed GUI Interaction Issue

• Fixed buttons not working in all GUIs after gui.yml update
• GUI click detection now properly uses gui.yml titles
• All menus (Minion, Shop, Colors, Fortune, Range, Speed) now work correctly

If you downloaded v3.4.2 earlier today and buttons weren't working, please re-download!

Sorry for the inconvenience!

⛏️ MinerMinion v3.4.2 Update

**DISCLAIMER**

ONLY RESTARTING SERVER WILL UPDATE CUSTOM GUI SETTINGS!

RELOADING YOUR SERVER WILL CAUSE CORRUPT FILES

Full GUI Customization

New Features:

• gui.yml Configuration File - Fully customize every GUI in the plugin!
  
  • Change all GUI sizes and titles
    
  • Customize item materials and slots
    
  • Configure color options with RGB values
    
  • Modify filler materials
    
  • Adjust back button positions
    
• GriefPrevention Integration - Minions can no longer be placed in claims where you don't have build permission

Critical Fixes

• Mineable Blocks Whitelist Now Working - Minions now properly respect the whitelist in config.yml
  
  • Previously minions could mine ANY block
    
  • Now only blocks listed in config.yml can be mined
    

What's Customizable in gui.yml

Migration Guide

• Your existing config.yml remains unchanged
• gui.yml will be auto-generated on first run with defaults
• All existing minions and settings are preserved
• No database changes required

⚠️ Dependencies

• Required: Vault
• Optional: GriefPrevention (for claim protection)

Support

Found a bug or have a suggestion? Join the linked discord in Description

If you enjoy this plugin, please leave a review! This helps users, like yourself finding this plugin!⭐

⛏️ Major Update: Separate Upgrade Paths!

What's New?

The minion upgrade system has been completely overhauled! Instead of a single "level" that upgrades everything, minions now have three independent upgrade paths:

• Horizontal Range - How far forward the minion mines (default is 1-21 levels)
• Vertical Range - How tall the mining area is (blocks up) (default is 1-21 levels)
• Mining Speed - How fast the minion mines blocks (in ms)(default is 1-21 levels)

Key Features:

• Independent Upgrades - Upgrade each path separately based on your needs
• Level Selection - Purchased levels can be toggled on/off (downgrade temporarily to save on performance or focus mining)
• Fully Configurable - Each upgrade path is completely independent in config.yml
• Custom Scaling - Add or remove levels, change costs, modify ranges - everything is customizable
• Backward Compatible - Old minions will automatically convert to the new system

How It Works:

Each upgrade path has its own:

• Purchase button (left-click to upgrade)
• Selection GUI (right-click to choose active level)
• Independent costs and progression
• Separate max levels (configurable)

Configuration:

Why This Update?

This gives you complete control over how your minions develop. Want a fast minion with small range? Upgrade speed only. Want a massive mining area? Focus on horizontal and vertical. The choice is yours!

Bug Fixes:

• Fixed back button not working in level selection GUIs
• Fixed fortune upgrade not responding to clicks
• Fixed level selection not allowing activation of max unlocked levels

Enjoy the new upgrade system!

Update 3.3:

• Added null checks to prevent crash when minions are saved in worlds that no longer exist or aren't loaded yet
• Plugin will now skip loading minions from missing worlds instead of crashing
• Logs warnings for skipped minions

Update 3.4:

• Delayed minion loading by 2 seconds (40 ticks) after server start
• Gives all worlds time to fully load before spawning minion entities
• Prevents NullPointerException during startup

Server Restart/Reload Protection

- **Auto-restore system**: Minions automatically respawn at their exact locations after server restart/reload/stop
- **Zero data loss**: All minion data preserved (level, upgrades, custom names, armor colors)
- **Chest links preserved**: Linked chests remain connected through restarts
- **No player action needed**: Everything happens automatically in the background

Bug Fixes

- **Fixed chest storage bug**: Items now correctly go only to linked chests when available
- **Fixed overflow handling**: Only leftover items (when chest is full) go to minion inventory
- **Improved entity cleanup**: Armor stands properly removed before server shutdown

⚙️ Technical Improvements

- Safe shutdown system removes entities before server stop
- Minions restore 1 second after server startup
- Enhanced logging for tracking minion restoration
- Chest location persistence verified and tested

What This Means

- **Before**: Minions disappeared on restart, players had to replace them
- **After**: Minions automatically return to work after restart, zero downtime

Installation

1. Stop server
2. Replace old MinerMinion.jar with v3.2
3. Start server
4. Existing minions will auto-restore with all data intact

⚠️ Important Notes

- Chest links are now permanent until manually unlinked
- Server shutdown may take slightly longer (minion data saving)
- Check console for restoration logs on startup

Fixed;
- spawnMinionEntityOffline
- spawnMinionEntityOnline

Added null checks for:

serializeLocation() - returns null if location or world is null
deserializeLocation() - returns null if string is invalid or world doesn't exist
loadMinions() - skips minions with invalid locations
saveMinions() - skips minions with null locations

New Feature: Configurable Smelting Recipes

Added smelting-recipes section in config.yml

Server owners can now customize which items get smelted and their outputs

Default recipes:
RAW_IRON → IRON_INGOT,
RAW_GOLD → GOLD_INGOT,
RAW_COPPER → COPPER_INGOT,
COBBLESTONE → STONE

New CUSTOM recipes:
COBBLESTONE → EMERALD_BLOCK

Easy to add/remove/modify smelting conversions without code changes

Changed the mining task check interval from every 20 ticks (1 second) to every 1 tick (50ms), so minions can now mine as fast as their configured speed instead of being capped at 1 second intervals.

LOWEST (FASTEST) NUMBER FOR SPEED IS SET TO 50MS!

Version Updates - 2.6, 2.7 and 2.8

[-] Removed all ability system from levels configuration - Version 2.6
[-] Removed hasAbility() method calls throughout the codebase - Version 2.6
[-] Removed ability references from ConfigManager, MinionCommand, MessageManager, MinionGUI, and MiningTask - Version 2.7

[+] Added setTotalMined() method to Minion model - Version 2.8
[+] Added total mined persistence - now saves and loads correctly - Version 2.8
[+] Fixed total mined counter to track actual item amounts (including fortune bonuses) - Version 2.8
[+] Fixed items stored display to show total item count instead of stack count - Version 2.8

Fixed;

[+] Fortune levels now work as they would on a pickaxe, Customizable Maximum Fortune level
[+] Full Customization of Minion levels (Default is 21), Meaning you can add more levels or remove levels

[-] Multi-Language support has been disabled

[+] Animated minion arm swings