SmartPets v1.9.4 - Translation System

Complete Fix

Issues Resolved - User Reported Hardcoded Text

✅ Fixed Hardcoded Texts Found in User Screenshots
✅ Additional Hardcoded Text Found and Fixed

New Translation Keys Added (23 Total)

Impact on Users

✅ For Server Owners

• Complete Translation Control: Every user-facing message can now be translated
• Contextual Interaction System: Rich, dynamic pet responses fully localizable
• Professional Localization: No more mixed-language experiences
• Easy Customization: Simple key-value translation system

✅ For Players

• Immersive Experience: All text appears in chosen language
• Better Contextual Feedback: Pet responses feel more natural and personalized
• Consistent UI: No English text appearing unexpectedly in translated servers

✅ For Translators

• 23 New Keys: Fresh content ready for localization
• Contextual Variety: Multiple response variants for richer translations
• Clear Documentation: Well-commented translation keys for easy understanding

Translation System Statistics

• Total Translation Keys: 923 (was 900)
• Coverage: 100% of user-facing text
• Languages Supported: Any (server owner configurable)
• Hardcoded Strings: 0 (complete elimination)

Installation

1. Replace: SmartPets JAR file with hotfix version
2. Reload: /petadmin reload (no restart required)
3. Verify: All previously hardcoded text now respects lang.yml settings

Quality Assurance
Testing Completed

• ✅ All reported user screenshots verified and fixed
• ✅ Comprehensive codebase search for additional hardcoded text
• ✅ Translation system integration verified
• ✅ Backward compatibility maintained
• ✅ No breaking changes to existing configurations

Note: This hotfix addresses 100% of reported hardcoded text issues while maintaining full backward compatibility with existing configurations. All servers can now provide completely localized SmartPets experiences.

For Immediate Support: If you find any additional untranslatable text, please report with screenshots for rapid resolution.

SmartPets v1.9.3 - Translation System Fixes

What's Fixed

Translation System Overhaul

• Fixed Critical Bug: All menu translations now work properly (hunger status, skill buttons, etc.)
• Resolved Hardcoded Text: Removed untranslatable text that appeared in English regardless of language settings
• Complete Localization: Every user-facing message can now be translated to any language

User-Reported Issues Resolved

• ✅ "Full" hunger status now uses proper translations
• ✅ "View Skills" button now translates correctly
• ✅ All GUI elements are now fully translatable

What's New
Enhanced Translation Coverage

• Pet Statistics: /pet info command is now fully translatable with emoji support
• Conversation System: All conversation menus and responses can be localized
• Error Messages: System errors and warnings now support translations
• Pet Death Notifications: Death messages are now customizable per language

Added 16 New Translation Keys

• Pet statistics display (hunger, energy, affection, etc.)
• Conversation menu elements
• System error messages
• Pet lifecycle notifications

Technical Improvements

Consistent Translation Methods

• Unified translation system across all GUI components
• Improved fallback handling when translations are missing
• Better error detection for translation loading

Menu System Enhancements

• All popup menus now respect language settings
• Button tooltips and descriptions are fully translatable
• Status indicators work in any language

For Server Owners

Translation Support

• Complete Customization: Every text element can now be modified in lang.yml
• Multi-Language Ready: Easy to create language packs for different communities
• Emoji Support: Enhanced visual elements in stat displays and menus

Backward Compatibility

• All existing configurations remain functional
• No server restart required (plugin reload sufficient)
• Existing translations automatically work with new features

Installation: Simply replace your current SmartPets jar file and reload the plugin. All translation improvements will be active immediately.

For Translators: Check lang.yml for 16 new translation keys ready for localization!

SmartPets v1.9.2 - Changelog

Bug Fix & Translation Improvements Release

✅ Fixed: Critical Luminol Server Crash

Problem Solved:

• SmartPets v1.9.1 crashed when selecting pets from menus on Luminol servers
• Error: "Could not pass event InventoryClickEvent" with UnsupportedOperationException
• Threading errors when pets tried to use AI behaviors on Luminol

What Changed:

• Enhanced Luminol compatibility with intelligent scheduler detection
• Pet selection and spawning now work perfectly on Luminol servers
• All manual interactions (commands, menus, conversations) preserved on Luminol
• Automatic AI behaviors gracefully disabled on Luminol (as expected)
• Zero impact on Paper, Spigot, Purpur, and Folia servers

Impact:

• Luminol users can now adopt and interact with pets without crashes
• Pet commands, GUIs, and conversation system work normally on Luminol
• Paper/Spigot/Purpur/Folia users experience no changes whatsoever
• Improved server compatibility across all platforms

✅ Enhanced: Complete Translation System

Problem Solved:

• Several messages were hardcoded in English and couldn't be translated
• User reports of untranslatable error messages and emotion displays
• Inconsistent language support across different plugin components

What Changed:

• Added 150+ new translation keys for previously hardcoded messages
• Complete translation of all command system messages
• Pet stats names ("Hunger", "Energy", etc.) now use translation keys
• Pet attack bug fix message now translatable
• Comprehensive help system now fully translatable (all 8 help topics)
• Pet emotional states now use translation system
• All error messages in GUIs now fully translatable
• Pet emotion displays (holograms) now use lang.yml
• Shop error messages now translatable
• Admin menu errors now translatable

