SmartPets Pro icon

SmartPets Pro -----

Pets That Think, Feel, and Live

Download Now
555.6 KB .jar


SmartPets
[​IMG] [​IMG] [​IMG]

SmartPets is a revolutionary AI-driven pet system for Minecraft servers featuring emotional intelligence, advanced behaviors, dynamic evolution, and automatic database driver downloads. Experience the most sophisticated pet plugin with 12+ intelligent behaviors, 8-stat emotion system, and seamless multi-server compatibility.

Key Features
Advanced AI System
  • 12+ Intelligent Behaviors: Follow, Guard, Hunt, Play, Rest, Attack, Flee, Assist, Scout, Patrol, Search Food, Alert
  • 8-Stat Emotion System: Hunger, Energy, Affection, Happiness, Trust, Loyalty, Fear, Anger
  • Context-Aware Decision Making: Pets consider time, environment, and player interactions
  • Dynamic Behavior Switching: Emotions and needs influence pet actions
Rich Gameplay Features
  • Experience & Leveling: Pets gain XP through various activities and level up
  • Skill System: Unlock new abilities as pets advance (7+ skills available)
  • Evolution System: Transform pets into more powerful forms
  • Pet Shop: Adopt from 8+ available pet types with different characteristics
  • Complete GUI System: Intuitive menus for players and administrators
Technical Excellence
  • Automatic Driver Downloads: No manual database setup required
  • Multi-Storage Support: YAML (default), SQLite, MySQL with automatic fallback
  • Lightweight Distribution: JAR under 2MB, drivers downloaded at runtime
  • Universal Compatibility: Paper/Spigot/Folia/Purpur support (1.16.5-1.21.8)
  • Professional Integrations: Vault, PlaceholderAPI, DecentHolograms, LuckPerms
Requirements
Mandatory
  • Minecraft: 1.16.5 - 1.21.8
  • Server: Paper, Spigot, Folia, Purpur, or Luminol
  • Java: 17 or higher
  • Vault: Required dependency for economy features
Optional
  • PlaceholderAPI: Custom placeholders for other plugins
  • DecentHolograms: Holographic displays for pets
  • LuckPerms: Advanced permission management
  • Citizens: NPC integration potential
Installation
  1. Download SmartPets-1.4.2.jar
  2. Install Vault plugin (required dependency)
  3. Place SmartPets jar in your plugins/ folder
  4. Start your server - drivers download automatically
  5. Configure using /petadmin reload after first run
Note: Database drivers (SQLite/MySQL) are downloaded automatically from Maven Central with integrity verification. No manual setup required!

Commands
Player Commands
/pet (Aliases: pets, smartpet, mascota)
Main pet management command with multiple sub-actions:

Code (YAML):
/pet                    - Open main pet menu
/pet help              - Show help information
/pet list              - List your owned pets
/pet select <name>     - Select active pet
/pet rename <name>     - Rename your active pet
/pet release           - Release your active pet
/pet shop              - Open pet adoption shop
/pet evolve            - Evolve your active pet
/pet info              - Show detailed pet information
Required Permission: smartpets.command.pet (default: true)

Admin Commands
/petadmin (Aliases: smartpetadmin, petsa)
Administrative management commands:

Code (YAML):
/petadmin reload                    - Reload plugin configuration
/petadmin give <player> <type>      - Give pet to player
/petadmin reset <player>            - Reset player's pet data
/petadmin delete <player> <name>    - Delete specific pet
/petadmin debug                     - Show system debug information
/petadmin menu                      - Open admin management GUI
Required Permission: smartpets.command.admin (default: op)

Permissions
Hierarchical Permission System

