Overview
Buddy adds a personal Allay companion for each player. The buddy is not just a cosmetic pet: it follows its owner, reacts to danger, protects the player, can rescue them, deliver items, gain experience, use skills and talents, show moods, learn from player behavior and be controlled through an in-game GUI.

Main Features
- One personal buddy per player
- Custom Buddy Egg with crafting recipe
- Full in-game control GUI
- Smooth follow system with safe teleporting
- World-change support
- Park and home system
- Buddy chest and separate food chest
- Item delivery to online players
- Buddy Ball fetch system
- Buddy Feather for petting and shoulder mode
- Other players can pet and feed/heal buddies without controlling them
- Protection system against attackers
- Proactive danger detection
- Projectile, creeper, TNT and environmental danger reactions
- Fall-catch rescue
- Auto-heal for the owner
- Buddy self-heal with food
- Emergency home behavior when badly hurt
- Energy, mood and needs system
- Level, rank, skill and talent progression
- Buddy types and traits
- Personality and memory behavior
- Buddy-to-buddy play sessions
- Idle, pet, play and shoulder animations
- Owner-only emote bubbles
- Optional TextDisplay labels and buddy light
- German and English messages
- In-game guidebook
- Admin debug command
- Configurable performance tick budget
- Persistent data saving

Commands
/buddy gui - Opens the buddy control menu.
/buddy egg [player] - Gives a Buddy Egg.
/buddy list [player] [page] - Lists buddies, optionally filtered by player.
/buddy remove <player> - Removes a player's buddies.
/buddy reload - Reloads configuration and messages.
/buddy debug [player] - Shows detailed debug information.

Permissions
- buddy.admin
- buddy.user.gui
- buddy.user.hatch
- buddy.user.call
- buddy.user.park
- buddy.user.home
- buddy.user.chest
- buddy.user.heal
- buddy.user.protect
- buddy.user.fallcatch
- buddy.user.autoheal
- buddy.user.ball
- buddy.user.feather
- buddy.user.send
- buddy.user.light
- buddy.user.skills
- buddy.user.talents
- buddy.user.stats

Social Interactions
Players can interact socially with buddies owned by other players. They can pet them with the Buddy Feather and feed/heal them with food if they have permission. Owner-only features remain protected: other players cannot open another buddy's chest, control GUI or shoulder mode.

Owner-only Bubbles
Buddy emote bubbles are only shown to the owner. A bubble stays active until the owner has actually looked at it, then remains visible for about five seconds. No extra chat or actionbar message is sent.

Progression
Buddies can level up, gain ranks, receive skill points, unlock talents, gain traits and improve their stats. Available stats include HP, attack, defense, intelligence and speed.

Storage and Delivery
Each buddy can have a private storage chest and a separate food chest. Buddies can also deliver items to other online players through a player selection GUI. Failed deliveries safely return or drop items.

Guidebook
The plugin includes an optional written guidebook explaining commands, GUI actions, healing, protection, fall rescue, item delivery, skills, talents and useful tips.

Configuration
Many systems are configurable, including language, GUI slots, follow behavior, health, speed, energy, protection, fall rescue, auto-heal, item delivery, light, labels, emotes, progression, types, traits, talents and performance settings.

Installation
1. Put the plugin jar into your server's plugins folder.
2. Restart the server.
3. Adjust config.yml and messages if needed.
4. Use /buddy egg or the crafting recipe to get started.

Languages
English and German are included.