New Translatable Elements:

• Command System: All /pet command messages, errors, and responses
• Help System: Complete translation for basics, stats, leveling, evolution, skills, behavior, interaction, conversation help
• Pet Info: All pet information display messages (/pet info, /pet stats)
• Emotional States: "Terrified ", "Very Angry ", "Starving ", "Content ", etc.
• Care Recommendations: "Feed your pet - they're getting hungry", comfort messages, etc.
• Stat Names: stat.hunger.name, stat.energy.name, stat.affection.name, etc.
• Error Messages: Plugin loading errors, command processing errors, menu failures
• Debug System: Critical bug fix messages for pet behavior issues
• All GUI error states and navigation messages now respect user's language settings

Impact:

• 100% translatable plugin - no more English-only messages
• Server owners can now fully localize ALL user-facing text
• Consistent language experience across all plugin features
• Better support for international communities

Installation:

1. Stop your server
2. Replace SmartPets-1.9.1.jar with SmartPets-1.9.2.jar
3. Start your server
4. Enjoy stable pet management on all server types!

This is a compatibility fix - no configuration changes needed.

SmartPets v1.9.1 - Changelog

Bug Fix Release

✅ Fixed: Luminol Server Compatibility

Problem Solved:

• SmartPets now works properly on Luminol servers (v1.21.7+)
• Fixed crash when selecting pets from the menu on Luminol
• Error message: "Thread failed main thread check" no longer occurs

What Changed:

• Luminol servers skip the aggressive entity cleanup due to their special threading system
• Pet spawning and all core features work normally on Luminol
• All other server types (Paper, Spigot, Purpur, Folia) are unaffected

Impact:

• Luminol users can now use SmartPets without crashes
• Pet selection, spawning, and management work as expected
• Zero impact on other server platforms

Installation:

1. Stop your server
2. Replace SmartPets-1.9.jar with SmartPets-1.9.1.jar
3. Start your server
4. Enjoy stable pet management on all server types!

This is a minor compatibility fix - no configuration changes needed.

SmartPets v1.9 - Enhanced Communication & Interaction

Release Date: Available Now
Compatibility: Minecraft 1.16.5 - 1.21.8
Server Support: Paper, Spigot, Purpur, Folia/Luminol

What's New in v1.9
SmartPets v1.9 revolutionizes how you connect with your virtual companions! This major update focuses on deepening your relationship with existing pets through enhanced communication, smarter interactions, and expressive emotional displays. Your pets are now more alive and responsive than ever before!

Richer Emotional Expression
Your Pets Now Show Emotions Like Never Before!

• 5 Levels of Intensity: Watch emotions evolve from mild to extreme
  
  • Happy: → + → → (from content to ecstatic!)
  • Scared: → → (from nervous to terrified)
  • Hungry: → ! → (from peckish to starving)
• Multiple Emotions at Once: Your pets can feel complex emotions
  
  • " Scared but needs food..."
  • " Happy but sleepy..."
  • "️ Angry guardian mode!"
• Smart Context: Same emotion, different reasons
  
  • Morning hunger: "☀️ Ready for breakfast!"
  • After playing: " Worked up an appetite!"

Pets Move and Act More Realistically

• Physical Expression: Watch your pets show emotions through movement
  
  • Happy pets jump and wag their tails
  • Scared pets crouch and seek hiding spots
  • Tired pets move slowly and rest more often
  • Playful pets bounce around energetically
• Species Personality: Each pet type has unique behaviors
  
  • Wolves: Howl when happy, whine when scared
  • Cats: Purr when content, hiss when afraid
  • Parrots: Sing when joyful, screech when upset

Smarter Interactions
Your Pets Understand Context
Right-clicking your pet now triggers intelligent interactions based on what they need:

• Scared pets get comfort and reassurance
• Sad pets receive encouragement and love
• Angry pets get space and calming interactions
• Tired pets are guided to rest
• Playful pets engage in fun activities
• Hungry pets are offered food when you're holding it

Perfect Timing Matters

• Morning greetings when you first see your pet
• Bedtime routines during night hours
• Emergency comfort for extremely scared pets
• Celebration when your pet levels up or evolves
• Meal sharing when both you and your pet are hungry

Your Actions Have Real Impact

• Comfort a scared pet and watch their fear melt away
• Play with an energetic pet and see their happiness soar
• Give space to an angry pet and watch them calm down
• The right interaction at the right time makes all the difference!

Talk to Your Pets!
Brand New Conversation System
Type /pet talk to open a conversation menu with your active pet!

What You'll See:

• Up to 6 conversation options that change based on your pet's mood
• Your pet's current emotional state displayed with visual bars
• Options that make sense for the situation

Example Conversations:

• Hungry pet: "Are you hungry?" → Your pet appreciates the food offer
• Scared pet: "You're safe with me" → Your pet feels comforted and less afraid
• Happy pet: "You're amazing!" → Your pet's happiness and affection increase
• Energetic pet: "Want to play?" → Triggers a fun play session
• Tired pet: "Get some rest" → Helps your pet relax and recover energy

