友誼令牌

在對話中添加隱形的友誼獎勵。可在任意對話行中使用——令牌會被隱藏，每個對話框只應用一次總和。支持多人遊戲。

FriendshipTokens

🎮 **隱形對話友誼獎勵系統**

一個輕量級實用工具，讓內容包可以直接從對話文本中授予友誼值！

---

✨ 核心功能

• **隱形令牌**：在對話中寫入 `[[FT:+250]]` → 玩家看不到任何內容 → 該對話框應用+250友誼值
• **一次性應用**：跨頁面彙總所有令牌，每個對話框只應用一次
• **定向提升**：`[[FT:Robin:+30]]` 即使謝恩在說話也會提升羅賓的友誼
• **事件友好**：適用於大多數事件對話行
• **多人遊戲安全**：每個客戶端將友誼應用到自己的農夫

🎯 使用場景

**無需複雜事件代碼！無需自定義代碼！**

翻譯人員和對話模組製作者可以直接在i18n文件中調整關係進度節奏。

---

📝 基礎語法

**當前說話者**：

• `[[FT:+250]]`、`[[FT:-40]]`

**按名稱指定目標**：

• `[[FT:Shane:+250]]` 或 `[[FT:Shane+250]]`
• （不區分大小寫，支持內部名稱或顯示名稱）

💡 **提示**：250點 = 1顆心（原版設定）

---

🎮 使用示例

Content Patcher / i18n 示例

```json

{

"OnlyShane.sample.1": "…好吧。拿去吧。[[FT:+40]]",

"OnlyShane.sample.2": "告訴羅賓我盡力了。[[FT:Robin:+20]]"

}

```

EditData 示例

```json

{

"Action": "EditData",

"Target": "Characters/Dialogue/Shane",

"Entries": {

"Introduction": "你認爲自己是星露谷的好朋友嗎？[[FT:+250]] [[FT:Robin:+250]]"

}

}

```

事件示例

```.../speak Shane "好吧…這是你的。[[FT:+120]]"/

message "羅賓點了點頭。[[FT:Robin:+30]]"/...

```

---

🔧 工作原理

• 令牌在構建時和渲染文本前被移除
• 每個對話框彙總令牌並一次性應用
• 當前說話者令牌在有說話者時應用
• 目標令牌在NPC可解析時立即應用
• UI永遠不會顯示令牌

---

⚠️ 限制說明

• **無說話者 = 無當前說話者獎勵**：信件/電視/標誌沒有說話者
• → 目標令牌仍然有效（`[[FT:Name:+N]]`），但 `[[FT:+N]` 無效
• 使用自定義對話UI的模組可能需要小型兼容性補丁

---

💡 推薦數值

• **小彩蛋對話**：±10 ~ ±40
• **有意義時刻**：±60 ~ ±120
• **場景亮點**（告白/道歉）：最多+250（≈1顆心）
• **懲罰值**通常低於獎勵值以保持玩家舒適度

---

🛠️ 系統要求

• **SMAPI 4.x**（或更新版本）

📥 安裝說明

• 安裝或更新SMAPI
• 將此模組放入 Mods/ 文件夾
• 運行遊戲
• 在SMAPI控制台中應看到：`[FT] Patched N DialogueBox ctors + getCurrentString()`

---

🔄 兼容性與多人遊戲

• 與原版和Content Patcher對話兼容
• **合作模式**：每個玩家的客戶端將友誼應用到自己的農夫——不會重複計算

❓ 故障排除

• **令牌文本出現在屏幕上** → 另一個UI在沒有DialogueBox的情況下渲染
• **友誼值沒有變化** → 該行沒有說話者且使用了 `[[FT:+N]` → 請使用 `[[FT:Name:+N]`
• **目標名稱未找到** → 使用NPC的內部名稱或顯示名稱（不區分大小寫）

---

❓ 常見問題

**Q. 這是作弊嗎？**

A. 這是一個工具。作者選擇數值。我們還每個對話框只應用一次以防止濫用。

**Q. 在事件中有效嗎？**

A. 對大多數說話行有效。message/信件/電視需要目標令牌。

---

🗓️ 開發計劃

• 可選的每個NPC每日上限
• 可選的心數範圍門控（僅在X~Y心之間激活）
• 可選的對話框級默認目標（`[[FT@Shane]`）

---

**作者**：jkysa88