星露谷物語NPC角色表生成器

一個C#小工具，可生成具有隨機或特定自定義選項的角色精靈！按幀輸出生成的所有可用動畫集的NPC。生成可直接使用的精靈表。

SDV NPC角色表生成器

🎮 **像素級完美的農夫幀導出器和NPC生成器**

✨ 爲每個原版農夫動作輸出16×32 PNG圖像，可生成完全着裝的NPC，支持星露穀風格的隨機化或明確服裝覆蓋。輸出所有動畫幀，以及包含基礎NPC所有移動動作的即用精靈表。

---

🚀 使用說明

• **下載最新版本**並解壓到星露谷物語.exe旁邊
• **創建input/文件夾**在FarmSplitter.exe旁邊，包含從遊戲中提取的基礎農夫精靈文件：
• 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

• **運行工具** - 默認將每動作幀導出到output/文件夾

```./FarmSplitter.exe

```

*這將生成一個隨機NPC*

• **生成多個NPC**並顯示進度反饋

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

```

---

⚙️ 命令行參考

**核心功能**

• `--random `: 生成n個NPC（顯示控制台進度條）
• `--gender `: 隨機性別源池（默認both）
• `--seed `: 確定性生成
• `--content `: 遊戲Content根目錄（默認：./Content）

**帽子與配飾**（默認禁用）

• `--hats `: 啓用/禁用帽子
• `--accessories `: 啓用/禁用配飾

**明確服裝覆蓋**（跳過該部件的隨機化）

• `--shirt `: 來自Data/Shirts的襯衫ID
• `--pants `: 來自Data/Pants的褲子ID
• `--hair `: 髮型索引
• `--hat `: 帽子ID
• `--accessory `: 配飾索引

---

🎯 使用示例

**生成20個隨機NPC，啓用帽子和配飾**

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

```

**僅導出行走動作並構建移動表**

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

```

**精確服裝與顏色設置**

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

```

---

🔧 故障排除

• **"無法定位星露谷物語Content"錯誤**：將工具放在星露谷物語.exe旁邊，或使用`--content `指向遊戲的Content文件夾
• **MonoGame/SDL初始化錯誤**：確保SDL2.dll位於可執行文件旁邊（發佈壓縮包中包含），且Content可讀
• **每動作導出警告**：導出器將繼續運行並記錄動作名稱；使用`--verbose`重新運行獲取更多細節

---

💡 實用提示

• 將FarmSplitter.exe保持在星露谷物語.exe旁邊，並將列出的input/*.png文件放在那裏以獲得最流暢的體驗
• 幀是像素級完美的16×32裁剪，由原版`FarmerRenderer`渲染，因此分層和偏移與遊戲完全匹配

---

🔗 有用鏈接

• 星露谷物語原版ID | 完整1.6物品列表 - 查找相關ID
• 編輯XNB文件 - 星露谷物語Wiki - 學習如何提取所需的遊戲文件
• 星露谷物語角色創建器 by Jazzybee - 爲隨機生成的NPC創建簡單快速的肖像！