Your Pet Talks Back!
Each pet species responds differently:

• Wolves: wags tail happily, whines softly, pants contentedly
• Cats: purrs contentedly, rubs against your legs, blinks slowly
• Parrots: sings melodiously, flaps wings excitedly, tilts head curiously

Every Word Matters

• Your conversation choices actually affect your pet's emotions
• Build stronger relationships through meaningful dialogue
• Learn what your pet needs by listening to their responses
• Experience a deeper bond than ever before!

️ New Commands & Quality of Life
Helpful New Commands

• /pet talk - Start a conversation with your active pet
• /pet stats - See detailed statistics for your active pet
• /pet stats <ID> - View stats for a specific pet
• /pet basics - Quick guide to pet care fundamentals
• /pet interaction - Learn about the new interaction system

Smart Command Improvements

• Tab completion for all commands - just press Tab to see options!
• Auto pet selection - many commands now work with your active pet automatically
• Better help system - clearer explanations and examples
• Multilingual support - full translation system for different languages

⚙️ Installation & Compatibility
Works on Your Server

• Full Compatibility: Paper, Spigot, Purpur, Folia servers
• Minecraft Versions: 1.16.5 through 1.21.8
• Performance Optimized: No lag or server slowdown
• Automatic Fallbacks: Works even if some features aren't supported on your version

Easy Customization

• Configurable: Adjust conversation cooldowns, animation speeds, and more
• Translatable: Change all text to your preferred language
• Toggle Features: Enable/disable any v1.9 feature you don't want
• Backwards Compatible: All your existing pets work with new features immediately

Getting Started with v1.9
For New Players

1. Get your first pet: Use /pet shop to adopt a companion
2. Learn the basics: Try /pet basics for a quick guide
3. Start talking: Use /pet talk to have your first conversation!
4. Check emotions: Use /pet stats to see how your pet is feeling
5. Experiment: Right-click your pet to try the new smart interactions

For Existing Players

1. All your pets are upgraded automatically with new features
2. Try /pet talk with your favorite pet to experience conversations
3. Use /pet stats to see the new detailed emotion system
4. Explore new interactions by right-clicking your pets in different situations
5. Check /pet help to learn about all the new commands

❓ Frequently Asked Questions
Q: Do I need to reset my pets or config?
A: No! Everything upgrades automatically. Your pets keep all their progress.

Q: Will this slow down my server?
A: No, v1.9 is optimized for performance with minimal resource usage.

Q: Can I turn off features I don't want?
A: Yes! Every v1.9 feature can be disabled in the config if desired.

Q: My pet seems scared - what do I do?
A: Use /pet talk and choose comforting options, or just right-click them for automatic comfort!

Q: How often can I talk to my pets?
A: There's a 30-second cooldown between conversations to keep things balanced.

What's Next?
SmartPets v1.9 is just the beginning! We're already working on v2.0 which will bring:

• Pet Memory System: Your pets will remember interactions and develop preferences
• Social Features: Pets can interact with each other
• Advanced AI: Even smarter behavioral patterns
• More Species: New pet types with unique abilities

Thank you for being part of the SmartPets community!

This update represents months of development focused on creating the most emotionally intelligent and interactive pet system possible. We hope you and your virtual companions enjoy these new ways to connect and build relationships.

Happy pet parenting! ❤️

SmartPets v1.8 - Enhanced Utility & Content Expansion

Major Features

Massive Pet Content Expansion

• 30+ Pet Presets (was 8) - 275% more variety!
• 6 Entity Types: Wolf, Cat, Parrot, Llama, Horse, Allay
• New Tiers: Specialized, Elemental, Royal Bloodline, Mythical
• Price Range: 1,200−25,000 for all budgets

✨ 7 New Utility Skills

• Pet Locator: Find your lost pet with distance & direction
• Item Retrieval: Pet collects dropped items for you
• Emergency Recall: Instantly teleport pet to safety
• Treasure Sense: Pet detects valuable ores nearby
• ⚔️ Battle Formation: Temporary combat enhancement
• Pack Leadership: Speed boost aura for transport animals
• ✨ Mystic Bond: Share health & effects with mythical pets

️ New Pet Categories
Specialized Pets ($3,200-4,500)
Role-specific pets for different playstyles:

• Guardian Wolf: Combat + Protection specialist
• Scout Cat: Navigation + Speed expert
• Messenger Parrot: Communication + Healing support

Elemental Pets ($7,800-9,200)
Magical themed pets with multiple skills:

• Fire Wolf: Attack + Regeneration + Shield
• ❄ Frost Cat: Light + Shield + Speed
• ⚡ Storm Parrot: Attack + Light + Speed + Heal

Royal Bloodline ($12,000-15,000)
Elite genetics with maximum skills:

• Royal Wolf: 4-skill combat master
• Noble Cat: 4-skill support specialist
• Imperial Parrot: 5-skill versatile companion

Mythical Tier ($18,000-22,000)
Legendary status showcase pets:

• ✨ Celestial Wolf: 6 skills + treasure detection
• Void Cat: 5 skills + dimensional powers
• Phoenix Parrot: 5 skills + rebirth theme

