Fixed a bug that caused entities to survive server restarts.

Fixed a double-spawn race condition bug at startup.

Fixed an issue where, when a player disconnected, the entity remained in the world without being cleared. Upon reconnecting, a new entity would spawn without removing the previous one.

Added an orphaned entity cleanup at startup that, upon server startup, searches all worlds for SmartPets-marked entities that are not tracked on the active map and removes them.

• Threading compatibility with Folia and Luminol servers
• IllegalStateException: Thread failed main thread check errors
• Repeated errors during pet spawn and behavior evaluation
• Maven warning about relocated MySQL Connector artifact
• RuntimeException: Async scheduling not supported on Luminol in AdvancedEmotionDisplayManager ✨ NEW
• Plugin initialization failure on Luminol ✨ NEW

• Improved Luminol detection in SchedulerCompat
• Duplicate entity cleanup now skipped on region-threaded servers
• Added threading protection to all getCustomName() calls
• Updated MySQL dependency from mysql:mysql-connector-java to com.mysql:mysql-connector-j
• MySQL Connector version updated from 8.0.33 to 8.4.0
• Made SchedulerCompat.isLuminol() public for consistent checks ✨ NEW
• Standardized all Luminol checks across the codebase ✨ NEW
• AdvancedEmotionDisplayManager now skips cleanup task on Luminol ✨ NEW

• Added SchedulerCompat.usesRegionThreading() method
• Enhanced error handling for cross-region entity access
• Graceful fallbacks for threading-related errors
• Modernized Maven dependencies to use current artifact coordinates
• Robust scheduler compatibility checks before task creation ✨ NEW
• Fallback from async to sync schedulers when async not supported ✨ NEW

• Language Files Folder: New langs/ folder structure for language files
• Spanish Translation: Complete Spanish translation (~450+ keys) included out of the box
• Automatic Fallback: If a translation key is missing, automatically uses English
• Backwards Compatible: Legacy lang.yml file still works for existing installations
• Hot Reload: Change language without server restart using /petadmin reload
• Easy Extension: Add new languages by creating langs/<code>.yml files

# In config.yml

plugins/SmartPets/

