Skip to content

6.1. NPC Portraits & Outfits

June edited this page Aug 5, 2026 · 1 revision

Note

This page is still a work in progress. The information here is not exhaustive.

Relevant files and folders

The relevant files for portrait and outfit mods are located in animations/NPCs/ as well as fiddle/npcs/.

Portraits

An NPC's portraits are the sprites that display when speaking to the NPC. The sprite files are located under animations/NPCs/[NPC]/Portraits/. All vanilla sprites consist of an animation of two frames, the first frame with the mouth closed and the second with the mouth open. The animation will loop as long as the NPCs dialogue is still being written to the screen, after which it will stay on the first frame (mouth closed). Each portrait takes the naming format spr_portrait_[NPC]_[outfit]_[expression].png.

Replacing portraits

If you want to make a simple portrait replacement mod, this is just a matter of making a regular sprite replacement.

Creating new expressions

[TODO]

Outfits

An "outfit" is the game's term for a combination of a set of portraits paired with overworld animation sprites. Most NPCs have an outfit for each season, plus beach outfits for romanceables. Celine additionally has a few gardening outfits for different seasons.

Overworld Sprites

The overworld sprites are the animations that are used in the main game interface, such as walking, etc. These files are located under animations/NPCs/[NPC]/Sprites/.

Creating new outfits

[TODO]

Clone this wiki locally