Experimental Pets ($4,800-7,200)
New entity types with unique abilities:

• ️ Mountain Llama: Pack leadership + transport
• Trader Llama: Commerce + long distance travel
• War Horse: Mounted combat + cavalry tactics
• Racing Horse: High-speed movement + endurance
• ✨ Helper Allay: Item collection + assistance
• Collector Allay: Advanced collection + automation

Quality of Life Improvements
Automatic Update System

• Seamless Migrations: Automatic content updates without losing data
• Manual Migration: /petadmin migrate v18 command for edge cases
• Recommended: Delete plugins/SmartPets/ folder for clean install

Enhanced User Experience

• Real Utility: Skills solve actual gameplay problems
• Balanced Progression: Clear path from beginner to mythical pets
• Rich Descriptions: Detailed pet information with role guidance
• Visual Indicators: Emojis and formatting for easy navigation

️ Technical Improvements
Cross-Platform Compatibility

• Minecraft Versions: 1.16.5 - 1.21.8
• Server Types: Paper, Spigot, Purpur, Folia
• Client Support: Java & Bedrock Edition compatible

Performance Optimizations

• Thread Safety: Enhanced concurrent operations
• Memory Efficiency: Optimized data structures
• Error Handling: Improved exception management
• Configuration: More configurable parameters

By The Numbers

Feature v1.7 v1.8 Improvement
Pet Presets 8 30+ +275%
Skills Available 6 13 +117%
Entity Types 3 6 +100%
Price Tiers 4 8 +100%
Utility Commands Basic Advanced Enhanced

Perfect For

• Casual Players: Affordable beginner pets with real utility
• Advanced Players: Complex skill combinations and automation
• Server Owners: Massive content expansion keeps players engaged
• Economy Servers: Wide price range creates natural progression
• Adventure Servers: Utility skills enhance exploration experience

Migration Notes
New Users

• Install normally - all features available immediately

Existing Users

• Option 1: Delete plugins/SmartPets/ folder (recommended)
• Option 2: Use /petadmin migrate v18 after update
• Option 3: Wait for automatic migration on next restart

Data Safety

• Pet data and player progress preserved
• Configuration settings maintained
• Economy integration unaffected

SmartPets v1.8 transforms your pet system from basic companions to essential gameplay tools. With 275% more content and real utility skills, your pets become valuable partners in every aspect of your Minecraft experience.

Compatible with Minecraft 1.16.5 - 1.21.8 | Java & Bedrock Edition

SmartPets v1.7 - Changelog

Critical Bug Fixes & Major Enhancements

Parrot-Specific Issues Resolved

✅ Robust Pet Persistence System
Problem: Pets disappearing when players move out of render distance
Impact: ✅ Pets no longer disappear when owner moves away

✅ Variant Persistence System
Problem: Parrots (and other pets) randomly changing colors/appearances
Impact: ✅ Pet appearances remain consistent across server restarts

✅ Type-Specific Sound System
Problem: All pets making wolf sounds regardless of their actual type
Impact: ✅ Each pet type now produces appropriate sounds for all behaviors

✅ Enhanced SafeTeleport System
Problem: Pets dying from teleportation into solid blocks
Impact: ✅ Eliminates fatal teleportation deaths, ensures pet safety

✅ Parrot-Specific Behaviors
Problem: Parrot boredom due to lack of species-specific engaging activities
New Features:
PetPerchTask - Intelligent Perching Behavior
PetMimicTask - Sound Learning & Mimicry
Impact: ✅ Parrots now have engaging, species-specific activities that address boredom

Technical Improvements
Version Compatibility Fixes

• Fixed: Updated sound constants for Minecraft 1.16.5+ compatibility
• Fixed: Updated material constants for cross-version compatibility

Performance & Compatibility
Folia/Paper Compatibility

• All new features use SchedulerCompat for maximum server compatibility
• Enhanced safeTeleport with proper scheduler integration
• Thread-safe implementations across all new components

Database Enhancements

• Automatic schema migration for variant column
• Backward compatibility maintained
• Support for YAML/SQLite/MySQL storage types

Memory Optimization

• Sound caching system to prevent repeated config lookups
• Efficient entity scanning algorithms
• Proper task cleanup and resource management

Additional Bug Fixes (v1.7.1)
Critical Issue: Chat Spam "High Alert" Messages
Problem: Pets spamming chat with "Alpha Pack Leader is now on high alert!" every 7 seconds near mob spawners.

• Added ConcurrentHashMap for thread-safe cooldown tracking
• Prevents message spam while maintaining alert functionality
• Maintains full Folia/Paper compatibility

Critical Issue: Broken Admin Pet Deletion GUI
Problem: Confirmation GUI showing "Missing translation: menu.admin.delete_confirm.title" and not responding to clicks.

User Experience Improvements
For Parrot Owners:

• ✅ No more disappearing pets - Robust persistence system
• ✅ Consistent pet appearance - Colors/variants stay the same
• ✅ Appropriate sounds - Parrots chirp and squawk instead of barking
• ✅ Zero teleportation deaths - Enhanced safety system
• ✅ Engaging behaviors - Perching, sound learning, mimicry activities
• ✅ Experience rewards - Pets gain XP from species-specific activities

