Customize NPC portraits

Allows you to easily create portraits of NPCs including farmers, supporting custom backgrounds and frames. Add one or more NPCs to the portrait to create adorable family or couple photos!

Customize NPC portrait

🎨 **Create your own Stardew Valley memories! **

This mod allows you to easily create highly customizable NPC portraits. Choose your favorite frame, background and NPC, and you can freely adjust the NPC's position and frame offset. Want more personalization options? You can even **add your own frames** and **backgrounds**!

---

✨ Main features

• **10 types of picture frames** - various styles for you to choose from
• **26 backgrounds** - Rich scenes to match as you wish
• **Any NPC** - including original and mod NPCs, monsters, pets, etc., and even **local farmers** (multiple farmers are not supported in multiplayer games yet)
• **Custom Backgrounds and Frames** - Follow the guide to add your own materials
• **Single color background** - Supports color slider adjustment

---

🎮 How to use

• After obtaining the **catalog**, a **button** will appear under the money component in the catalog menu.
• Click the button to open the customization menu and start designing your portrait
• **Exporting images is completely free** and does not consume any gold coins
• The module will obtain the current sprite of the selected NPC (if it is winter, only the winter sprite of the NPC can be used)
• If you cannot see the button in the directory, you can set a hotkey to open the menu. It is recommended to use the general module configuration menu.
• The farmer sprite function is an experimental feature. The module will take screenshots and process the farmer's frames.

📺 **DEMO VIDEO**: Watch the tutorial

---

🚀 Future plans

• Search and filter functions
• Overlay effects (snow, rain, etc.)
• Save presets for use in other saves
• Get existing images
• Non-rectangular frame
• More frames and backgrounds
• Adjust the HSV values ​​of NPCs and backgrounds to adapt to the recolor/desaturation module

---

🔗 Compatibility

• ✅ **Compatible Module NPC** - Automatically supports all module NPCs (such as SVE, RV, Aspen, etc.)
• ✅ **Compatible with Windows and Mac systems**
• ✅ **Multiplayer Compatible**
• ✅ **Compatible with Happy Home Designer** - Hotkey setting prompts will be removed in the next version

---

🌍 Language support

• English
• German
• Chinese by HanGee (1.1.0)

---

⚠️ Known issues

• Some NPC frames (such as when fishing) only show the fishing rod
• The slider supports mouse wheel and arrow buttons, but the slider cannot be dragged
• There is a bug in the farmer sprite part (experimental feature)
• There is a bug in the sprite of the farmer's child in the baby stage

---

❓ FAQ

**Q: Is this mod compatible with other mods? **

A: Should be compatible with most mods. It does not modify any lines of code and has minimal to no conflicts with other mods. If you don't have access to the catalog's original UI, you can set a hotkey in the configuration to open the customizer.

**Q: Does it support module NPC? **

A: Yes! You can create a portrait for any modded NPC that is social. The module automatically obtains NPC information without requiring additional work from the mod author.

**Q: Can I add custom backgrounds and frames? **

A: Of course! There are two different ways to add, see here for details.

**Q: How to use NPC’s winter clothing? **

A: The module obtains the current sprite map of each NPC. If you want to use winter sprites, you need to wait until winter. This applies to all situations (beach, seasonal clothing in the corresponding season, etc.).

---

🙏 Acknowledgments

• Custom Picture Frames inspired by aedenthorn
• Part of the background uses the color palette provided by Poltergeister on the Krobus Discord server
• Some NPCs in the picture are from Stardew Valley expansion, Ridgeside Village and Aspen
• The scrolling title is generated using kdau's scrolling generator

source code