DG Pets | Ultimate Pets Plugin v1.1.0

DGpets is not just another pets plugin - it's a complete companion system. Your players can collect 17 unique pet types, carry items in their pet's inventory, upgrade stats, ride them, feed them, toggle baby mode, and watch them fight alongside them in combat. Every feature is fully configurable, permission-based, and designed for production servers.


⚔ Smart Combat AI

Your pets aren't just cosmetic - they fight for you!

• Defend Owner - When a mob or player attacks you, your pet automatically retaliates and fights until the enemy is dead
• Assist Owner - When YOU attack something, your pet joins the fight alongside you
• Hostile Detection - Pets proactively detect and engage hostile mobs within a configurable radius
• Unique Damage Per Type - A Chicken deals 1.0 damage, a Wolf deals 5.0, an Iron Golem deals 12.0 - each pet is balanced differently
• Persistent Combat - Pets chase and attack targets until they die, with configurable attack cooldowns and leash range
• Hunger Integration - Starving pets refuse to fight, adding strategic depth to pet management

Pet Inventory System

Every pet carries its own inventory - like a mobile chest that follows you!

• 5 Upgrade Tiers - Start with 9 slots, upgrade up to 45 slots
• Fully Functional - Drag and drop items just like a regular chest
• Persistent Storage - Items are saved across server restarts and pet despawns
• Configurable Costs - Set upgrade prices per tier in config
• Beautiful GUI - Locked slots shown as grey glass, tier stars in title

⬆ Stat Upgrade System

Players can progressively upgrade their pet's stats in a dedicated Upgrades GUI.

• ⚔ Damage Upgrades - 10 levels, +1.5 damage per level
• ❤ Health Upgrades - 10 levels, +5.0 HP per level
• ◈ Inventory Upgrades - 5 tiers of storage
• Visual Progress Bars - ■■■■■□□□□□ shown in GUI and lore
• Configurable Costs - Base cost + per-level scaling formula
• Vault Integration - Uses your server's economy

Hunger System

Pets need to eat! This adds a whole new layer of engagement.

• 20-Point Hunger Bar - Visual hunger display in the pet menu (green → yellow → red)
• Natural Decay - Pets lose 1 hunger every 5 minutes (configurable)
• 30+ Food Items - Every Minecraft food restores different amounts (fully configurable)
• Easy Feeding - Just right-click your pet while holding food
• Starvation Effects - Hungry pets stop fighting; optionally auto-despawn at 0 hunger
• Warning Messages - Players get notified when their pet is getting hungry
• Heart Particles - Feeding shows heart particles and eating sounds

Baby Mode

Toggle your pet between baby and adult form with one click!

• One-Click Toggle - Button in the pet menu switches between baby and adult
• Smart Detection - Only shows for pets that have baby forms (not Iron Golem, Allay)
• Persistent - Baby/adult state saves across restarts
• Age Locked - Baby pets stay baby, adult pets stay adult - no random changes

Ride Your Pet

Mount your pet and ride it around the world!

• Sneak + Right-Click - Quick mount directly on the pet
• GUI Button - Or mount from the pet menu
• Directional Control - Pet moves where you look
• Per-Pet Configuration - Set which pets are rideable (large pets only - Cow, Wolf, Iron Golem, Polar Bear, etc.)
• Speed Based on Stats - Faster pets = faster rides, with configurable speed multiplier
• Shift to Dismount - Natural dismount with message

Death Cooldown

When your pet dies, it needs time to recover before respawning.

• 5-Minute Cooldown - Configurable respawn timer after death
• Visual Timer -Pet list shows a clock icon with remaining time: 3m 24s
• Blocked Spawning - Can't spawn a pet on cooldown - clear message with time remaining
• Optional Hunger Reset - Configurable: reset hunger to full on death
• No Item Loss - Pet inventory is preserved (or dropped on death - configurable)

Beautiful Pet Shop

A fully-featured GUI shop where players browse and purchase pets.

• 17 Pet Types - From $100 Chicken to $5000 Iron Golem
• Permission-Locked Pets - Locked pets show as grey with "✗ Locked" - perfect for ranks/crates
• Already Owned Indicator - Glowing items for pets the player already owns
• Player Balance Display - Shows current balance in the shop
• Vault Economy - Works with any Vault-compatible economy plugin

All values (damage, health, speed, price) are fully configurable in config.yml


Commands


Permissions


Per-pet permissions are fully configurable in config.yml - perfect for rank-based unlocking!


DGpets has a 5-layer protection system ensuring pets NEVER harm their owner:

1. Target Prevention - Pets can never target their owner (EntityTargetEvent blocked at HIGHEST priority)
2. Damage Blocking - All damage from pet to owner is cancelled (direct, projectile, area)
3. Effect Blocking - Status effects from hostile pet types are blocked (Warden darkness, Bee poison)
4. Anger Reset - Continuous anger reset every 0.5s for hostile-type pets
5. Entity Safety - Pets can't be leashed, bred, put in boats, or pick up items

Everything is configurable in a clean, well-documented config.yml (480+ lines):

• Pet stats, prices, permissions, icons, and descriptions
• Combat settings (defend, assist, hostile detection, cooldowns)
• Hunger system (decay rate, food values, thresholds)
• Death cooldown duration
• Riding settings and speed multiplier
• Inventory tier sizes and upgrade costs
• Stat upgrade costs (base + per-level formula)
• Particle effects (type, interval)
• All messages with color codes
• Follow/teleport distances
• Auto-save interval

• Server: Paper 1.21.x (recommended) or Spigot 1.21.x
• Java: 21+
• Optional: Vault + Economy plugin (EssentialsX, CMI, etc.) for shop & upgrades

1. Download DGpets-1.0.0.jar
2. Drop it in your server's plugins/ folder
3. (Optional) Install Vault + economy plugin for shop features
4. Restart your server
5. Edit plugins/DGpets/config.yml to customize
6. Done! Use /pets to get started