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.