Please visit our NPC Adventures website!

Featured on PC Gamer, Inquirer.net, Gamestar.de and The Millenials Today.

Recruit companions to follow you! Currently supports all vanilla marriage candidates (bachelors and bachelorettes).

Looking for user guide? See Documentation
Getting started with this mod

Off-site requirements

This mod requires off-site requirement Expanded Precondition Utility. This dependency is available only on Nexusmods, because it is 3rd party mod not maintained by PurrplingCat. If you want play this mod, you have to download the EPU dependency manually on the Nexusmods.

NPC Adventures is not a framework!

Really, this mod ia not a framework. It's fully content mod with strong gameplay mechanics and it supports content packs to enhance companions with your custom NPC companions. It doesn't mean it's framework. This mod is only extensible (moddable) mod.

KNOWN ISSUES IN SDV 1.5

Nothing work or cause big problems in split screen or multiplayer (NEVER PLAY THIS MOD IN MULTIPLAYER OR SPLIT SCREEN, it's not and never be compatible)
NPC doesn't follow you through some bridges on island (too hard to fix, I need help with that)

because I am not able fix these issues alone, I am asking you for help. If you want to help me to fix these problem and you have a knowledge of C# modding in SMAPI, contact me via discord (link is at bottom of this page). All other features works. Thanks

Current Features~

Ask recruitable NPC's to follow you (5 hearts or more required.)
Recruitable NPC’s can now ask if they can join you (7 hearts or more required, configurable.)
Dismiss your follower at any time. They will leave on their own when it gets too late.
Recruited followers have unique dialogue in different locations (WIP)
All recruited followers can fight with you (with their own swords and fighting skills!)
You can transfer items from your inventory anytime to your currently recruited follower.
If you forget your items, or your follower leaves before you can reclaim them, they will be returned to you the next day.
Support for content packs and localizations. You can add any custom NPC as a companion with a content pack! (see how to create content pack on wiki, or content pack list for download content packs.)
Custom user configuration (viaconfig.json, see SMAPI docs)
Changeable/prosthetic buffs for Maru (hold G to change buff)
All followers have idle animations as well as speech bubbles while fighting!
Companion events for some companions! (triggered during adventuring with recruited companion)
Based on Quest Framework

Followers have unique personal skills, currently implemented: warrior, fighter, doctor, forager and scared.

Doctors can fight with swords and also heal you if your health is under 30%. They can also try to save you before you collapse.
Warriors do more damage to monsters and are able to fight with swords and use critical defense fists in combat. They can also upgrade their swords.
Foragers can forage and occasionally share their findings with you.
Scared can be scared, screech and jump away when they see a monster, but don't worry, they can still fight (if they have a fighter skill). Mostly this "negative" skill is compensated by more powerful buffs.
Fighters are less powerful than warriors. They can level up and sync with player, and can upgrade their swords. It's a secondary skill, in most cases is assigned with any other skill.
Spirituals can send some peace&love for monsters with their spiritual emergy and make them peaceful. Loved monsters will not attack you for limited time.
Fisherman can fish with fishing rod and share caught fishes with you.

Followers Unique Skills~

Doctor: Harvey and Maru
Warrior: Abigail, Alex and Sebastian
Forager: Leah and Penny
Scared: Haley
Spiritual: Emily
Fisherman: Elliott
Fighter: All other NPC’s (Except Emily)

Every recruitable follower grants unique buffs:

Companion Personal skills Buffs
Abigail Warrior +1 Speed, +1 Luck, +1 Attack
Alex Warrior +1 Speed, +2 Attack
Haley Scared +2 Luck
Maru Doctor +1 Mining, +1 Luck, +1 Speed
Shane +3 Farming
Leah Forager +2 Foraging
Emily Spiritual +2 Mining
Penny Forager +3 Farming
Sam +2 Speed
Sebastian Warrior +1 Speed, +1 Luck, +1 Attack
Elliott Fisherman +3 Fishing
Harvey Doctor +3 Defense

All currently recruitable NPC’s except Emily can fight with a sword (fighter skill assigned). When your spouse is following you, they grant additional buffs. (+1 Luck and +1 Magnetic Radius)

Display's personal skills of current follower in HUD (configurable in config.json)

Two gameplay modes: Adventure (default) and Classic~

By default this mod is played in adventure mode. This mode adds quests and events for recruited followers. In order to recruit followers, you must first reach 20 level of the mines, be granted access to the Adventurer's guild and receive the letter from Marlon with an invitation to meet which will trigger the Introduction Event and have 66% of required heartlevel for recruit with any recruitable NPC. After this, you can invite villagers to follow you.

You will receive Marlon’s letter and trigger the new event after you reach level 20 in the mines, have you a 66% of required hearts with any recruitable NPC and have access to the Adventurer’s Guild. If you’ve already reached level 10 and have access before installing or updating this mod, you will receive the letter the next morning.

If you don’t want to use Adventure mode, and only want villagers to follow you, just disable ‘Adventure mode’ in configuration. By disabling Adventure mode you enable Classic mode, which removes ALL extra quests and events!

There are some companion events which are triggered during adventuring with your recruited companion. See the event list

Custom NPC's~

You can add a custom NPC as a follower to this mod via content pack. See documentation.

Are you looking for community content packs? See Content pack list

Install~

Install the latest version of SMAPI.
Download this mod and unzip it into Stardew Valley/Mods.
Run the game using SMAPI.

How to use~

Ask an NPC to follow you by right clicking when no dialogues are queued.
Trigger NPC actions (use their backpack, dismiss them) by right clicking when NPC is recruited and no dialogues are queued.

Compatibility~

Works with Stardew Valley 1.5.6 on Windows/Linus/MacOS (Android is not compatible) - Mod is loaded but may cause some problems
Single player only (doesn't work with local split-screen multiplayer too)

Compatibility with other mods~

✅ Custom Kissing Mod by Digus - 100% compatible (from version 0.9.0 with version 1.2.0 and newer of Custom Kissing Mod.
✅ Json Assets - Compatible (since version 0.14.0) - You can use custom weapons in disposition file from JA in your content packs via weapon name (Only swords supported).
✅ Pacifist Valley - You can give some love to monsters with companions together! For full compatibility you need install Compatibility content pack . Requires NPC Adventures 0.15.0 or newer.

⚠️ Automatic gates - Companions can get stuck when gates automatically close after farmer.

Contributors~

purrplingcat - main developer and producer
RememberEmber - author of dialogues and texts
Mortimer - Portuguese translation
mardrest - Spanish translation
치즈린, KAYA - Korean translation

Special thanks to Arknir and Mortimer.

See also~