SmartPets Pro v2.2

SmartPets v1.9.5 - Bug Fix & Enhancement Release
Release Date: October 12, 2025 Type: Maintenance & Bug Fixes

Bug Fixes

Critical Fixes
1. Fixed Pet Name Not Appearing in Messages
Problem: Pet names were not displaying correctly in various plugin messages and GUIs. Messages showed placeholder text like "arg0" instead of the actual pet name.

Solution: Corrected the translation system to properly replace placeholders with actual pet names.
Impact: All messages now display pet names correctly, improving user experience and message clarity.

2. Fixed Shop Permission Bypass
Problem: Players could access and purchase from the pet shop even without proper permissions, breaking permission-based access control.
Solution: Added proper permission checks for both opening the shop and purchasing pets.

Impact: Server administrators can now properly control shop access using LuckPerms or other permission plugins:

smartpets.shop.use - Required to open the shop
smartpets.shop.buy - Required to purchase pets

3. Fixed Console Spam from Pet Self-Attack Bug

Problem: When pets accidentally targeted their owners (a known bug), error messages flooded the console and player chat every tick, causing server lag and chat spam.

Solution: Implemented a cooldown system that limits warning messages to once every 5 seconds.

Impact: Cleaner console logs and chat, reduced server performance impact from excessive logging, while still alerting administrators to issues.

4. Fixed Pets Invisible After Server Restart

Problem: When players logged back in after a server restart or reconnection, their active pets would not re-appear, requiring manual re-summoning.

Solution: Added automatic pet re-spawning system that activates when players join the server.

Impact: Pets now automatically appear when you log in, maintaining a seamless gameplay experience across server restarts.

Enhancements
Multi-line Skill Descriptions

Feature: Skills now support multi-line descriptions in skills.yml for better readability.

Benefit: Create more detailed and visually appealing skill descriptions with proper formatting.

Backward Compatible: Existing single-line descriptions continue to work without changes.

Example Usage:

skills:
attack:
name: "&cProtector's Fury"
description:
- "&7Allows the pet to engage and attack"
- "&7hostile targets threatening its owner"
- "&7or itself."
required-level: 5
type: PASSIVE

Technical Improvements

• Improved thread-safety for concurrent operations
• Enhanced error handling and validation

-Better code documentation for future maintenance
- Optimized permission checking system

Upgrade Instructions

• Backup your data (always recommended before updates)
• Stop your server
• Replace the old SmartPets JAR with v1.9.5
• Start your server
• Verify the new permissions work correctly:
• Test smartpets.shop.use permission
• Test smartpets.shop.buy permission

Note: Existing configurations are fully compatible. No manual changes required.

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