Notifications
Notification preferences
notifications_off

No unread notifications right now

You're up to date
View All

You're up to date

File information

Last updated

Original upload

Created by

slO

Uploaded by

slpOff

Virus scan

Safe to use

Tags for this mod

Tag this mod
Current section

About this mod

Modify NPC schedules in-game with ease! View, edit, and customize NPC routines in real-time. Adjust schedules based on seasons, dates, and friendship conditions. Perfect for players and modders, with automatic **schedules.json** generation for Content Patcher. Take full control of NPC movements and interactions in Stardew Valley!

Requirements
Permissions and credits
Changelogs
🎮 NPC Scheduler - README

📖 1. Introduction

This mod allows players to modify NPC schedules directly in-game.
✏️Players can make real-time adjustments to NPC schedules and immediately see the changes applied.
🔄For Content Patcher modders, modifying a schedule will automatically generate a `schedules.json` file 📁 in your mod folder.

🕹️ 2. How to Use the Mod

🔹 Accessing the Schedule Page

  • Open an NPC’s friendship page—you will see a new 📅 Schedule button.
  • Clicking this button will open the Schedule Page.

🔹 Exploring the Schedule Page

  • Below the title, there are 📆 season and date selection buttons along with a slider.
  • This allows you to view NPC schedules by date.
  • Festival-specific schedules are not yet fully supported 🎭 but will be added in a future update.

🔹Understanding Schedule Priority

  • NPC schedules are listed in order of priority for the selected day. 🏆
  • If some schedules are missing or not appearing correctly, please report it 🛠️—we will fix it!

🔹 Editing Schedules

  • Click on a specific 📝 schedule entry to enter edit mode.
  • Modify the schedule as needed.
  • Scroll down slightly and press the ✅ OK button to apply the changes to the NPC instantly.
    • (Note: This feature has not been fully tested yet.)
  • Once a schedule is edited, its schedule key (title) will appear in 🔵 blue.

🔹 Switching Between Edited & Default Schedules

  • By default, both the edited and original schedules will be displayed together.
  • Click the ❓ (question mark) button in the top-right corner to toggle between:
    • Edited schedules only ✏️
    • Original (default) schedules only 📜

🚀 3. Update Overview
🔹 v0.0.4 Summary

  • 🛠️ GMCM dependency added for better config management.
  • 🎯 Shortcut key (F12) to open NPC schedule page directly.
  • 📌 Schedule application options (Immediate, Daystarted, Notapply) introduced.
  • 🛤️ Pathfinding improvements to help NPCs navigate better.

🔹 v0.0.3 Summary

  • 📝 Tooltips and translation support added.
  • ⚙️ Config.json expanded to allow different schedule application modes.
  • ❤️ Friendship & 📧 Mail List system added to adjust schedules based on player conditions.
  • 🔄 GOTO functionality introduced to redirect schedules dynamically.

🏗️ 4. Features Added in Updates

🔹 ⚙️ Configurable Schedule Application

  • Schedule application modes:
    • ⏳ Immediate: Changes are applied instantly upon closing the menu.
    • 🌅 Daystarted: Automatically applies schedules at the start of each day (Recommended default setting).
    • 🚫 Notapply: No schedules are applied, useful for editing only.

  • Schedule selection:
    • 📝 All: Applies all schedules.
    • 🔍 Selected: Applies only specific schedules.
    • ✅ Schedule Key List: If Selected is chosen, only the checked schedule keys will be applied.

🔹 🛤️ Pathfinding Enhancements

  • NPCs now use pathfind to locate destinations, reducing navigation issues.
  • Works smoothly when Immediate Application is enabled, but any bugs should be reported.

🔹 📝 Tooltip and 🌍 Translation Support

  • Tooltips have been progressively added to the UI.
  • A 🗣️ translation file is now available for localization. Users can request additional languages.

🔹 ❤️ Friendship & 📧 Mail List System

  • Friendship List: Defines heart conditions required for specific schedules.
  • Mail List: Determines schedules based on whether the player has received certain letters.
  • If a letter has not been received, NPCs can follow a fallback schedule via 🔄 GOTO.
🔹 🔄 GOTO Schedule Command

  • Allows schedules to redirect to another schedule key.
  • Format: GOTO {ScheduleKey}
  • If all schedule entries are removed and a GOTO key exists, it will load the referenced schedule.

🔹 🔧 Compatibility with Other Mods

  • No known conflicts unless another mod dynamically alters NPC schedules.
  • 📜 Content Patcher schedules load at game startup, ensuring compatibility.

🛠️ 5. Known Issues
  • ⚠️ UI may not render correctly initially, requiring multiple clicks to display properly.
    • Temporary Fix: Switch dates or click a schedule entry to refresh the UI.