For All Pet Types:

• ✅ Improved teleportation safety across all behaviors
• ✅ Type-specific sounds for more immersive experience
• ✅ Enhanced stability with better thread safety
• ✅ Configuration flexibility for server customization

⚙️ Migration Notes

Professional Configuration Migration System (NEW in v1.7)

Problem Solved: Existing users' config.yml files don't have the new sound configurations, causing PetSoundManager to load 0 sound configurations.

Solution Implemented:

• Automatic Detection: Detects configuration version and missing sections
• Non-Destructive Migration: Adds missing configurations without overwriting user customizations
• Smart Content Validation: Checks if sections exist but are empty
• Automatic Reload: Forces PetSoundManager reload after migration
• Complete Validation: Verifies all 64 sound configurations are properly loaded

Automatic Features:

• Database schema automatically migrates to add variant column
• Existing pets will have variants assigned and saved on next spawn
• NEW: Sound configurations automatically migrate from v1 to v2
• NEW: Empty configuration sections are automatically populated
• NEW: PetSoundManager automatically reloads after migration
• All changes are backward compatible

Configuration Updates:
New optional configuration sections automatically added to existing config.yml

Version: 1.7
Compatibility: Minecraft 1.16.5 - 1.21.8
Server Types: Paper, Spigot, Folia, Purpur
Build Date: 2025-01-11

SmartPets v1.6 - Changelog
v1.6 New Features & Improvements
✨ Critical Safety Enhancements

• Admin Pet Deletion Confirmation: Added mandatory confirmation GUI for destructive pet deletion operations
• Enhanced Exception Handling: Improved error logging in SchedulerCompat and PetType classes
• Thread Safety Improvements: Replaced HashMap with ConcurrentHashMap in concurrent contexts

⚙️ Configuration Optimization

• Configurable Constants: Made hardcoded values in PetSearchFoodTask and DriverDownloader configurable
• ActionBar Debug Enhancement: Added detailed logging for ActionBar functionality troubleshooting
• New Config Sections: Added search-food, network, and debug configuration sections

Compatibility Updates

• Minecraft 1.21.7/1.21.8 Support: Verified and updated compatibility claims
• Material API Compatibility: Fixed Material enum usage for cross-version compatibility

️ Safety & Robustness

• GUI Confirmation System: Prevents accidental pet data loss with visual confirmation dialogs
• Enhanced Error Reporting: Better logging for debugging server compatibility issues
• Performance Tuning: Network timeouts, scan intervals, and buffer sizes now configurable

SmartPets v1.5 - Changelog

What's New

Enhanced Admin Commands

• Preset Pet Giving: Admins can now give specific pet configurations directly
  • Example: /petadmin give Player1 CAT mystic_cat gives a Mystic Void Cat (Level 6, Light + Heal skills)
  • Example: /petadmin give Player1 WOLF alpha_wolf gives an Alpha Pack Leader (Level 15, Triple skills)
  • Works with all pets from the pet shop configuration

Custom Command Aliases

• Personalize Your Commands: Server owners can now add custom aliases in config.yml
  • Add your own shortcuts like /mypet, /companion, /petmgr
  • Perfect for multilingual servers or personal preferences
  • No restart required - updates with /petadmin reload

New Pet Support

• Allay: The helpful item-collecting fairy is now available as an experimental pet
  • Use /petadmin give Player1 ALLAY to try it out

Bug Fixes
Parrot Shoulder Issue (Critical Fix)

• Fixed: Parrots no longer get stuck on your shoulder when switching pets
• Fixed: Parrot name holograms now properly disappear when changing pets
• What happened: When you switched from a parrot to another pet, the parrot would stay on your shoulder
• Now: Instant, clean pet switching - no more ghost parrots!

WorldGuard Compatibility (Critical Fix)

• Fixed: Pets now spawn properly in WorldGuard protected areas
• What happened: Servers with WorldGuard mob-spawning restrictions couldn't summon pets
• Now: SmartPets automatically bypasses protection plugins - pets work everywhere!

Better Error Messages

• Improved: When using wrong pet types, you now see exactly which types are available
• Before: "Unknown pet type: Mystic" (unhelpful)
• Now: "Unknown pet type: Mystic. Valid types: WOLF, CAT, PARROT, RABBIT..." (helpful!)

Technical Improvements

• Enhanced compatibility with Minecraft 1.16.5 through 1.21.5
• Improved error handling and logging for easier troubleshooting
• Better hologram cleanup system prevents floating name tags
• More robust plugin integration with protection plugins

Configuration Updates
Check your config.yml for new options:

• Custom Command Aliases: Add your preferred command shortcuts
• WorldGuard Notice: Documentation about automatic compatibility

For Server Owners
This update focuses on reliability and ease of use:

• No more stuck parrots disrupting gameplay
• Works with WorldGuard out of the box
• Easier pet management for admins with preset system
• Customizable commands for better server branding

Installation

1. Stop your server
2. Replace SmartPets-1.4.3.jar with SmartPets-1.5.jar
3. Start your server
4. Enjoy the improvements!

No configuration migration needed - everything is backward compatible.

