🐙 Ghastling - Baby Ghast Pet Plugin

Transform adorable Ghastlings into your loyal flying companions!

---

✨ Overview

Ghastling is a survival-friendly plugin for Paper 1.21.6+ that lets players keep Baby Happy Ghasts (Ghastlings) as permanent pets. Prevent them from growing up, improve their AI, and build a bond through snowball interactions!
Perfect for survival servers that want to add cute, functional flying pets without breaking game balance.

---

🎯 Key Features

🔒 Permanent Baby Mode

Keep your Ghastling adorable forever! Craft the Eternal Youth Charm and use it on any baby ghast to permanently prevent growth. Changed your mind? Use Growth Essence to let them mature naturally.

🐾 Smart Pet System

• Ownership - First player to interact becomes the owner
• Sit/Follow - Toggle with Shift+Right-Click (empty hand)
• Persistence - All data survives server restarts

🤖 Enhanced AI

Unlike vanilla ghasts, your pet will:

• Follow you at a comfortable distance
• Hover naturally above you while flying
• Teleport to you if left too far behind
• Roam freely when you're standing still

❄️ Snowball Bonding

• Hold snowballs to attract your ghastling
• Throw snowballs to heal your pet
• Build affection with each snowball fed
• Watch cute particle effects!

✨ Beautiful Effects

• 💜 Purple enchant particles when locking growth
• 🔥 Flame particles when unlocking growth
• ❤️ Heart particles for ownership & affection
• ❄️ Snowflake particles when feeding
• 🌀 Portal particles on teleport

---

📦 Crafting Recipes

Both recipes automatically unlock in players' recipe books!

Eternal Youth Charm

Keeps your ghastling young forever

Growth Essence

Allows your ghastling to grow up

---

💻 Commands

Command	Description
/ghastling lock <radius>	Lock growth for nearby ghastlings
/ghastling unlock <radius>	Unlock growth for nearby ghastlings
/ghastling lockall <player>	Lock all ghastlings owned by player
/ghastling unlockall <player>	Unlock all ghastlings owned by player
/ghastling reload	Reload configuration
Aliases: /gl, /ghast

---

🔐 Permissions

Permission	Default	Description
ghastling.use	✅ Everyone	Use charm/essence on ghastlings
ghastling.admin	⭐ OP	Use admin commands
ghastling.reload	⭐ OP	Reload configuration
ghastling.bypass	⭐ OP	Modify any ghastling (bypass ownership)

---

⚙️ Configuration

Fully configurable! Adjust in plugins/Ghastling/config.yml:

# AI Movement
movement:
  follow-speed-multiplier: 1.5  # How fast they follow
  teleport-distance: 40         # When to teleport
  minimum-distance: 5.0         # Personal space
  maximum-distance: 15.0        # Max follow range
  roam-radius: 4.0              # Free roam area
# Snowball System
snowball:
  attraction-enabled: true
  healing-enabled: true
  heal-amount: 2.0              # Hearts restored
  affection-enabled: true
  affection-per-snowball: 5
  max-affection: 100
# Particles & Effects
particles:
  enabled: true
  lock-effect: true
  unlock-effect: true
  feed-effect: true
  teleport-effect: true

---

📥 Installation

1. Download Ghastling-1.0.0.jar
2. Place in your plugins/ folder
3. Restart your server
4. Configure in plugins/Ghastling/config.yml (optional)
   Requirements:

• 📋 Paper 1.21.6 or higher
• ☕ Java 21+

---

🎮 How to Get a Ghastling

1. Find a Dried Ghast block in Nether Fossil structures (Soul Sand Valley)
2. Place it and keep it waterlogged for ~20 minutes
3. A Ghastling will hatch! 🐣
4. Right-click to claim ownership
5. Use an Eternal Youth Charm to keep it forever young!

---

💬 Support

Having issues or suggestions? Feel free to:

• Leave a comment on this page
• Report bugs in the discussion section

---

❤️ Credits

ItzTha