NNNN_AdvancedBuffController 高級Buff/Debuff層數控制器

插件基本資訊 / プラグイン基本情報 / Plugin Basic Information

插件名稱: NNNN_AdvancedBuffController
版本: v1.0.0 (Beta)
作者: NeNeNeNeTaiPlugin
類型: 原創插件 (非改寫)
更新狀態: Beta版本，持續開發中

---

1. 插件主要功能簡述

繁體中文

此插件擴展預設的Buff/Debuff系統，增加高級層數機制、自定義公式和增強控制選項。主要功能包括：

• 支援Buff/Debuff層數疊加系統
• 可自定義每層效果倍率
• 靈活的添加模式（覆寫/累加）
• 幸運值抵抗機制
• 詳細的調試系統

日本語

このプラグインはデフォルトのバフ/デバフシステムを高度なスタック機能、カスタム公式、強化された制御オプションで拡張します。主な機能：

• バフ/デバフスタック積み重ねシステム対応
• 各スタック効果倍率のカスタマイズ可能
• 柔軟な追加モード（上書き/加算）
• 運値による抵抗メカニズム
• 詳細なデバッグシステム

English

This plugin extends the default buff/debuff system with advanced stack-based mechanics, custom formulas, and enhanced control options. Main features:

• Buff/Debuff stack accumulation system
• Customizable effect multiplier per stack
• Flexible add modes (overwrite/add)
• Luck-based resistance mechanism
• Detailed debugging system

---

2. 參數使用說明

主要參數 / メインパラメータ / Main Parameters

defaultBuffMaxStacks (預設Buff最大層數)

• 格式: JSON陣列 [HP,MP,ATK,DEF,MAT,MDF,AGI,LUK]
• 預設值: [2,2,2,2,2,2,2,2]
• 說明: 設定各能力值Buff的最大疊加層數

defaultEffectPerStack (預設每層效果)

• 格式: JSON陣列，數值為倍率
• 預設值: [0.25,0.25,0.25,0.25,0.25,0.25,0.25,0.25]
• 說明: 每層Buff的效果倍率（0.25 = 25%）

addMode (添加模式)

• 選項: overwrite (覆寫) / add (累加)
• 預設值: add
• 說明: 決定新Buff如何與現有Buff疊加

lukEffectRateFormula (幸運抵抗公式)

• 預設值: 1.0 + (subject.luk - target.luk) * 0.001
• 說明: 自定義幸運值影響Buff/Debuff成功率的公式

---

3. 使用步驟

步驟1: 插件管理器設置

1. 在插件管理器中啟用 NNNN_AdvancedBuffController
2. 設定 defaultBuffMaxStacks 參數，例如設為 [3,3,2,2,2,2,2,2]
3. 調整 defaultEffectPerStack 參數，例如 [0.3,0.3,0.25,0.25,0.25,0.25,0.25,0.25]
4. 選擇適合的 addMode（建議使用 add）

步驟2: 技能/道具設置

在技能或道具的備註欄中添加標籤：

Buff層數標籤範例：

<addBuffStacks_ATK:2>     # 增加2層攻擊力Buff
<addBuffStacks_DEF:1>     # 增加1層防禦力Buff
<addBuffStacks_ALL:1>     # 增加1層所有能力值Buff

Debuff層數標籤範例：

<addDebuffStacks_ATK:1>   # 增加1層攻擊力Debuff
<removeBuffStacks_HP:1>   # 移除1層HP Buff

步驟3: 調試設置（可選）

• 將 debugMode 設為 basic 或 detailed
• 設定 debugTarget 為特定角色ID進行追蹤

---

4. 測試方式

基本測試設置

測試用技能設置範例：

1. 強力攻擊Buff技能

   • 備註欄：<addBuffStacks_ATK:2>
   • 效果：增加2層攻擊力Buff

2. 全能力強化技能

   • 備註欄：<addBuffStacks_ALL:1>
   • 效果：增加1層所有能力值Buff

3. 淨化技能

   • 備註欄：<removeBuffStacks_ATK:1><removeDebuffStacks_ALL:1>
   • 效果：移除攻擊Buff並清除所有Debuff

測試步驟：

1. 創建上述測試技能
2. 在戰鬥中使用技能觀察層數變化
3. 開啟Debug模式檢視詳細計算過程
4. 使用控制台命令 debugBuffStacks(1) 檢視角色1的Buff狀態

期望結果：

• Buff/Debuff顯示正確的層數
• 能力值按照設定的倍率正確計算
• 超過最大層數時正確截斷
• Debug信息顯示詳細的計算過程

//TODO:圖檔說明 - 需要添加Buff層數顯示的螢幕截圖和Debug輸出範例

---

5. 版權聲明

授權條款: MIT License
商業使用: ✅ 允許
二次開發: ✅ 允許
轉售權限: ❌ 禁止轉售原插件
署名要求: 建議保留原作者資訊

---

Debug控制台命令 / デバッグコンソールコマンド / Debug Console Commands

debugBuffStacks(actorId)     // 顯示指定角色的Buff/Debuff層數狀態
debugBuffCalc(actorId)       // 顯示詳細的計算分解過程  
toggleBuffDebug()            // 切換Debug模式開關
resetBuffDebug()             // 重置Debug設定

---

注意事項 / 注意事項 / Notes

• 此插件為Beta版本，可能存在未知問題
• 建議在測試環境中充分驗證後再用於正式項目
• 層數系統與原生Buff系統兼容，但建議統一使用新系統
• 自定義公式需要謹慎使用，錯誤的公式可能導致遊戲崩潰