SmartPets v1.4.3 - Major Stability & AI Update

Critical Bug Fixes

️ Pet Attack System Overhaul

• FIXED: Pets attacking their owners due to flawed targeting logic
• FIXED: Elite Guardian Wolf fear-state inconsistencies
• IMPROVED: Multi-layer safety validation for all attack behaviors

Plugin Compatibility Shield

• NEW: Anti-conflict protection against other pet plugins
• FIXED: Entity ownership interference from AdvancedPets/CombatPets
• ADDED: Persistent data container validation system

Cross-Platform Stability

• FIXED: Folia scheduler crashes (delay ticks = 0)
• FIXED: Sound resource errors in MC 1.21.4+
• IMPROVED: SchedulerCompat for all server types (Paper/Folia/Purpur)

⚡ Performance & QoL Improvements

Smart Feedback System

• REDUCED: Message spam with optimized intervals (45s → 2min)
• IMPROVED: ActionBar integration with chat fallback
• BALANCED: Urgent vs normal feedback timing

Enhanced Pet Pathfinding

• FIXED: Pet suffocation in confined spaces
• IMPROVED: Teleportation logic for vertical terrain
• OPTIMIZED: Wolf-specific follow distances and stop behavior

Technical Highlights

• 14 files modified across core systems
• 7 critical bugs resolved with multi-layer protection
• Cross-compatible with Java/Bedrock (MC 1.16.5-1.21.5)
• Zero breaking changes - fully backward compatible

Installation

1. Backup your config (optional - no breaking changes)
2. Replace SmartPets jar file
3. Restart server - no config changes needed!

Tested on: Paper, Folia, Purpur, Luminol | MC Versions: 1.16.5-1.21.5
Requirements: Java 17, Vault plugin

This update resolves all major user-reported issues from community feedback. Your pets will now behave more intelligently and safely than ever before.

1.4.2: Folia and Luminol Support Update

Thanks to @SperoVida and @Chaositic for their reports, we have been able to achieve maximum compatibility with Folia and Luminol (limited).

Some menu, translation, and other issues have been fixed.

A pet duplication issue and other glitch-related issues have been fixed.

The compatibility system has been strengthened to make it as user-friendly as possible when using Paper, Spigot, Folia, or another fork.

After many hours of work, the plugin has achieved excellent stability. There are bound to be bugs, and we greatly appreciate your reporting them on our support Discord.

Finally, I've added complete documentation for the plugin, including how it works and how to configure it, in the Documentation tab. You can check it out.

If you like pets and want to give your server a special touch, don't wait any longer and install SmartPets.

SmartPets v1.4.1 - Critical Bug Fixes & Stability Improvements

Critical Bug Fixes:

• Fixed pet death loop spam - Resolved infinite "Pet death handled" messages in console caused by duplicate death event handlers
• Fixed pet duplication exploit - Eliminated ability to create infinite pets by repeatedly clicking in /pet menu
• Fixed "Not scheduled yet" errors - Resolved IllegalStateException spam when pets despawn or behavior tasks are cleaned up
• Fixed missing translations - Added all missing translation keys for pet tooltips (loyalty, fear, anger prefixes and others)

️ Technical Improvements:

• Unified pet selection logic - Eliminated inconsistent validation between menu and command systems
• Enhanced task management - Safer BukkitRunnable cancellation prevents scheduler-related crashes
• Improved command error handling - Added comprehensive exception handling for /pet commands with user-friendly messages
• Added debug logging - Better troubleshooting capabilities for pet spawning/despawning issues

Issues Resolved:

• Console spam from "Task #XXXXX generated an exception" and repeated death messages
• Silent /pets command failures now show proper error messages
• Pet behavior task cleanup errors and scheduler state validation issues
• All "Missing translation: menu.pet_icon.*" errors in admin menus and tooltips

Pet System Stability:

• Fixed entity death handling to prevent cleanup loops
• Improved pet entity lifecycle management
• Enhanced state consistency between active pet maps and entity tracking
• Better handling of invalid/dead entities during behavior evaluation

⚡ Compatibility:

• Paper/Spigot/Folia 1.16.5-1.21.5
• No configuration changes required
• Fully backward compatible with existing pet data

This stability-focused update resolves critical issues reported by server administrators and is highly recommended for all servers experiencing console spam, pet duplication, or menu translation errors.

SmartPets v1.4 - Major Update

✨ New Features

Enhanced Messaging System

• ActionBar Messages: Pet interactions now display in the action bar to reduce chat spam
• Customizable Display: Toggle between chat messages or ActionBar based on preferences

Complete Internationalization Support

• Translatable Menus: All menu titles, stat names, and shop messages can now be translated
• Extended Language Keys: Added 25+ new translation keys in lang.yml for full customization

Folia Compatibility

• Dual Compatibility: Works automatically on both Paper/Spigot and Folia servers
• Auto-Detection: Plugin detects server type and uses appropriate scheduler
• Zero Configuration: No setup changes required from users

Technical Improvements

Inventory Protection

• Anti Drag & Drop: Enhanced protection against item manipulation in menus (especially on Purpur 1.21.5+)
• GUI Stability: More robust menus against unwanted interactions