Code (YAML):
# Master permissions
smartpets.*                    - All SmartPets features (Super Admin )
smartpets.command.*            - All commands
smartpets.pet.*               - All pet-related permissions
smartpets.admin.*             - All admin permissions
smartpets.shop.*              - All shop permissions
# Basic permissions
smartpets.command.pet         - Use /pet command (default : true )
smartpets.command.admin       - Use /petadmin commands (default : op )
smartpets.pet.own             - Own pets (default : true )
smartpets.pet.evolve          - Evolve pets (default : true )
smartpets.pet.rename          - Rename pets (default : true )
# Advanced permissions
smartpets.pet.limit.bypass    - Bypass pet ownership limits (default : op )
smartpets.pet.limit.2         - Own up to 2 pets
smartpets.pet.limit.3         - Own up to 3 pets
smartpets.pet.limit.5         - Own up to 5 pets
smartpets.pet.limit.10        - Own up to 10 pets
# Pet type restrictions
smartpets.pet.type.WOLF       - Acquire Wolf pets (default : true )
smartpets.pet.type.FOX        - Acquire Fox pets (default : true )
smartpets.pet.type.CAT        - Acquire Cat pets (default : true )
smartpets.pet.type.IRON_GOLEM - Acquire Iron Golem pets (default : op )
# Shop permissions
smartpets.shop.use            - Access pet shop (default : true )
smartpets.shop.buy            - Purchase pets (default : true )
# Admin permissions
smartpets.admin.reload        - Reload configuration (default : op )
smartpets.admin.give          - Give pets to players (default : op )
smartpets.admin.reset         - Reset player data (default : op )
smartpets.admin.delete        - Delete specific pets (default : op )
smartpets.admin.debug         - View debug information (default : op )
smartpets.admin.menu          - Access admin GUI (default : op )

⚙️ Configuration
Main Configuration (config.yml)
SmartPets provides extensive configuration with 490+ lines of options:

General Settings (Enhanced in v1.9)

Code (YAML):
general:
  storage-type : "YAML"           # YAML, SQLITE, MYSQL
  max-pets-per-player : 1         # Default pet limit
  debug : false                   # Enable debug logging (enhanced debug system in v1.9)
  metrics : true                   # bStats metrics
  language : "en"                 # Language file to use (50+ new keys in v1.9)
# NEW in v1.9: Enhanced Communication Settings
communication:
  conversation-enabled : true     # Enable /pet talk conversations
  conversation-cooldown : 30       # Seconds between conversations
  interaction-feedback : true     # Show interaction results
  emotion-display-enabled : true   # Rich visual emotion display
  emotion-display-duration : 10   # Seconds to show emotions
  species-responses : true         # Species-specific responses
Pet Type Configuration

Code (YAML):
pet-types:
  enabled-pet-types :
    - "WOLF"
    - "FOX"
    - "CAT"
    - "PARROT"
    - "SHEEP"     # Experimental
    - "RABBIT"     # Experimental
    - "PIG"       # Experimental
  blocked-pet-types :
    - "IRON_GOLEM"   # Blocked for safety
    - "SLIME"         # Blocked for safety

AI Behavior System (Enhanced in v1.9)

Code (YAML):
behavior:
  behavior-task-interval : 10     # Seconds between AI decisions
  emotion-task-interval : 60       # Seconds between emotion updates
  # Behavior probabilities (0.0-1.0)
  follow-chance : 0.3
  guard-chance : 0.2
  hunt-chance : 0.15
  play-chance : 0.25
  rest-chance : 0.1
  # Advanced behavior settings
  hunt-range : 16                 # Blocks to search for prey
  guard-range : 8                 # Blocks to guard around player
  follow-distance : 3             # Blocks to maintain when following
  # NEW in v1.9: Enhanced Behavior Configuration
  interaction-types:
    comfort-enabled : true         # Allow comfort interactions
    praise-enabled : true         # Allow praise interactions
    play-enabled : true           # Allow play interactions
    celebration-enabled : true     # Allow celebration interactions
  # Search food behavior (configurable in v1.9)
  search-food:
    scan-radius : 8.0             # Pet food scanning distance
    eat-radius : 3.0               # Consumption proximity requirement
    max-search-time : 30           # Maximum search duration (seconds)
    scan-interval : 2             # Time between food scans (seconds)
    hunger-per-food : 40           # Hunger restored per food item
    full-hunger-threshold : 90     # Hunger level to stop searching

Emotion System (Enhanced in v1.9)