• Thread-safe message caching with ConcurrentHashMap
• HEX color code support (&#RRGGBB)
• Placeholder system preserved ({pet_name}, {player}, etc.)
• Automatic extraction of bundled language files on first run

1. Added InventoryType.CHEST check to all GUI handlers - Shulker Boxes use SHULKER_BOX type
2. Changed title matching from contains() to more specific patterns (startsWith(), endsWith(), equals())
3. Applied fix to all affected GUI classes

1. Connection validation only checked isClosed() but didn't test if connection was actually usable
2. MySQL server-side timeouts weren't handled properly
3. No automatic retry mechanism for connection failures

1. Enhanced Connection Validation: Added isConnectionValid() method that tests connections with SELECT 1
2. Improved MySQL URL: Added robust connection parameters:
   • connectTimeout=60000 & socketTimeout=60000 - Longer timeouts
   • maxReconnects=3 & initialTimeout=2 - Automatic reconnection
   • allowPublicKeyRetrieval=true & serverTimezone=UTC - Compatibility
3. Automatic Retry Logic: Both executeAsync() and queryAsync() now retry up to 2 times on connection errors
4. Connection Refresh: Forces new connection creation when stale connections detected

SmartPets v2.0.3 - MySQL Storage Fix

Release Date: 2026-01-01 Type: Bug Fix Release Priority: HIGH

Bug Fixes

Critical: MySQL Storage Not Working

Problem: Users could not use MySQL storage. The plugin showed Invalid storage type 'MYSQL' and fell back to YAML.

Root Causes:

1. MYSQL was missing from the PetDataHandler.StorageType enum
2. MySQL driver URL was obsolete (Oracle changed the artifact ID)
3. PetDataHandler was not integrated with the database storage system

Solution:

• Added MYSQL to the storage type enum
• Updated MySQL driver from deprecated mysql-connector-java-8.0.33 to mysql-connector-j-8.4.0
• Integrated DatabaseManager and DatabasePetStorage into PetDataHandler
• Added automatic fallback to YAML if database connection fails

Critical: MySQL Foreign Key Constraint Error (errno: 150)

Problem: Users with MySQL storage in shared databases got the following error:

[SmartPets] Failed to initialize database: Can't create table `game_global`.`pets`
(errno: 150 "Foreign key constraint is incorrectly formed")

Root Causes:

1. Foreign keys in MySQL require exact matching of charset, collation, and column types
2. When using a shared database with other plugins, the players table might already exist with different charset/collation
3. MySQL's foreign key validation is stricter than SQLite's

Solution:

• Removed foreign keys from MySQL tables - Referential integrity is now enforced at application level
• Added table name prefixes for MySQL: smartpets_players, smartpets_pets, smartpets_pet_stats, smartpets_pet_skills
• Explicit ENGINE=InnoDB and utf8mb4 charset for maximum compatibility
• SQLite retains foreign keys as it handles them without issues

Why This Works:

• Prefixed table names avoid conflicts with other plugins using the same database
• Removing FK constraints eliminates charset/collation/type mismatches
• Application-level integrity validation is a common pattern in Minecraft plugins
• Same data integrity, but works in all MySQL configurations

Migration Notes

For New Installations

• No action required, tables are created with correct structure automatically

For Existing MySQL Users with errno 150

1. Stop your server
2. Option A (Recommended): Drop the failed SmartPets tables:
   
   

   DROP TABLE IF EXISTS pet_skills;
   DROP TABLE IF EXISTS pet_stats;
   DROP TABLE IF EXISTS pets;
   DROP TABLE IF EXISTS players;
   

   
   
3. Replace SmartPets-2.0.1.jar with SmartPets-2.0.3.jar
4. Start your server (new prefixed tables will be created)

For Existing MySQL Users WITHOUT Errors

• Data migration from old table names is NOT automatic
• If you had working MySQL storage, keep using v2.0.2 OR migrate data manually:
  
  

  -- Only if upgrading from working v2.0.1 to v2.0.3
  RENAME TABLE players TO smartpets_players;
  RENAME TABLE pets TO smartpets_pets;
  RENAME TABLE pet_stats TO smartpets_pet_stats;
  RENAME TABLE pet_skills TO smartpets_pet_skills;
  

  
  

Compatibility

What Changed for End Users

• MySQL now works in shared databases without conflicts
• No configuration changes needed - same storage-type: "MYSQL" setting
• Data structure unchanged - same columns, just different table names for MySQL
• SQLite users unaffected - same behavior as before

Upgrade Instructions

1. Stop your server
2. Replace SmartPets-2.0.1.jar with SmartPets-2.0.3.jar
3. Delete old driver if present: plugins/SmartPets/lib/mysql-connector-java-*.jar
4. Start your server (new driver downloads automatically)

Note: No configuration changes required. Existing data is preserved.

SmartPets v2.0.1 - Improved Pet Selection & Major Bug Fixes

Release Date: 2025-01-23 Type: Recommended Update (Critical Fixes) Priority: HIGH

🌟 Key Improvements

🐾 Smart Pet Selection

You can now interact with pets using their Name, UUID, or just a Prefix of either!

• 
  
• Before: You often had to use the exact random UUID (e.g., /pet select 3e687eaf) or the command would fail.
• Now: Just type /pet select Fido (or whatever your pet is named). It just works.
• Bonus: Tab completion now correctly suggests names that are actually valid.

🎨 HEX Colors & Custom Prefixes

• 
  
• HEX Support: Use modern, vibrant colors in all messages! Format: &#RRGGBB (e.g., &#FF5733MyPet).
• Custom Prefixes: You can finally customize or remove the plugin prefix. Check lang.yml for new options like prefix, prefix.error, etc.

🐛 Bug Fixes

• 
  
• Fixed Pet Selection (Critical): Resolved a critical issue where commands would incorrectly error out (claiming "Pet died" or "Not found") when using pet names.
• Fixed Message Placeholders: Messages like "Are you sure you want to release {arg0}?" now correctly show the pet name/details instead of the raw variable text.
• Fixed Console Spam: Debug messages ("Pet is active...", "Loaded emotions...", etc.) are now properly hidden when debug: false is set in config.yml.
• Fixed Tab Completion: Suggestions in commands like /pet select and /pet release are now accurate.

🔌 Compatibility

• 
  
• Minecraft Versions: 1.16.5 - 1.21.x
• Software: Spigot, Paper, Purpur, Folia (Experimental)
• Java: Java 17 or higher required.
• HEX Colors: Requires Minecraft 1.16+ client and server.

� How to Update

1. 
   
2. Stop your server.
3. Delete the old SmartPets-2.0.jar.
4. Upload the new SmartPets-2.0.1.jar.
5. Start your server.

Note: No configuration reset is required. You can optionally check lang.yml to customize the new prefix settings.

SmartPets v2.0 - Memory & Intelligence Revolution

🚀 Major Features

🧠 Persistent Memory & Intelligence Core

• Social Memory System: Pets record player interactions, trust/fear deltas, and location sentiment (safe vs. danger zones) with LRU limits and scheduled snapshots.
• Event Timeline: Key moments (battles, celebrations, reinforcing actions) are stored per pet with configurable limits and retention policies.
• Reinforcement Learning: Positive/negative feedback and owner preferences now bias the BehaviorEngine, visibly altering AI decisions over time.
• Dynamic Personality Evolution: Archetypes evolve based on memory and learning inputs; /pet personality surfaces traits, history, and latest adjustments.

🖥️ Player & Admin Experience

• Memories Dashboard: /pet memories UI consolidates social contacts, pinned locations, event log, and direct reinforcement controls.
• Command Upgrades: /pet personality, /petadmin debug learning, and enhanced /pet info provide immediate insight into behavioral changes.
• Actionable Admin Debug: New /petadmin debug integrations summarises runtime status of ModelEngine/MythicMobs bridges, mappings, and adapters.

🎨 External Integrations (Optional)

• ModelEngine 4 Adapter: Attaches custom models, emotion-driven animations, and trigger-based states with automatic fallback to vanilla entities.
• MythicMobs Adapter: Applies Mythic profiles or triggers configured skills in response to SmartPets events (summon, level-up, feedback signals).
• Config-Driven & Safe: Integrations are opt-in, degrade gracefully when dependencies are missing, and expose granular logging categories.

🧰 Configuration & Tooling

• config.yml now includes integrations.modelengine.models and integrations.mythicmobs.profiles maps for per-type setup of models, animations, mob IDs, and skill triggers.
• Sample configuration (per type):
  
  

  integrations:
    modelengine:
      enable: true
      auto-fallback: true                  # Gracefully revert to vanilla entities if something fails
      models:
        WOLF:
          model-id: "smartpets:wolf_guardian"   # ModelEngine asset namespace:id
          idle-state: "idle"                    # Looping state when calm
          walk-state: "walk"                    # State while following the owner
          emotion-animations:
            HAPPY: "tail_wag"                   # Emotion → animation mapping
            ANGRY: "battle_ready"
            SCARED: "cower"
          trigger-animations:
            summon: "summon_pop"                # Triggered after SmartPets spawns the pet
            event.levelup: "celebrate"          # Triggered on level-up
            feedback.feeding_success: "eat_treat" # Triggered after positive feeding feedback
    mythicmobs:
      enable: true
      profiles:
        WOLF:
          mob-id: "SmartPetsGuardian"           # MythicMob ID defined in MythicMobs configs
          mob-level: 10.0                       # Optional level value passed to MythicMobs
          apply-to-entity: true                 # Replace vanilla AI/attributes with Mythic profile
          trigger-skills:
            summon: "SP_GuardianSpawn"          # Activates the custom spawn skill
            event.levelup: "SP_GuardianCelebrate" # Celebratory ability on level-up
            feedback.petting_happy: "SP_GuardianPurr" # Fired when the owner pets the companion
  

  
  
• README features integration quick-start and release verification checklists (diagnostics, bStats monitoring, fallback advice).
• All new debug outputs are fully localised via lang.yml, ensuring translation completeness.

📊 Metrics & Monitoring

• bStats charts added: modelengine_integration_state, modelengine_mapping_density, mythicmobs_integration_state, mythicmobs_profile_density.
• Logging system refreshed with rate-limited categories (LogCategory.INTEGRATIONS, etc.) to keep production logs actionable.

🛠️ Upgrade Notes

• No manual migrations required; memory/learning subsystems self-initialise and respect existing storage backends (YAML/SQLite/MySQL).
• Keep integrations disabled if unused; SmartPets automatically reverts to vanilla behaviour when ModelEngine/MythicMobs are absent.
• After enabling integrations, run /petadmin reload followed by /petadmin debug integrations to validate configuration before going live.

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