NPC scheduler

Easily modify NPC schedules in the game! View, edit and customize NPC daily activities in real time. Adjust your schedule to the season, day, and friendship conditions. Suitable for players and modders, automatically generates **schedules.json** file for Content Patcher. Fully control the movement and interaction of NPCs in Stardew Valley!

NPC scheduler

🎮Module introduction

This mod allows players to **modify NPC schedules directly in the game** ✨

✏️ Players can make **real-time adjustments** to NPC schedules and see the changes take effect immediately.

📁 For Content Patcher modders, modifying the schedule will automatically generate a `schedules.json` file in your mod folder 📄

🎯 How to use

📱 Visit the schedule page

• Open the NPC's favorability page - you will see a new **📅 Schedule** button

*Clicking this button will open the **Schedule Page**

🔍 Explore the schedule page

*Below the title there are **🌷 season and date selection buttons** and a slider

• This allows you to view the **NPC schedule** by date
• **Festival Specific Schedule** is not fully supported yet ❌ but will be added in a future update

🎯 Understand schedule priorities

• NPC schedules are listed in **priority order** for the selected date 📊
• If some schedules are missing or display incorrectly, please **Report a Problem** 🐛 - we'll fix it!

✏️ Edit schedule

• Click on a specific **📝 schedule entry** to enter **Edit Mode**
• Modify schedule as needed
• Scroll down slightly and press the **✅ OK button** to apply changes to NPCs immediately
• *Note: This feature has not been fully tested*
• Once a schedule is edited, its **schedule key (title) will appear 🔵 blue**

🔄 Switch between editing and default schedule

• By default, **edited and original schedules** will be displayed together
• Click the ❓ (**question mark**) button in the upper right corner to switch between the following options:
• **Only show edited schedule** ✏️
• **Only show original (default) schedule** 📋

---

📋 Update Overview

v0.0.4 update content

• **🛠️ Add GMCM dependency** to improve configuration management
• **⌨️ Add shortcut key (F12) to directly open the NPC schedule page**
• **⚙️ Introducing schedule application options** (Apply immediately, apply at the beginning of each day, do not apply)
• **🗺️ Pathfinding improvements** help NPCs navigate better

v0.0.3 update content

• **💡 Added tooltips and translation support**
• **⚙️ Extended Config.json** to allow different schedule application modes
• **❤️ Add friendship and 📧 mailing list system ** adjust schedule according to player conditions
• **➡️ Introducing GOTO function** dynamic redirection schedule

---

🚀 Update function

⚙️ Configurable schedule application

**Schedule application mode:**

• **⏱️Apply Now**: Apply changes immediately when closing the menu
• **🌅 Apply at the beginning of each day**: Automatically apply the schedule at the beginning of each day (recommended default setting)
• **🚫 Do not apply **: Do not apply any schedule, only for editing

**Schedule selection:**

• **📋 ALL**: Apply all schedules
• **🎯 Selected**: Only apply specific schedules
• **✅ Schedule Key List**: If **Selected** is selected, only the checked schedule keys will be applied

🗺️ Path finding enhancement

• NPCs now use **Pathfinding** to locate destinations, reducing navigation issues
• Runs smoothly when **Apply Now** is enabled, but please report any bugs found

💡 Tooltips and 🌐 Translation support

• Step by step adding tooltips to the UI
• Now providing **🔄 translation files** for localization. Users can request additional languages

❤️ Friendship and 📧 Mailing List System

• **Friendship List**: Define the favorability conditions required for a specific schedule
• **Mail List**: Determine schedule based on whether players receive specific letters
• If the letter **is not** received, the NPC can follow the alternate schedule via **➡️ GOTO**

➡️ GOTO schedu …