Code (YAML):
emotions :
   # Decay rates (per cycle)
  hunger-decay-rate : 1
  energy-decay-rate : 1
  affection-decay-rate : 1
  fear-decay-rate : 1
  anger-decay-rate : 1
  # Minimum values
  minimum-hunger : 0
  minimum-energy : 0
  minimum-affection : 0
  minimum-happiness : 0
  minimum-trust : 0
  minimum-loyalty : 0
  minimum-fear : 0
  minimum-anger : 0
  # Neglect system
  neglect-threshold-minutes : 30
  neglect-happiness-penalty : 5
  neglect-trust-penalty : 3
  # NEW in v1.9: Enhanced Emotion Display
  visual-communication:
    enabled : true
    update-interval : 5           # Seconds between emotion updates
    display-duration : 10         # Seconds to show emotion displays
 
    # Emotion gradients (5 levels each)
    intensity-levels : 5
    combination-display : true     # Show multiple emotions
    contextual-expressions : true # Context-aware emotion text
  # Thresholds for behaviors (configurable in v1.9)
  fear-threshold-to-attack : 50   # Fear level below which pets can attack
  fear-threshold-to-flee : 70     # Fear level above which pets flee
  happiness-threshold-play : 60   # Happiness needed for play behavior
Experience System

Code (YAML):
experience:
  base-exp-requirement : 100     # Base XP needed for level 2
  level-multiplier : 1.5         # Multiplier for each level
  max-level : 50                 # Maximum pet level
  # Experience rewards
  feeding-exp-gain : 5
  petting-exp-gain : 3
  killing-mob-exp-gain : 10
  defending-player-exp-gain : 15
  following-period-exp-gain : 2
  playing-period-exp-gain : 4
  assisting-player-exp-gain : 8
  successful-hunt-exp-gain : 12
  guarding-area-exp-gain : 6
  scouting-area-exp-gain : 7
Integration Settings

Code (YAML):
integrations: [/B ]
[B]  economy-enabled : true           # Vault economy integration[/B]
[B]  placeholderapi-enabled : true   # PlaceholderAPI integration[/B]
[B]  holograms-enabled : true         # DecentHolograms integration


Database Configuration

Code (YAML):
database:
  mysql:
    host : "localhost"
    port : 3306
    database : "smartpets"
    username : "root"
    password : ""
    ssl : false
  sqlite:
    filename : "smartpets.db"
Skills Configuration (skills.yml)
Define pet abilities and unlock requirements:

Code (YAML):
skills:
  heal:
    name : "Healing Aura"
    description : "Regenerates health over time"
    unlock-level : 5
    cooldown : 30
    effect-duration : 10
 
  shield:
    name : "Protective Shield"
    description : "Absorbs incoming damage"
    unlock-level : 10
    cooldown : 60
    shield-amount : 4
 
  speed:
    name : "Swift Movement"
    description : "Increases movement speed"
    unlock-level : 3
    cooldown : 45
    speed-boost : 2
Pet Shop Configuration (available_pets.yml)
Configure adoptable pets:

Code (YAML):
available-pets:
  wolf_basic:
    type : "WOLF"
    name : "Loyal Wolf"
    description : "A faithful companion"
    price : 1000
    permission : "smartpets.pet.type.WOLF"
 
  fox_clever:
    type : "FOX"
    name : "Clever Fox"
    description : "An intelligent scout"
    price : 1500
    permission : "smartpets.pet.type.FOX"
Language Configuration (lang.yml) - Expanded in v1.9
SmartPets v1.9 adds 50+ new translation keys for the conversation and interaction systems:

Code (YAML):
commands:
  pet:
    help : "&6SmartPets Help:"
    no-pets : "&cYou don't have any pets!"
    pet-selected : "&aSelected pet: &f{pet_name}"
    # NEW in v1.9: Enhanced commands
    talk-started : "&aStarting conversation with {pet_name}..."
    stats-header : "&6=== Pet Statistics ==="
    no-active-pet : "&cYou don't have an active pet."
 
menus:
  main:
    title : "SmartPets Management"
    adopt-pet : "&aAdopt New Pet"
    manage-pets : "&eManage Pets"
 
  # NEW in v1.9: Conversation system
  conversation:
    title : "Talk to {pet_name}"
    current-state : "Current State: {emotion_display}"
    cooldown-active : "&cYou talked to your pet recently. Wait {time} seconds."
 
