📘 Overview

The ED5_Pets plugin adds a complete pet system to RPG Maker MZ, including:

• 🥚 Egg hatching mechanics
• 🎯 Pet capturing with balls
• 📦 Pet inventory and bank system
• 🍗 Hunger system
• 💖 Loyalty system
• 📣 Pet summoning and despawning
• 🌱 Evolution system
• 📈 Stat growth and leveling

⚙️ Installation

• Place the plugin file in your js/plugins folder
• Enable it in the Plugin Manager
• Create a map with the ID set in the PetMapId parameter (default is 1)

🧰 Basic Setup

🐾 1. Pet Template Map

Create pet templates on a map (ID = 1 by default). Each event = one pet type.

🌿 2. Creating Pets

There are two ways to add pets:

A. Wild Pets

Place events and add these tags:

<pet: 1>
<petsMHP: 50>
<petsATK: 10>
<Loyalty: 30>
<hunger: 80>
<hungerRate: 0.5>
<ballWeakness: 75>
<petLv: 5>

B. Eggs

Create an item and add:

<egg: 1>
<hatch: 500>
<petsMHP: 40>
<petsATK: 8>
<Loyalty: 50>
<hunger: 100>

⚽ 3. Pet Balls

Tag pet balls in the database with:

<petBall: 75>
<ballRange: 2>
<ballSprite: SuperBall>
<successAni: 51>
<failedAni: 52>

🎒 Player Inventory

Defaults to 6 pets. Can be expanded via:

• 🎭 <petInventory: x> in actor notebox
• 🛡️ <expandPetInventory: x> in equipment

🔁 Evolution System

Tag evolving pets or eggs with:

<evolveLv: 15,30>
<evolveEID: 2,3>
<evolveMHP: 10,20>
<evolveRaiseATK: 5,10>

💻 Plugin Commands

• ED5_Pets openBank - 🏦 Open pet bank
• ED5_Pets summonPet x - 🐶 Summon pet
• ED5_Pets recallPet - 👋 Recall pet
• ED5_Pets gainExp x y - 🧪 Add EXP
• ED5_Pets changeLoyalty x y - 💖 Change loyalty

📜 Script Calls

• $gameSystem.pets().addPet(petData) - ➕ Add a pet
• $gameSystem.pets().summonPet(petId) - 🐾 Summon pet
• $gameSystem.pets().recallPet() - 🚫 Recall pet
• $gameSystem.pets().gainExp(pet, amount) - 📈 Gain EXP

🍗 Hunger System

• Hunger decreases over time (default 1 per min)
• 0 hunger = -10 loyalty
• 🐕 Pet is recalled if hunger = 0

💖 Loyalty System

• Ranges 0–100
• Decreases with hunger
• Affects future pet behavior

🏦 Bank System

• Stores up to 1000 pets
• Access via plugin command or custom menu

📣 Summoning Mechanics

• One pet out at a time
• Appears as an event
• Use event pages for interaction

🛠️ Tips & Troubleshooting

🧩 Common Issues

• Pets not appearing? Check template map ID and pet event IDs
• Capture not working? Verify <petBall> tag and range
• Glitches? Check sprite sizes, animation IDs, and plugin conflicts

🐶 Single Pet Only

• 1️⃣ Players can only have one pet at a time
• 🚫 Must release current pet before getting a new one

⚙️ Core Systems Retained

• 🥚 Egg hatching
• ⚽ Pet capturing
• 🍗 Hunger system
• 💖 Loyalty system
• 🌱 Evolution system
• 📣 Summoning and recalling

🗑️ Removed Features

• 🏦 No pet bank system
• 🎒 No pet inventory (only one pet)
• 🔄 No pet swapping or rearranging
• 🧾 Simplified UI

🧪 Simplified Commands

Only the most essential commands are retained with simplified usage:

• summonPet – 🐕 No parameters needed
• recallPet – 👋 No parameters needed
• changeLoyalty – 💖 Just the amount
• changeHunger – 🍗 Just the amount

❗ Usage Differences

🏦 No Bank System

• 🚫 Players can’t store pets
• 🔁 Must release pet to get another

🔖 Simplified Tags

• ✅ Use the same tags for pets/eggs as the full version
• 🧼 No need for inventory size tags

🖼️ Basic UI

• 📋 No pet menu scene
• 🕹️ All interactions via plugin commands

✅ Why Use the Lite Version?

This version maintains all core pet functionality while being much simpler to implement and manage. Perfect for developers who want pets without the extra management systems.