Custom NPC Exclusions
⚪ Last updated 2024⚠️ Install Order · 2 steps
Install in this order, then this mod last — most mods fail to load without their framework and dependencies in place.
Preview
🔍 Analysis
- 👍 2.6% endorsement rate — high engagement, a strong quality signal
- 🏆 #14 of 119 Modding Tools mods in this game by downloads
📋 About This Mod
Custom NPC Exclusions allows other mods to exclude NPCs from certain quests and events, especially those that randomly select NPCs. This can be useful for story or compatibility reasons, e.g. to prevent custom NPCs outside Pelican Town posting delivery quests, saying they purchased items from the local stores, etc.
Installation
1. Install the latest version of SMAPI.
2. Download Custom NPC Exclusions from the Files tab, the Releases page on GitHub, or ModDrop.
3. Unzip Custom NPC Exclusions into the Stardew Valley/Mods folder.
Mods that use Custom NPC Exclusions should now work correctly. For information about creating mods, see the GitHub readme.
Multiplayer note:
- It is recommended that all players install this mod for multiplayer sessions. There are no known issues directly related to this mod, but NPC-related mods can cause unexpected errors if mismatched.
This mod was commissioned by FlashShifter for use with Stardew Valley Expanded's custom NPCs!
Custom NPC Exclusions is a modding tool by Esca-MMC that enables other mods to exclude specific NPCs from quests and events, particularly those that randomly select NPCs. With 94,629 endorsements and 3.7 million downloads, it's a widely adopted utility for mod authors and players seeking more control over NPC interactions.
✨ Key Features
📊 Pros & Cons
✅ Pros
- Huge community trust — 94,629 endorsements and 3.7 million downloads show this is a go-to tool for modders.
- Solves a real problem: gives mod authors a clean way to keep specific NPCs out of random events, which is a common headache.
- Actively maintained — last updated March 2024, so it's likely compatible with current game versions.
⚠️ Cons
- Not a player-facing mod — you need to be a mod author or know how to configure mods to benefit directly.
- Requires other mods to actually use its API — if no other mods implement it, it does nothing on its own.
For mod authors who want to add NPC exclusion logic to their quests or events, especially those with random NPC selection. Also for players who use mods that rely on this framework to keep certain NPCs out of the action. Skip if you're looking for direct gameplay changes — this is a backend utility.
💡 Beginner Tips
- If you're a mod author, check the mod's documentation or source code to see how to call the exclusion API in your own mods.
- For players, this mod works silently in the background — you only need it installed if another mod requires it as a dependency.
- Make sure to download the latest version (March 2024) to ensure compatibility with your game version.
📊 Mod Details
- Game
- Stardew Valley Mods
- Author
- Esca-MMC
- Version
- 1.6.0
- Downloads
- 3,656,281
- Endorsements
- 94,629
- Category
- Modding Tools
- Created
- 11/1/2020
- Updated
- 3/19/2024
🧩 Commonly Used Together
Users add these mods to the same collections — a real compatibility signal, not an AI guess.
🔧 How to Install Stardew Valley Mods
Download from Nexus.
📖 Full step-by-step install guide for Stardew Valley →
Visit the official mod page for specific installation instructions for this mod.
🎮 Need cheat codes or console commands? Check ur gaming wiki for Stardew Valley commands, item IDs, and more.
Keep browsing — more Stardew Valley mods await