ReaperBalance

ReaperBalance - 收割者紋章增強模組

English Version

模組簡介

ReaperBalance 是一款針對 Silksong 收割者紋章（Reaper Crest）的增強模組。裝備收割者紋章後，你將獲得更強大的戰鬥能力和更流暢的遊戲體驗。所有功能都可以通過遊戲內菜單(F6)自由配置。

主要功能

戰鬥增強

• 十字斬蓄力攻擊 - 蓄力後釋放強力的十字形斬擊，可調整大小和傷害
• 攻擊傷害提升 - 普通攻擊和下劈攻擊的傷害倍率可獨立調整
• 眩暈值加成 - 所有攻擊的眩暈效果更強，更容易打斷敵人

收割模式優化

• 持續時間延長 - 收割者模式持續時間大幅提升
• 絲球掉落增加 - 攻擊敵人時掉落更多絲球
• 絲球自動吸引 - 遠距離自動吸引小絲球，可調整範圍和速度

暴擊系統（可選）

• 獨享暴擊機制 - 啓用後，收割者紋章擁有獨立的暴擊系統
• 可配置暴擊率 - 自定義暴擊概率（0-100%）
• 可配置暴擊傷害 - 自定義暴擊傷害倍率

安裝步驟

• 安裝 BepInEx 框架
• 安裝 ModMenu 模組
• 將 ReaperBalance.dll 放入 BepInEx/plugins 目錄
• 啓動遊戲即可

配置說明

在遊戲內通過F6 Mod Options 菜單配置（支持中英文切換），或編輯 BepInEx/config/ReaperBalance.cfg 文件。

通用設置

| 配置項 | 說明 | 默認值 |

|--------|------|--------|

| EnableReaperBalance | 全局啓用/禁用開關 | true |

| UseChinese | 使用中文菜單 | true |

攻擊設置

| 配置項 | 說明 | 默認值 |

|--------|------|--------|

| EnableCrossSlash | 啓用十字斬蓄力攻擊 | true |

| CrossSlashScale | 十字斬縮放大小 | 1.2 |

| CrossSlashDamage | 十字斬傷害倍率 | 2.3 |

| NormalAttackMultiplier | 普通攻擊傷害倍率 | 1.2 |

| DownSlashMultiplier | 下劈攻擊傷害倍率 | 1.5 |

| StunDamageMultiplier | 眩暈值倍率 | 1.2 |

收割模式設置

| 配置項 | 說明 | 默認值 |

|--------|------|--------|

| DurationMultiplier | 收割者模式持續時間倍率 | 3.0 |

| ReaperBundleMultiplier | 絲球掉落倍率 | 1.0 |

絲球吸引設置

| 配置項 | 說明 | 默認值 |

|--------|------|--------|

| EnableSilkAttraction | 啓用絲球吸引 | true |

| CollectRange | 吸引範圍 | 8 |

| CollectMaxSpeed | 吸引最大速度 | 20 |

| CollectAcceleration | 吸引加速度 | 800 |

暴擊設置

| 配置項 | 說明 | 默認值 |

|--------|------|--------|

| EnableReaperCrit | 啓用收割者暴擊系統 | false |

| ReaperCritChancePercent | 暴擊率（%） | 10 |

| ReaperCritDamageMultiplier | 暴擊傷害倍率 | 3.0 |

核心模塊

Plugin.cs

• 插件入口點，BepInEx 配置初始化
• Harmony 補丁註冊
• ModMenu 界面構建
• 場景切換監聽和組件生命週期管理

ChangeReaper.cs

• 實現十字斬蓄力攻擊
• 傷害倍率計算
• 絲球吸引邏輯
• 攻擊動作替換

HeroControllerPatch.cs

• 修改 BindCompleted 方法延長收割者模式持續時間
• 修改 GetReaperPayout 方法調整絲球掉落倍率

HealthManagerCritPatch.cs

• 攔截 ApplyDamageScaling 方法
• 實現獨立的暴擊判定和傷害計算

技術特點

• 模塊化設計 - 各功能模塊獨立，便於維護擴展
• 響應式配置 - 配置修改實時生效，無需重啓
• 條件性補丁 - 僅在裝備收割者紋章時應用修改
• 性能優化 - 預製體緩存，避免重複資源加載

開發環境

• Unity 6000.0.50

-.NET Standard 2.1

• BepInEx 5.x
• HarmonyX

許可證

MIT License

English Version

Introduction

ReaperBalance is an enhancement mod for Silksong's Reaper Crest. When equipped, you'll gain more powerful combat abilities and a smoother gameplay experience. All features can be freely configured through the in-game menu(F6).

Main Features

Combat Enhancement

• Cross Slash Charge Attack - Release a powerful cross-shaped slash after charging
• Attack Damage Boost - Independent damage multipliers for normal and down slash attacks
• Stun Bonus - Stronger stun effects on all attacks

Reaper Mode Optimization

• Extended Duration - Significantly longer Reaper mode duration
• Increased Silk Drops - More silk orbs drop when attacking enemies
• Auto Silk Attraction - Automatically attract silk orbs from a distance

Critical System (Optional)

• Exclusive Crit Mechanic - Independent critical hit system for Reaper Crest
• Configurable Crit Rate - Custom crit chance (0-100%)
• Configurable Crit Damage - Custom crit damage multiplier

Configuration

Configure through the in-game Mod Options menu (supports Chinese/English), or edit BepInEx/config/ReaperBalance.cfg.

General Settings

| Option | Description | Default |

|--------|-------------|---------|

| EnableReaperBalance | Global enable/disable toggle | true |

| UseChinese | Use Chinese menu | true |

Attack Settings

| Option | Description | Default |

|--------|-------------|---------|

| EnableCrossSlash | Enable cross slash charge attack | true |

| CrossSlashScale | Cross slash scale | 1.2 |

| CrossSlashDamage | Cross slash damage multiplier | 2.3 |

| NormalAttackMultiplier | Normal attack damage multiplier | 1.2 |

| DownSlashMultiplier | Down slash damage multiplier | 1.5 |

| StunDamageMultiplier | Stun damage multiplier | 1.2 |

Reaper Mode Settings

| Option | Description | Default |

|--------|-------------|---------|

| DurationMultiplier | Reaper mode duration multiplier | 3.0 |

| ReaperBundleMultiplier | Silk orb drop multiplier | 1.0 |

Silk Attraction Settings

| Option | D