feedback:
  hunger:
    low : "&e{pet_name} is getting hungry!"
    critical : "&c{pet_name} is starving!"
 
# NEW in v1.9: Interaction responses
interactions:
  comfort:
    scared-success : "&aYou comfort {pet_name}. They feel safer now."
    not-needed : "&e{pet_name} doesn't need comfort right now."
  praise:
    success : "&aYou praise {pet_name}. They beam with pride!"
    cooldown : "&eYou recently praised {pet_name}. Give them time to process."
 
# NEW in v1.9: Species-specific responses
responses:
  wolf:
    happy : "*wags tail happily and pants contentedly*"
    scared : "*whines softly and moves closer to you*"
    hungry : "*looks at you hopefully with puppy eyes*"
  cat:
    happy : "*purrs contentedly and rubs against your legs*"
    scared : "*flattens ears and crouches low*"
    tired : "*yawns and stretches gracefully*"
  parrot:
    happy : "*sings melodiously and flaps wings excitedly*"
    curious : "*tilts head and chirps inquisitively*"
    content : "*preens feathers and chirps softly*"
AI Behavior System
Behavior Types
1. Follow Behavior
  • Description: Pet follows the player maintaining optimal distance
  • Triggers: Player movement, high affection
  • Configuration: follow-distance, follow-chance
2. Guard Behavior
  • Description: Pet protects player from hostile entities
  • Triggers: Nearby threats, high loyalty
  • Configuration: guard-range, guard-chance
3. Hunt Behavior
  • Description: Pet actively seeks and attacks prey
  • Triggers: Low hunger, high energy
  • Configuration: hunt-range, hunt-chance
4. Play Behavior
  • Description: Pet performs playful animations and interactions
  • Triggers: High happiness, medium energy
  • Configuration: play-chance, play-duration
5. Rest Behavior
  • Description: Pet finds safe spots to recover energy
  • Triggers: Low energy, high trust
  • Configuration: rest-chance, energy-recovery-rate
6. Attack Behavior
  • Description: Pet aggressively defends against threats
  • Triggers: High anger, player in danger
  • Configuration: attack-range, damage-multiplier
7. Flee Behavior
  • Description: Pet retreats from dangerous situations
  • Triggers: High fear, low health
  • Configuration: flee-distance, fear-threshold
8. Assist Behavior
  • Description: Pet helps player with various tasks
  • Triggers: High loyalty, player activity
  • Configuration: assist-range, assist-types
9. Scout Behavior
  • Description: Pet explores surroundings and reports findings
  • Triggers: High curiosity, new areas
  • Configuration: scout-range, report-interval
10. Patrol Behavior
  • Description: Pet guards a designated area systematically
  • Triggers: Guard mode, territorial instinct
  • Configuration: patrol-radius, patrol-speed
11. Search Food Behavior
  • Description: Pet looks for food when hungry
  • Triggers: High hunger, available food sources
  • Configuration: search-range, food-types
12. Alert Behavior
  • Description: Pet warns player of potential dangers
  • Triggers: Detected threats, high awareness
  • Configuration: alert-range, alert-types
Emotion System
The 8-stat emotion system drives all AI decisions:

Core Emotions
  • Hunger (0-100): Drives food-seeking behavior
  • Energy (0-100): Affects activity levels and rest needs
  • Affection (0-100): Influences loyalty and following
  • Happiness (0-100): Affects playfulness and general mood
Social Emotions
  • Trust (0-100): Determines willingness to follow commands
  • Loyalty (0-100): Influences protective behaviors
  • Fear (0-100): Triggers defensive and flee behaviors
  • Anger (0-100): Drives aggressive responses
Emotion Interactions
Code (YAML):
High Affection + High Trust = Strong Following Behavior
High Hunger + Low Energy = Food Search Priority
High Fear + Low Health = Immediate Flee Response
High Loyalty + Threat Detected = Guard/Attack Mode
API Integration
SmartPets API
Access plugin functionality programmatically:

