ED5 Pets Plugin

🐾 ED5_Pets Plugin Documentation

📘 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