• Visual feedback feels alive: emotion displays now refresh automatically, show localized context messages, and respect your server’s day/night cycle.
• Conversations make sense in every language: all contextual strings moved to lang.yml, with proper tab-completion logic tied to in-game time.
• Pets develop real personalities: interactions now influence trait profiles, archetypes appear in /pet stats, and data persists across reloads.
• Translations everywhere: physical state indicators, conversation prompts, and feedback messages are fully localizable and emoji-ready.
• Overall tuning: improved emotion impact calculations, streamlined hunger/rest tips.

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

1. Backup your data (always recommended before updates)
2. Stop your server
3. Replace the old SmartPets JAR with v1.9.5
4. Start your server
5. 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.

• 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

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

• 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

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

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

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

• 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

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

• 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

• 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

• 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

• 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

• 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

• 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

• 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

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!

• 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

• 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

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

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!

• 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!"

• 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

• 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

• 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

• 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!

• 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

• 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

• 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

• 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!

• /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

• 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

• 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

• 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

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

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

• 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

• 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

• 🧭 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

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

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

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

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

• 🏔️ 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

• 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

• 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

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

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

• 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

• Install normally - all features available immediately

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

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

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

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

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

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

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

• ✅ 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

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

• 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

• 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

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

• 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

• 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

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

• 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!

• 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!

• 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!)

• 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

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

• 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

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

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.

☀️ 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

New Manager Classes:

• PetFeedbackManager.java - Handles all player feedback and notifications
• HelpManager.java - Comprehensive help and guidance system
• EmotionDisplayManager.java - Advanced emotion interpretation and display
• InteractionManager.java - Intelligent pet interaction handling

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!

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.