Code (YAML):
// Get API instance
SmartPetsAPI api = SmartPets.getInstance ( ).getAPI ( );
// Get player's pets
List<Pet> pets = api.getPlayerPets (player.getUniqueId ( ) );
// Get active pet
Pet activePet = api.getActivePet (player.getUniqueId ( ) );
// Create new pet
Pet newPet = api.createPet (player.getUniqueId ( ), PetType.WOLF, "Buddy" );
// Trigger behavior
api.triggerBehavior (pet, BehaviorType.FOLLOW );
// Update emotions
api.updateEmotion (pet, EmotionType.AFFECTION, 10 );
Custom Events
Listen to SmartPets events:

Code (YAML):
@EventHandler [/B ]
[B ]public void onPetAdopt (PetAdoptEvent event ) { [/B ]
[B ]    Player player = event.getPlayer ( ); [/B ]
[B ]    Pet pet = event.getPet ( ); [/B ]
[B ]    // Handle pet adoption [/B ]
[B ] } [/B ]
[B ]@EventHandler [/B ]
[B ]public void onPetLevelUp (PetLevelUpEvent event ) { [/B ]
[B ]    Pet pet = event.getPet ( ); [/B ]
[B ]    int newLevel = event.getNewLevel ( ); [/B ]
[B ]    // Handle level progression [/B ]
[B ] } [/B ]
[B ]@EventHandler [/B ]
[B ]public void onPetEvolution (PetEvolutionEvent event ) { [/B ]
[B ]    Pet pet = event.getPet ( ); [/B ]
[B ]    PetEvolutionStage newStage = event.getNewStage ( ); [/B ]
[B ]    // Handle evolution [/B ]
[B ] }


PlaceholderAPI Integration
Use SmartPets placeholders in other plugins:

Code (YAML):
%smartpets_active_pet_name%           - Active pet name
%smartpets_active_pet_level%          - Active pet level
%smartpets_active_pet_type%           - Active pet type
%smartpets_active_pet_hunger%         - Hunger stat (0-100)
%smartpets_active_pet_energy%         - Energy stat (0-100)
%smartpets_active_pet_affection%      - Affection stat (0-100)
%smartpets_active_pet_happiness%      - Happiness stat (0-100)
%smartpets_active_pet_trust%          - Trust stat (0-100)
%smartpets_active_pet_loyalty%        - Loyalty stat (0-100)
%smartpets_active_pet_fear%           - Fear stat (0-100)
%smartpets_active_pet_anger%          - Anger stat (0-100)
%smartpets_pet_count%                 - Total owned pets
%smartpets_max_pets%                  - Maximum allowed pets
️ Database System
Storage Options
1. YAML Storage (Default)
  • Pros: No setup required, human-readable, easy backup
  • Cons: Slower for large datasets
  • Use Case: Small to medium servers (< 100 active players)
2. SQLite Storage
  • Pros: Fast, embedded, automatic driver download
  • Cons: Single-file limitation
  • Use Case: Medium servers, local development
3. MySQL Storage
  • Pros: High performance, scalable, remote access
  • Cons: Requires MySQL server
  • Use Case: Large servers, network setups
Automatic Driver Download
SmartPets automatically downloads database drivers from Maven Central:

Code (YAML):
SQLite : sqlite-jdbc-3.42.0.0.jar (8MB )
MySQL : mysql-connector-java-8.0.33.jar (2.4MB )
Features:
  • SHA-256 integrity verification
  • Graceful fallback to YAML if download fails
  • No manual intervention required
  • Cached for subsequent startups
Database Schema
Pets Table:

