NPC服裝框架

讓你可以爲NPC提供服裝或配飾，他們會穿戴，或使用Content Patcher邏輯手動爲NPC分配服裝。

NPC Clothing Framework

🎭 **讓星露谷的NPC們擁有個性化的服裝系統！**

✨ 核心功能

使用這個模組，你可以創建Content Patcher內容包，爲特定的NPC指定可穿戴的物品：

• 🎩 **任意物品可穿戴** - 不受限於通常可贈送的物品，任何物品都可以設置爲可穿戴
• 🎯 **智能分配** - 爲NPC分配服裝槽位名稱（如"帽子"），NPC會在每天隨機選擇該槽位的一個物品穿戴
• 📊 **概率控制** - 可以爲每件服裝設置每日穿戴的百分比概率
• 🔄 **輕鬆移除** - 再次贈送相同物品即可從NPC的服裝列表中移除該物品

🛠️ 技術細節

服裝通過直接編輯角色和肖像精靈表來穿戴，如果你使用自定義角色表，可能需要相應調整服裝精靈表。

📦 內容包配置

以下是一個示例**content.json**文件：

```json

{

"Format": "1.23.0",

"Changes": [

{

"Action": "EditData",

"Target": "aedenthorn.NPCClothing/dictionary",

"Entries": {

"hat_0": {

"id": "hat_0",

"giftName": "Cowboy Hat",

"giftReaction": "like",

"clothingSlot": "hat",

"spriteTexturePath": "aedenthorn.NCFHatsCP/hat_0_sprite",

"portraitTexturePath": null,

"spriteOffsets": [

{

"offset": { "X": 0, "Y": -3 },

"names": ["Demetrius"],

"ages": null,

"genders": null

}

],

"portraitOffsets": null,

"namesAllow": ["Demetrius", "Abigail", "George", "Evelyn"],

"namesForbid": null,

"agesAllow": null,

"gendersAllow": null,

"skinColors": null,

"percentChance": 100,

"zIndex": 0

}

}

},

{

"Action": "Load",

"Target": "aedenthorn.NCFHatsCP/hat_0_sprite",

"FromFile": "assets/hat_0_sprite.png"

}

]

}

```

📋 配置參數說明

• **id** - 任意標識符，應與條目鍵相同
• **giftName** - 物品名稱（非顯示名稱），如果省略，則無需贈送禮物即可穿戴
• **giftReaction** - 僅適用於通常不可贈送的物品，可選值：love、like、dislike、hate、neutral
• **clothingSlot** - 任意槽位名稱，同一時間只能穿戴一個給定槽位的服裝
• **spriteTexturePath** - 精靈紋理的虛擬路徑，將覆蓋在角色精靈表上方
• **portraitTexturePath** - 肖像紋理路徑（可省略任一以使服裝僅顯示在精靈或肖像中）
• **spriteOffsets** - 像素偏移，允許按名稱、年齡或性別爲不同大小的角色使用單個圖塊表
• **percentChance** - 每日穿戴此服裝的百分比概率
• **zIndex** - 指定繪製順序的任意整數

🎨 紋理處理

紋理將掃描非透明像素，這些像素將覆蓋在現有像素之上，除非新像素的不透明度小於10%。使用幾乎透明的像素告訴模組用透明像素替換現有的精靈像素（例如用於遮蓋頭髮）。

🔗 相關模組

使用此框架的模組：

• Flower Crowns for Townspeople
• NPC Wearable Hats

⚙️ 技術要求

• 需要 SMAPI
• 使用Harmony
• 實現 Generic Mod Config Menu 界面，可在遊戲中更改配置設置
• 與 Mod Updater 兼容，支持自動更新

🌟 社區支持

代碼位於：GitHub倉庫

所有星露谷模組列表：模組集合