🌙 Advanced NPC Routine Plugin for RPG Maker MZ

Smart, scalable NPC pathfinding with daily routines.

---

🎯 Overview

Breathe life into your RPG towns with fully autonomous NPCs that move, rest, vanish at night, and follow realistic schedules — all powered by A* pathfinding, route caching, and a variable-based time system.

This plugin is designed for scale, supporting:

• ✅ Unlimited NPCs
• ✅ Unlimited routine locations per NPC
• ✅ Smart route caching for performance
• ✅ Full compatibility with most time systems
• ✅ Lightweight logic that performs smoothly — even across large maps and cast sizes

Whether you're making a cosy town sim, a sprawling open world, or an immersive village hub, this plugin lets your NPCs feel real.

---

🧠 Key Features

• 🧍‍♂️ Unlimited NPC Support – Add as many NPCs as you want, each with their own routine.
• 📍 Unlimited Routine Locations – Define multiple destinations per NPC to keep them varied and alive.
• 🧭 Smart A* Pathfinding – NPCs follow paths via roads you define using Region IDs.
• 💾 Route Caching – NPCs automatically remember routes after their first trip for better performance.
• ⏱️ Wake, Lunch & Bed Scheduling – Fine-tune when NPCs appear, move, rest, and disappear.
• 🍺 Tavern Logic – Optional feature that sends NPCs to a tavern at night instead of home.
• 🌒 Automatic Vanishing at Night – NPCs fade away when their routine ends for the day.
• 🗨️ Interaction-Aware – NPCs pause if the player talks to them and resume naturally.
• 🔄 Auto Resume After Saving or Menus – Routines continue seamlessly across scenes.

---

🛠️ Easy Setup

1. Assign walkable roads using Region ID.
2. Place your NPC and any number of blank routine events on the map.
3. Use a simple plugin command to define their home, schedule, and routine points.
4. Done — NPCs will now move dynamically through your world based on time.

---

📦 Includes Bonus Plugin: SimpleTimeMZ

No time system yet? We’ve got you covered.
Bundled with this plugin is SimpleTimeMZ – a lightweight, variable-based system that handles:

• Minutes, Hours, Days
• Time progression at your chosen speed
• Full compatibility with this plugin

Or plug in any variable-based time plugin you already use!

---

🧾 Requirements

• RPG Maker MZ
• A variable representing the current in-game hour

---

💡 Ideal For:

• Life sims & farming games
• Town hubs with active NPCs
• Open world RPGs
• Games that run on immersive world logic

---

📁 What’s Included:

• Advanced_NPC_Routine.js
• SimpleTimeMZ.js
• Full Setup Documentation (TXT file + Plugin Help Header)

---

⚙️ Technical Notes:

• All NPCs cache their paths after first use to drastically reduce performance cost.
• Use “Erase Event” after setup so routines reapply each time the map loads.
• Region ID-based pathing keeps NPCs moving naturally.
• Handles menus and scene transitions seamlessly.

---

📜 Licensing

By purchasing the Advanced NPC Routine Plugin, you are granted the following rights:

✅ You May:

• Use this plugin in personal and commercial RPG Maker MZ projects.
• Include the plugin in free or paid games.
• Modify the plugin code for use within your own project.
• Bundle the plugin with your deployed game (as part of the build).

❌ You May Not:

• Redistribute, resell, or share the plugin on its own.
• Include the plugin in asset packs, toolkits, or templates for resale.
• Claim the plugin as your own original work.

---

💡 A separate license is not required for each game — one purchase covers all your RPG Maker MZ projects.

If you're working as a team or studio, a single purchase covers your team as long as it's being used on shared projects.