Code (YAML):
CREATE TABLE pets ( [/B ]
[B ]    id VARCHAR (36 ) PRIMARY KEY, [/B ]
[B ]    owner_uuid VARCHAR (36 ) NOT NULL, [/B ]
[B ]    name VARCHAR (32 ) NOT NULL, [/B ]
[B ]    type VARCHAR (32 ) NOT NULL, [/B ]
[B ]    level INTEGER DEFAULT 1, [/B ]
[B ]    experience INTEGER DEFAULT 0, [/B ]
[B ]    hunger INTEGER DEFAULT 100, [/B ]
[B ]    energy INTEGER DEFAULT 100, [/B ]
[B ]    affection INTEGER DEFAULT 50, [/B ]
[B ]    happiness INTEGER DEFAULT 50, [/B ]
[B ]    trust INTEGER DEFAULT 50, [/B ]
[B ]    loyalty INTEGER DEFAULT 50, [/B ]
[B ]    fear INTEGER DEFAULT 0, [/B ]
[B ]    anger INTEGER DEFAULT 0, [/B ]
[B ]    created_at BIGINT NOT NULL, [/B ]
[B ]    last_interaction BIGINT NOT NULL [/B ]
[B ] );



Server Compatibility
Full Compatibility Matrix
Server Type Version Support AI Behaviors Schedulers Performance Notes
Paper 1.16.5-1.21.8 ✅ Full ✅ Standard ⭐⭐⭐⭐⭐ Recommended
Spigot 1.16.5-1.21.8 ✅ Full ✅ Standard ⭐⭐⭐⭐ Fully supported
Purpur 1.16.5-1.21.8 ✅ Full ✅ Standard ⭐⭐⭐⭐⭐ Enhanced features
Folia 1.19.4+ ✅ Full ✅ Multi-threaded ⭐⭐⭐⭐⭐ Optimized threading
Luminol 1.21.8 ⚠️ Limited ❌ None ⭐⭐⭐ Basic functionality

Folia Optimization
SmartPets is specifically optimized for Folia's multi-threaded architecture:
  • Global Region Scheduler: For plugin-wide tasks
  • Async Scheduler: For background operations
  • Entity Scheduler: For pet-specific behaviors (when available)
  • Region Scheduler: For location-based tasks (when available)
Luminol Limitations
Luminol is a specialized Folia variant that doesn't support schedulers:

Available Features:
  • ✅ All commands and menus
  • ✅ Manual pet interactions
  • ✅ Experience and leveling
  • ✅ Pet spawning/despawning
  • ✅ Data storage
  • ✅ GUIs and configuration
Disabled Features:
  • ❌ Automatic emotion decay
  • ❌ AI behavior execution
  • ❌ Periodic feedback messages
  • ❌ Background task automation
Note: In Luminol, pets function as interactive companions that respond to direct player commands but don't exhibit autonomous behaviors.

Troubleshooting
Common Issues
Plugin Won't Load

Code (Text):
Error: "plugin is disabled"
Solutions:
  1. Ensure Vault is installed
  2. Check Java version (17+ required)
  3. Verify server compatibility
  4. Check console for dependency errors
Database Connection Failed

Code (Text):
Error: "Failed to connect to database"
Solutions:
  1. Verify database credentials in config.yml
  2. Ensure database server is running
  3. Check firewall/network connectivity
  4. Plugin will fallback to YAML automatically
Pets Not Spawning

Code (Text):
Error: "Could not spawn pet entity"
Solutions:
  1. Check pet type is enabled in config
  2. Verify world allows entity spawning
  3. Ensure sufficient space around player
  4. Check for conflicting plugins
No AI Behaviors
Code (YAML):
Pets appear but don't move or act
Solutions:
  1. Check if you're on Luminol (expected behavior)
  2. Verify behavior settings in config.yml
  3. Ensure pets have sufficient energy/emotions
  4. Check debug logs for scheduler errors
Debug Information
Use /petadmin debug to get comprehensive system information:

Code (YAML):
=== SmartPets System Information ===
Version : 1.4.2
Storage Type : YAML
Storage Status : Ready
Scheduler : Folia Multi-Threaded Scheduler
=== Memory Usage ===
Used Memory : 145.2 MB
Free Memory : 78.8 MB
Total Memory : 224.0 MB
Max Memory : 2.0 GB
=== Active Pets ===
Active pets count : 5
Performance Optimization
For Large Servers

Code (YAML):
# Reduce AI frequency[/B][/B]
[B ] [B ] [/B ]
[B]behavior-task-interval : 15         # Increase from 10[/B]
[B]emotion-task-interval : 120         # Increase from 60[/B]
[B ] # Limit concurrent behaviors[/B]
[B]max-active-behaviors : 50 [/B ]
[B ] # Optimize database[/B]
[B]storage-type : "MYSQL"             # Use MySQL for better performance


