MinerMinion v3.4.3

MinerMinion v3.4.3 Update

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

Code:

minion-gui:
  size: 45
  title: '&8Miner Minion'
  info:
    slot: 4
    material: BOOK
  horizontal-range:
    slot: 10
    material: COMPASS
  # ... and much more!

color-gui:
  colors:
    red:
      slot: 10
      rgb: '255,0,0'
    # Add/modify any colors you want!

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? Let me know in the discussion thread!



If you enjoy this plugin, please leave a review!

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 (1-21 levels)
• Vertical Range - How tall the mining area is (1-21 levels)
• Mining Speed - How fast the minion mines blocks (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:

Code:

upgrade-paths:
  horizontal-range:
    1:
      range: 1
      cost: 0
    2:
      range: 2
      cost: 7500
    # Add as many levels as you want!
    
  vertical-range:
    1:
      range: 1
      cost: 0
    # Completely independent from horizontal
    
  speed:
    1:
      speed: 3000
      cost: 0
    2:
      speed: 2900
      cost: 7500
    # Lower speed = faster mining

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!

[+] Minion swing animation
[+] Messages.yml - To edit ALL aspects of this plugin

[-] Removed Multi-Language support - Causing custom messages to not work - FIXING

MINER MINION - MAJOR UPDATE v2.0
NEW FEATURES & IMPROVEMENTS
A massive update bringing international support and enhanced functionality!​

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

MULTI-LANGUAGE SUPPORT
14 Languages Now Supported!
The plugin now speaks YOUR language!

Included Languages:
English (US) - Complete
Spanish (Español) - Complete
French (Français) - Complete
Chinese Simplified (简体中文) - Complete
Japanese (日本語) - Complete
Korean (한국어) - Available
Dutch (Nederlands) - Complete
German (Deutsch) - Available
Swedish (Svenska) - Available
Polish (Polski) - Complete
Czech (Čeština) - Complete
Finnish (Suomi) - Available
Greek (Ελληνικά) - Available
Russian (Русский) - Available

Key Features:
Per-Player Language Selection - Each player can use their preferred language
170+ Translation Keys - Every message, GUI, and item fully translatable
Automatic Fallback - Missing translations default to English
Easy Customization - Simple YAML files for editing any language
Color Code Support - Full Minecraft color formatting in all languages
Hot-Reload Support - Update translations without restarting server

Configuration:

Code:

 # config.yml
default-language: en_US
# Players can use their preferred language automatically
# All GUI text, messages, and items adapt to player's language
# Create custom languages by copying and editing language files

What's Translated:
All chat messages and notifications
Complete GUI interfaces (titles, buttons, descriptions)
Item names and lore
Shop interface
Admin commands output
Error messages
Success confirmations
All color names
Debug information​

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

SMART PLACEMENT SYSTEM


Minion Spacing Protection
New intelligent placement system prevents minions from being placed too close together!

Features:
Minimum 2-Block Distance - Minions must be placed at least 2 blocks apart
Prevents Overlap - No more accidentally placing minions on top of each other
Performance Optimization - Reduces lag from overlapping mining operations
Strategic Placement - Forces players to think about minion positioning
Clear Error Messages - Players know exactly why placement failed
World-Aware - Only checks minions in the same world

How It Works:

Code:

Player places minion → System checks all existing minions
    ↓ Is any minion within 2 blocks? ├─ YES → Placement blocked with message
              └─ NO  → Minion placed successfully

Player Feedback:

Code:

❌ Cannot place minion here!
❌ Another minion is too close (minimum 2 blocks apart)

Benefits:
Prevents Block Conflicts - Minions won't compete for the same blocks
Better Performance - Less overlap = less server strain
Cleaner Builds - More organized minion farms
Easier Management - Players can clearly see which minion is which
Professional Feel - Polished restriction system​

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

PRECISE MINION TRACKING
Fixed Multi-Minion GUI Bug
Major improvement to how the plugin tracks which minion you're interacting with!

The Problem (Before):
Having 2+ minions nearby would confuse the system
Clicking any minion would open the FIRST minion's GUI
Upgrading one minion would upgrade the wrong one
Changing colors affected the wrong minion
Frustrating for players with multiple minions

The Solution (Now):
Each player's clicked minion is precisely tracked
Opening a GUI stores that specific minion's ID
All actions affect the correct minion
Works perfectly with unlimited minions nearby
Seamless multi-minion management

Technical Implementation:

Code:

Player → Clicks Minion A → Stores Minion A's UUID
   ↓  
Opens GUI for Minion A  
↓
Upgrade/Color/Fortune → Affects Minion A specifically
  

Player → Clicks Minion B → Stores Minion B's UUID   
↓   
Opens GUI for Minion B    
↓  
All actions → Affect Minion B correctly

What's Fixed:
Level upgrades affect the correct minion
Auto-smelting toggles work on the right minion
Fortune upgrades go to the clicked minion
Armor colors change the selected minion
Chest linking connects to the right minion
Item collection pulls from the correct minion
Minion removal picks up the right one​

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

TECHNICAL IMPROVEMENTS

Under-The-Hood Enhancements

Language System Architecture:
Modular Design - Clean LanguageManager class
Automatic File Generation - Creates missing language files
Smart Fallback System - Never shows broken translations
Per-Player Tracking - Remembers each player's language choice
Persistent Storage - Language preferences saved across restarts
Zero Performance Impact - Efficient caching and lookup

Minion Tracking System:
UUID-Based Identification - Bulletproof minion tracking
Session Management - Tracks open GUIs per player
Memory Efficient - Minimal overhead for tracking
Crash-Safe - Handles edge cases gracefully
Multi-Threading Ready - No race conditions

Placement Validation:
Distance Calculation - Accurate 3D distance checking
World Filtering - Only checks same-world minions
Performance Optimized - Fast On proximity search
Clean Error Handling - Informative failure messages​

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

CHANGELOG SUMMARY

Version 2.0 - Major Update

NEW FEATURES
+ Multi-language support system (14 languages)
+ Per-player language preferences
+ 170+ translation keys covering entire plugin
+ Automatic language file generation
+ Smart placement restriction (2-block minimum distance)
+ Distance validation system
+ Clear placement error messages

IMPROVEMENTS
! Fixed multi-minion GUI tracking bug
! UUID-based minion session management
! Precise minion identification system
! All GUI actions now affect correct minion
! Enhanced player feedback for placement
! Optimized proximity checking

BUG FIXES
✓ Fixed clicking wrong minion opening wrong GUI
✓ Fixed upgrading affecting incorrect minion
✓ Fixed color changes applying to wrong minion
✓ Fixed fortune toggles affecting wrong minion
✓ Fixed players placing minions too close together​

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

FOR SERVER OWNERS


Why This Update Matters

International Appeal:
Attract players from 14 different regions
Players feel at home with their native language
Professional appearance for international communities
Competitive advantage over English-only plugins

Player Experience:
No more confusion with multi-minion setups
Intuitive placement restrictions
Reliable GUI interactions
Polished, bug-free experience

Server Performance:
Reduced overlap lag from spacing requirements
Optimized tracking system
Minimal memory footprint
No performance degradation
​

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

MIGRATION GUIDE

Updating to v2.0

Step 1: Backup

Code:

 [/B][/B][/CENTER]
[B][B][CENTER]1. Stop your server 
2. Backup plugins/MinerMinion/ folder 
3. Backup your database (if applicable)

​

Step 2: Update

Code:

 [/B][/B][/CENTER]
[B][B][CENTER]1. Replace MinerMinion.jar with new version 
2. Start server 
3. New language files auto-generate 
4. All existing minions remain functional

​

Step 3: Configure (Optional)

Code:

 [/B][/B][/CENTER]
[B][B][CENTER]1. Set default-language in config.yml 
2. Customize language files if desired 
3. Reload plugin: /minion reload

​

Compatibility:
All existing minions remain functional
No data loss
Backwards compatible
Existing configurations preserved
No permission changes needed
​

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

THANK YOU FOR YOUR SUPPORT!



This massive update brings MinerMinion to the next level!



Questions? Issues? Suggestions?

Join our Discord or send me a PM!



Don't forget to leave a review if you enjoy the update! ​