Performance Optimizations

• Unified Scheduler: More efficient task system that works across all platforms
• Error Handling: Better error management during plugin startup and shutdown

Bug Fixes

• Duplicate Messages: Removed duplicate author entries in plugin information
• Shutdown Errors: Fixed errors when stopping the server
• API Compatibility: Improved compatibility across Minecraft versions (1.16.5-1.21.5)

User Benefits

• ✅ Reduced Spam: More subtle pet interactions with ActionBar messaging
• ✅ Full Customization: Complete menu translation support for any language
• ✅ Enhanced Stability: Improved stability on modern servers
• ✅ Future Ready: Prepared for Folia transition when available

Important Notes
Backward Compatibility: This update is fully backward compatible. No existing configuration changes required.

SmartPets v1.3.0 - Seamless Setup Update

What's New?

✨ Automatic Database Setup
No more manual downloads! SmartPets now automatically downloads and sets up SQLite/MySQL drivers for you. Just install the plugin and you're ready to go!

Lightweight Distribution
The plugin file is now super lightweight (under 2MB) making downloads and updates lightning fast.

️ Enhanced Error Handling
Better error messages and automatic fallback to YAML storage if anything goes wrong. Your server will always stay running smoothly.

Improved Admin Tools
New debug commands show you exactly what's happening with your database setup and storage system.

[HR][/HR]

☀️ MID-YEAR SUMMER SALE - 30% OFF!
Get SmartPets now with 30% discount until June 30th!
Beat the summer heat with cool pet companions at an unbeatable price!


Upgrade Notes
• Fully backward compatible - no configuration changes needed
• Automatic migration - existing pet data stays safe
• Zero downtime - update without affecting your players

Technical Details
• Compatible with Minecraft 1.16.5 - 1.21.5
• Works with Paper, Spigot, and Folia
• Automatic SQLite/MySQL driver management
• Enhanced database connectivity and error recovery

Bug Fixes

Sound Compatibility Issues

• Fixed: Replaced incompatible sounds that were causing crashes on newer server versions
• Fixed: Updated all pet behavior tasks to use Spigot 1.16.5 compatible sounds
  
• Fixed Help Commands: Previously non-functional help topics now work correctly

Translation System

• Fixed emotion display translations: Resolved "Missing translation: emotion.happy []" error in pet detail menus
• Improved UI consistency: Pet mood now displays correctly in both pet detail menu and /pet info command

Improvements

• Help Command Enhancement: Updated main help command to display available topics
• User Experience: Improved command feedback with detailed, categorized information

This update focuses on improving player onboarding and understanding of the SmartPets system through an enhanced help interface.

SmartPets v1.2 - Major Experience Enhancement Update

Revolutionary AI Pet Experience with Enhanced Player Feedback & Interaction Systems

We're excited to announce the biggest SmartPets update yet! This release focuses on making the plugin more intuitive, engaging, and user-friendly while maintaining the advanced AI that makes SmartPets special.

MAJOR NEW FEATURES

️ Intelligent Pet Feedback System

• Real-time Status Updates: Your pet now communicates their needs through subtle, non-intrusive messages
• Critical Need Alerts: Get immediate notifications when your pet is starving, exhausted, or in distress
• Positive Reinforcement: Receive encouraging messages when you're doing a great job caring for your pet
• Smart Care Tips: Random helpful hints about pet care, leveling, and evolution
• Action Bar Integration: Subtle feedback through action bar messages (configurable)
• Customizable Intervals: Fully configurable timing for all feedback types

Comprehensive Help & Discovery System

• Contextual Help: Get personalized advice based on your pet's current condition
• Topic-Based Guides: Detailed help for basics, stats, leveling, evolution, skills, behavior, and interaction
• Dynamic Information: Help messages show actual config values (EXP rates, cooldowns, etc.)
• Quick Tips for Beginners: Essential information for new players
• Interactive Commands: /pet help [topic] for specific guidance
• No More Guesswork: Discover all mechanics without reading config files!

Advanced Emotion Display System

• Clear Emotion Translation: Complex stats now translate into understandable emotions
• Detailed Explanations: Understand exactly what each emotion means for your pet
• Stress Factor Analysis: Identify what's causing your pet distress
• Personalized Recommendations: Get specific advice based on your pet's emotional state
• Intensity Indicators: See how strongly your pet feels (Mild, Strong, Very Strong)
• Emoji Support: Visual emoji icons for instant emotion recognition

Revolutionary Interaction System

• Intelligent Interaction Detection: Automatically determines feeding vs. petting vs. playing
• Enhanced Visual Feedback: Beautiful particles and animations for each interaction type
• Pet-Specific Audio: Different sounds for different pet types and interactions
• Realistic Pet Behavior: Pets look at you, jump with joy, and show authentic reactions
• Smart Cooldown System: Prevents overwhelming pets while maintaining engagement
• Toy Recognition: Use sticks, bones, and other items to play with your pets
• Overrides Default Behaviors: No more wolves sitting when you want to pet them!

️ TECHNICAL IMPROVEMENTS

Complete Localization Support