For Low-Memory Servers
Code (YAML):
# Reduce cached data
max-cached-pets : 100
# Disable optional features
holograms-enabled : false
feedback.enabled : false
Performance & Monitoring
Metrics Integration
SmartPets integrates with bStats for anonymous usage statistics:

  • Server software distribution
  • Plugin version adoption
  • Feature usage patterns
  • Performance metrics
To disable: Set metrics: false in config.yml

Resource Usage
Typical Resource Consumption (v1.9):

  • RAM: 60-250MB depending on active pets (slight increase due to conversation system)
  • CPU: < 5% with default settings (optimized conversation processing)
  • Storage: 1-10MB per 1000 pets (YAML), additional conversation data
  • Network: Minimal (database queries + enhanced ActionBar communications)
Updates & Migration
Version Migration
SmartPets automatically handles data migration between versions:

  • Configuration: Adds new options, preserves existing settings
  • Database: Applies schema updates automatically
  • Pet Data: Converts old formats to new structure
  • Backup: Creates automatic backups before major updates
Update Process
  1. Backup your server (always recommended)
  2. Download latest SmartPets version
  3. Replace old JAR file
  4. Restart server
  5. Check console for migration messages
  6. Verify functionality with /petadmin debug
Support & Community
Getting Help
  1. Wiki: Comprehensive documentation and guides
  2. Issues: Report bugs and request features on GitHub
  3. Discord: Join the community for real-time support
  4. Discussions: Share ideas and configurations
Contributing
SmartPets v1.9 welcomes contributions:

  • Bug Reports: Detailed issue descriptions with /petadmin debug output
  • Feature Requests: Well-explained enhancement proposals for v2.0+
  • Interaction Ideas: Suggest new conversation options or interaction types
  • Translation Help: Assist with the expanded lang.yml system (50+ new keys in v1.9)
  • Code Contributions: Follow project coding standards, especially for conversation system
  • Documentation: Help improve guides and examples, particularly for v1.9 features
Links
License
SmartPets is released under the MIT License. See LICENSE file for details.

⚡ Quick Start Guide
Basic Setup (5 minutes)
  1. Install Vault plugin
  2. Add SmartPets JAR to plugins folder
  3. Start server (drivers download automatically)
  4. Configure basic settings in config.yml
  5. Test with /pet shop to adopt your first pet
Essential Commands (Enhanced in v1.9)
Code (YAML):
# Core commands
/pet                     # Open main menu
/pet shop               # Adopt a pet
/pet list               # View your pets
/pet stats             # Check detailed pet statistics (NEW in v1.9)
# NEW v1.9 Communication commands
/pet talk               # Start conversation with your pet
/pet basics             # Quick pet care guide
/pet interaction       # Learn about smart interactions
# Admin commands
/petadmin debug         # Enhanced system information
/petadmin debug fear   # Analyze fear system (NEW in v1.9)
/petadmin debug behavior # Behavior engine diagnostics (NEW in v1.9)

First Pet Setup (v1.9 Enhanced Experience)
  1. Run /pet shop
  2. Choose a pet type (Wolf recommended for beginners)
  3. Confirm adoption
  4. NEW: Use /pet stats to see detailed emotional state
  5. NEW: Try /pet talk for your first conversation!
  6. NEW: Right-click your pet for smart contextual interactions
  7. NEW: Use /pet basics to learn essential care tips
  8. ENHANCED: Build affection through meaningful interactions
Congratulations! You now have a fully functional AI pet system. Your pets will automatically:

  • Follow you around
  • Protect you from threats
  • Gain experience and level up
  • Develop emotional bonds
  • React to your interactions
For advanced configuration and AI behavior customization, refer to the detailed sections above.

SmartPets v1.9 - Bringing intelligent companions to your Minecraft world
View on SpigotMC
Resource Information
Author:
----------
Total Downloads: 15
First Release: Jun 5, 2025
Last Update: Sep 10, 2025
Category: ---------------
All-Time Rating:
1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings