Sandy to NPC Adventures

This content pack is designed to add Sandy (shopkeeper of the Oasis) to NPC Adventures! Now you can take her into the Valley to visit (if she doesn't already!)

Sandy is a Forager and Scared class NPC, with buffs to speed, luck, and foraging. Since she does not have a combat class, her stats have been buffed to make her a worthy companion (and may yet be buffed more if the stats are considered too low). Her forages are also more narrowly focused, mainly obtaining flowers (except in the Desert, where she obtains desert forage, and the Island, where she finds Ginger and may find you a Magma Cap or two!)

To answer some likely to be asked questions, I've outlined the following…

As NPC Adventures is single-player only, this content pack cannot be used in multiplayer. However, since it just adds an NPC to its existing setup, it is compatible with any mod that works with NPC Adventures. Please refer to NPC Adventures if you're looking for compatibility.

As there are mods like Stardew Valley Expanded and Immersive Sandy that allow Sandy to visit town, I've created two versions of the Stable Pack for NPC Adventures, the original version referencing Sandy as almost entirely shop-locked (outside of Fall 15). The first main file is the shop-locked version, while the second main file is the dynamic version. This should keep dialogues from being immersion-breaking and allow it to be used in any modpack.

The Beta file, meanwhile, patches in dialogues via Content Patcher! So it is contained in only a single pack and the dialogues you get will depend entirely on if you have the aforementioned Immersive Sandy or Stardew Valley Expanded. If there are other mods you use that have Sandy visit the Valley more often (and are not NSFW), let me know and I'll make sure to add it to the list of mods that would get the dynamic version.

Why did you choose this class/setup for Sandy?

Aside from her usual restrictions, Sandy is depicted as averse to physical combat in NPC Adventures. NPC Adventures has an event if you visit Sandy with Emily as an NPC Adventures companion, which this is a pack for, which implies this. Similarly, Stardew Valley Expanded has an added heart event corroborating this in its version of Sandy and is commonly installed by users. As such, the mod was created with the NPC Adventures' main file's event in mind. The buffs were chosen to compensate for the lack of fighting ability, but may be increased if needed. (If you'd prefer to change her to another class, feel free to alter the values yourself, but do not upload this mod with a changed class only!)

I went to go swim, and Sandy's back in her vanilla outfit!

NPC Adventures uses Stardew's in-built swimming code in order to alter the companion's outfit to their beach outfit in swimmable areas, be that a hot tub in your house, the bathhouse, or East Scarp's ocean. Unfortunately, Sandy does not have such an outfit, so if you are using the stable (0.17.5) build of NPC Adventures, the game would normally hard crash upon entering a swimming square. (The Beta Build does not have this problem, as NPC Adventures blocks the crash on that build!)

To prevent this, I've put in a small content patcher patch in the mod (that is disabled if you have a mod which gives Sandy a beach outfit, like Sandy Goes to the Beach or Diverse Stardew Valley). When you go to swim, the game will load Sandy in her vanilla outfit as her “beach outfit”, and leaving the swimming area properly will turn her back into whatever sprite you otherwise have her as. If it does not turn back, go back in and out of the swimmable area to force the swap back to her normal sprite. (Due to the large variety of mods that change sprites, vanilla Sandy is the safest choice.)

If there are any other mods that give Sandy a beach sprite, let me know and I'll add them as part of the condition that patches in the beach outfit. If you have any of these mods and you suddenly see vanilla Sandy, please let me know ASAP so I can fix whatever bug is happening.

The mod is throwing an error about “obsolete unsupported content pack format used by version 0.x”! HELP!

NPC Adventures has two current versions. The stable version works with all current content packs, while the beta version does not support them but is a more updated version of NPC Adventures, and should be compatible with the upcoming 1.6.

If you get this message, you likely downloaded one of the two stable packs but have the Beta version of NPC Adventures. You will need to download the optional file for the beta to use this mod with that version.

(Short version: If it throws that error, you're on the beta. Go back to stable or use the beta file, helpfully included!)

Can I translate your mod?

Ask first! But otherwise, sure. Some helpful translation tips, since the Beta/Stable versions have different setups:

• The Beta is relatively easy to translate, as it is updated with i18n files! Unfortunately, per NPC Adventures docs on the Beta, speech bubbles cannot be randomized with i18n, so there are three files you will have to translate – the NA folder i18n, the CP folder i18n, and the SpeechBubbles.json in assetsDialogue. Everything else you can pretty much leave untouched.
• The Stable version is more complicated, since the information is split into multiple JSON files. You will likely have to edit each file.

Help! It's bugged!

Let me know what the bug is and I'll fix it as quickly as I can. Since most NPC Adventures bugs are dialogue wise, if you encounter a typo or if Sandy outputs an i18n key, let me know with either an image or type exactly what she said when reporting a bug. If you believe this mod somehow breaks your game, please post a SMAPI log – however, most bugs in that respect are likely the “obsolete unsupported” error above, which has already been mentioned.

Credits

beyondrecovery for helping me check over the Sandy dialogues (especially the ones meant for compatibility with her mod, Immersive Sandy!). Part of the inspiration for this mod was making sure Sandy could leave her shop more often if she wanted to, and her mod was something I wanted to make sure was accounted for when writing.

PurrplingCat for making NPC Adventures, an indispensible part of my single-player games of Stardew Valley, and for helping answer questions I had on both the normal NPC Adventures file creation and the beta upgrades.

Pathoschild for helping maintain and create SMAPI/Content Patcher, without which this endeavor would have been impossible
ConcernedApe for making the game

and everyone in the Stardew Valley Discord who have dealt with me giving random updates on this mod over the course of the several months it spent in development hell. I hope the finished product is satisfactory, and if not, I will always try to improve.

Mods used in images:

• Seasonal Cuter Aesthetic by Poltergeister for Sandy's outfits
• Fashion Sense and its subpack Hoods and Hoodies by PeacefulEnd (and thank you Peaceful for patiently dealing with the bug reports I've sent for it)
• Stardew Valley Expanded for most of the changed maps from vanilla
• And a few miscellanious items visible from Ridgeside Village, East Scarp, and Always Raining in the Valley.