• Fully Translatable: Every message is now in lang.yml - perfect for international servers
• 100+ New Message Keys: Comprehensive language support for all new features
• Dynamic Placeholders: Messages adapt to show pet names, values, and context
• Professional Formatting: Consistent color coding and formatting throughout

⚙️ Extensive Configuration Options

• Feedback System Controls: Enable/disable any aspect of the feedback system
• Interaction Customization: Configure cooldowns, effects, sounds, and behaviors
• Help System Settings: Control contextual help, tips, and value display
• Emotion Display Options: Customize intensity display, stress factors, and recommendations
• Performance Tuning: Adjust intervals and resource usage to fit your server

️ Improved Architecture

• Modular Design: New manager classes for better organization and maintainability
• Configuration-Driven: Everything is configurable without code changes
• Performance Optimized: Smarter task scheduling and resource management
• Event-Driven Updates: More responsive pet state changes and feedback

NEW FILES & STRUCTURE

Enhanced Configuration:

• 
  
  • Expanded lang.yml: 100+ new translatable messages and help content
  • Enhanced config.yml: New sections for feedback, interaction, help, and emotion systems
  • Backward Compatible: All existing configurations remain functional

FOR SERVER ADMINISTRATORS

Easy Migration:

• 
  
  • ✅ Drop-in Replacement: Simply replace the old JAR with the new one
  • ✅ Auto-Configuration: New config sections are added automatically with sensible defaults
  • ✅ Existing Data Safe: All pet data, levels, and progress are preserved
  • ✅ No Breaking Changes: All existing commands and permissions work exactly the same

Customization Options:

• 
  
  • Disable Features: Turn off any new system you don't want (feedback, help, etc.)
  • Adjust Performance: Fine-tune intervals and resource usage for your server size
  • Localize Content: Translate everything to your server's language
  • Brand Integration: Customize messages and help content to match your server theme

FOR PLAYERS

Immediate Benefits:

• 
  
  • Never Miss Pet Needs: Get notified when your pet needs attention
  • Learn the System: Comprehensive help guides teach you everything
  • Understand Your Pet: Clear emotional feedback helps you be a better owner
  • Better Interactions: More engaging and realistic pet interactions
  • Optimize Care: Learn exactly how to level up and evolve your pets efficiently

New Commands:

• 
  
  • /pet help - Enhanced help with topic system
  • /pet help basics - Learn pet care fundamentals
  • /pet help stats - Understand pet emotions and needs
  • /pet help leveling - Master the experience system
  • /pet help evolution - Learn about pet evolution
  • /pet help skills - Discover pet abilities
  • /pet help behavior - Understand AI patterns
  • /pet help interaction - Perfect your pet interactions

WHAT'S NEXT?

This update lays the foundation for even more exciting features coming soon:

• 
  
  • Advanced Pet Personalities - Unique behavioral traits per pet
  • Pet Housing System - Build homes and environments for your pets
  • Multi-Pet Management - Enhanced tools for managing multiple pets
  • Cosmetic Customization - Visual customization options for pets
  • World Integration - Enhanced environmental interactions

FEEDBACK & SUPPORT

We're committed to making SmartPets the best AI pet plugin available. Your feedback drives our development!

• 
  
  • Bug Reports: Use the Issues tab on our GitHub or PM us directly
  • Feature Requests: Share your ideas for future updates
  • ⭐ Reviews: If you love the update, please leave a review!
  • Community: Join our Discord for support, tips, and showcase your pets

Special Thanks: To our community for the fantastic feedback and suggestions that made this update possible!


Compatible with Spigot/Paper 1.16.5 - 1.21.5 | Requires Vault | Optional: DecentHolograms, PlaceholderAPI, LuckPerms

SmartPets v1.1 Changelog

Bug Fixes

• Fixed bStats initialization error that prevented plugin from starting on some servers
• Resolved shade plugin configuration causing missing MetricsBase class

Performance Improvements

• Optimized JAR packaging - removed unnecessary dependencies from core plugin
• Added graceful fallback to YAML storage when database drivers are missing

Pet System Enhancements

• Removed experimental pet types from default shop (FOX, RABBIT, SHEEP, PIG, IRON_GOLEM, SLIME)
• Focused on fully compatible pets only (WOLF, CAT, PARROT) for optimal AI experience
• Added Legendary Phoenix - flagship pet showcasing all plugin capabilities (6 skills, level 25)
• Improved pet shop progression with better skill distribution and pricing

Installation Improvements

• Simplified installation - plugin works immediately with YAML storage (no downloads required)
• Optional database drivers - download SQLite/MySQL JARs separately only if needed
• Enhanced documentation in config.yml with clear setup instructions
• Better error handling for missing database drivers

Economy Balance

• Restructured pet pricing from beginner ($1,200) to flagship ($25,000)
• Strategic skill progression across price tiers
• Premium showcase pet demonstrating full plugin potential

Download Requirements:

• Basic Setup: Just download SmartPets.jar - works immediately!
• SQLite Storage (optional): Add sqlite-jdbc-3.42.0.0.jar to plugins folder
• MySQL Storage (optional): Add mysql-connector-java-8.0.33.jar to plugins folder

Recommended for: All servers. Existing servers can update without data loss.