Stardew Valley Frameworks Free

Custom NPC Exclusions for Stardew Valley

A utility that lets other mods exclude their NPCs from quests, Winter Star gifts, island visits or the movie theater. Many NPC mods require it. Version 1.6.0.

Author: Esca-MMC Version: 1.6.0 Compatible: Stardew Valley 1.6.x with SMAPI 4.x Updated: 19 Mar 2024 Reviewed: 24 Oct 2026
Download Custom NPC Exclusions

More screenshots on Nexus Mods ↗

What this mod does

Custom NPC Exclusions, by Esca-MMC, is a small utility listed as a requirement by many mods that add characters. It was commissioned by FlashShifter for the NPCs in Stardew Valley Expanded and does nothing on its own.

What it’s for

Some game mechanics pick characters at random. Without this mod, an NPC who lives far from town might ask you for a delivery on the Help Wanted board or say they shop at Pierre’s. With it, each mod decides which characters are left out of:

  • The Introductions quest and random delivery quests.
  • The Feast of the Winter Star gift exchange.
  • Visits to the Ginger Island resort and movie theater invitations.
  • Greetings between NPCs, the perfection score and calendar birthdays.

Requirements and compatibility

It only needs SMAPI. Version 1.6.0 (March 19, 2024, 20 KB) rewrites the code for 1.6, and Nexus tags it as compatible with Android. In multiplayer, the author recommends that all players install it, because NPC mods with mismatched versions can cause errors. Only install it if a mod asks for it.

User rating

—
No ratings yet. Be the first.
Tried it? Rate it: Anonymous, one vote per person.

Highlights and things to keep in mind

Highlights
  • Prevents odd situations with modded NPCs
  • Lightweight (20 KB), no configuration needed
  • Tagged as compatible with Android
Keep in mind
  • Does nothing without mods that use it
  • The latest version is from March 2024, although it's built for 1.6

Requirements

  • Stardew Valley 1.6.x (PC; tagged as compatible with Android)
  • SMAPI 4.x
  • A mod that uses it (it does nothing on its own)

How to install it

  1. Install SMAPI first (see its mod page) and launch the game once with it to make sure it works.
  2. Open the Custom NPC Exclusions page on Nexus Mods, go to the Files tab and click Manual download on the main file (Custom NPC Exclusions v1.6.0). You need a free Nexus account to download.
  3. Extract the .zip outside the game folder and move the resulting folder into the Mods folder, inside the game folder.
  4. Launch the game with SMAPI and check in the console that Custom NPC Exclusions appears in the list of loaded mods with no red errors.

Version history

  1. 1.6.019 Mar 2024Current

    Current file: code rewritten for 1.6

  2. 1.5.020 Sep 2023

    Last version for 1.5.6 (Old files)

Common problems

Does it need configuring?

No. The mods that use it specify which NPCs to exclude; you just have to install it.

Do all players need it in multiplayer?

The author recommends it, because NPC mods with different versions between players can cause errors.

What is the Exclusion Example Pack for?

It's a test pack for authors that excludes some base-game NPCs; it isn't meant for regular play.

Mods that need Custom NPC Exclusions

If you're installing any of these, you need this one first.

More mods for Stardew Valley

✓ Stardew Valley 1.6Multiplayer
Stardew Valley · GameplayFree Destroyable Bushes Lets you chop down bushes with your axe: they drop some wood and experience, and grow back after 3 days. Everything is configurable. Updated 8 May 2025
✓ Stardew Valley 1.6Multiplayer
Stardew Valley · FrameworksFree Farm Type Manager (FTM) Framework that spawns forage, ores and monsters on custom farms and areas; required by SVE, Ridgeside Village and East Scarp. Version 1.26.1 for 1.6.15. Updated 14 Nov 2025
✓ Stardew Valley 1.6Multiplayer
Stardew Valley · FrameworksFree Json Assets A classic framework that lets content packs add crops, fruit trees, items, clothing, weapons and recipes. Version 1.11.11 for 1.6.14. Updated 18 Oct 2025
✓ Stardew Valley 1.6Multiplayer
Stardew Valley · FrameworksFree Expanded Preconditions Utility A utility that adds a condition system for other mods. It does nothing on its own, but many NPC and content mods require it. Version 1.1.2 for 1.6.15. Updated 15 Mar 2026
✓ Stardew Valley 1.6
Stardew Valley · FrameworksFree Mapping Extensions and Extra Properties (MEEP) A framework for map authors, required by expansions like East Scarp or Sword and Sorcery: close-ups, letters, decorative NPCs and animals. Version 2.5.3. Updated 23 Apr 2026
✓ Stardew Valley 1.6Multiplayer
Stardew Valley · FrameworksFree Alternative Textures A framework for having multiple textures for the same object, building or animal and switching them with a paint bucket. Used by over 1,300 mods. Version 8.1.1. Updated 3 Jan 2026