Stardew Valley NPC character sheet generator

A C# gadget that generates character sprites with random or specific customization options! Outputs the generated NPCs for all available animation sets frame by frame. Generates ready-to-use sprite sheets.

SDV NPC character sheet generator

🎮 **Pixel-perfect farmer frame exporter and NPC generator**

✨ Outputs 16×32 PNG images for each vanilla farmer action, generating fully clothed NPCs with support for Stardew Valley-style randomization or explicit costume overlays. Outputs all animation frames, as well as a ready-to-use sprite sheet containing all the movement actions of the base NPC.

---

🚀 Instructions for use

• **Download the latest version** and extract it next to Stardew Valley.exe
• **Create the input/folder** next to FarmSplitter.exe, containing the base Farmer Splitter files extracted from the game:
• accessories.png
• farmer_base.png
• farmer_base_bald.png
• farmer_girl_base.png
• farmer_girl_base_bald.png
• hairstyles.png
• hairstyles2.png
• hats.png
• pants.png
• shirts.png
• shoeColors.png
• skinColors.png

• **Run Tool** - Export each action frame to the output/ folder by default

```./FarmSplitter.exe

```

*This will generate a random NPC*

• **Generate multiple NPCs** and display progress feedback

```./FarmSplitter.exe --random 25

```

---

⚙️ Command line reference

**Core Features**

• `--random`: Generate n NPCs (display console progress bar)
• `--gender`: random gender source pool (default both)
• `--seed`: deterministic generation
• `--content`: Game Content root directory (default: ./Content)

**Hats and Accessories** (disabled by default)

• `--hats`: enable/disable hats
• `--accessories`: enable/disable accessories

**Explicit Costume Coverage** (Skips randomization of this part)

• `--shirt `: shirt ID from Data/Shirts
• `--pants`: Pants ID from Data/Pants
• `--hair`: Hair style index
• `--hat `: hat ID
• `--accessory `: accessory index

---

🎯 Usage example

**Generate 20 random NPCs, hats and accessories enabled**

```./FarmSplitter.exe --random 20 --hats yes --accessories yes

```

**Only export walking motion and build movement table**

```./FarmSplitter.exe --random 12 --actions WalkingDown,WalkingRight,WalkingUp,WalkingLeft

```

**Accurate clothing and color settings**

```./FarmSplitter.exe --gender male --shirt 1021 --pants 0 --hair 11 --haircolor 191919 --pantscolor 1e90ff --hat 4 --accessory 6 --shoecolor a0522d

```

---

🔧 Troubleshooting

• **"Unable to locate Stardew Valley Content" error**: Place the tool next to Stardew Valley.exe, or use `--content` to point to the game's Content folder
• **MonoGame/SDL initialization error**: Make sure SDL2.dll is located next to the executable file (included in the release package) and the Content is readable
• **Per-action export warning**: The exporter will continue running and logging the action name; rerun with `--verbose` for more details

---

💡 Useful Tips

• Keep FarmSplitter.exe next to Stardew Valley.exe and place the listed input/*.png files there for the smoothest experience
• Frames are pixel-perfect 16×32 crops, rendered by the original `FarmerRenderer`, so layering and offsets match the game exactly

---

🔗 Useful links

• Stardew Valley original ID | Complete 1.6 item list - Find related IDs
• Edit XNB Files - Stardew Valley Wiki - Learn how to extract the required game files
• Stardew Valley Character Creator by Jazzybee - Create quick and easy portraits of randomly generated NPCs!