AutoHotkey v2 工具，專為 棕色塵埃2 音樂小遊戲自動化設計。
具備拖曳可調整大小的偵測覆蓋層、顏色偵測、多區域支援和基於INI的設定功能。
完美實現完美節拍，不再有手指疲勞。
- 拖曳可調大小偵測框 — 自由對準遊戲判定區域
- 顏色偵測自動點擊 — 精準觸發節拍，降低失誤率
- 多區域同步運作 — 支援多個偵測框同時工作
- 設定檔儲存/載入 — INI 檔自動保存上次設定
- 管理員權限檢查 — 確保遊戲控制權限正常
- 多語言介面 — 支援繁體中文和英文切換
- Windows 10 / 11
- AutoHotkey v2
- 棕色塵埃 2（Brown Dust 2）
- 安裝 AutoHotkey v2
- 下載本專案並解壓縮
- 執行
src\BrownDust2 Beat Helper.ahk（建議以管理員身份） - 調整偵測框位置與大小，點擊啟動
- 開始音樂小遊戲，享受穩定輸出
按 F3 顯示偵測框後，可拖拽調整位置。以下是建議的偵測框位置配置：
偵測框說明：
- 🔵 左側按鈕框 - 對準遊戲左側按鈕區域
- 🔴 右側按鈕框 - 對準遊戲右側按鈕區域
- ⚫ 連擊區域框 - 對準遊戲底部連擊判定區域
調整技巧：
- 拖拽紅框中央移動位置
- 拖拽四個黃色角落調整大小
- 按住滑鼠左鍵進行拖拽操作
- 設定會自動儲存到
Brown_Dust2_Settings.ini
- 直接下載並執行：
點此下載最新 Release - 或查看原始碼：
BrownDust2 Beat Helper.ahk
Bug 修復與 i18n 強化
- 🐛 語言系統修復 - 重寫 LoadLanguage，解決 IniRead 列舉錯誤與空白值破壞問題
- 🐛 Overlay 控制項錯位修復 - 修正 UpdateOverlayControls ClassNN 對應，補上四角點擊區定位
- 🐛 Tooltip Timer 洩漏修復 - 舊 timer 不再提前清除新 tooltip
- 🌐 全面 i18n - 狀態列、tooltip 訊息改為 GetText()，新增 3 組語言 keys
- 🔧 建置腳本 - 新增 build.ps1，一鍵編譯 exe 並打包 zip
- 🔧 錯誤處理改善 - 錯誤訊息不再覆蓋剪貼簿，改寫入 error.log
拖拽體驗大幅優化
- ✨ 平滑拖拽 - 修復拖拽移動時的劇烈抖動，實現絕對流暢的視覺效果
- 🎯 精準調整 - 修復調整大小時的抖動問題，紅框完美跟隨黑色方塊
- 📍 位置修正 - 解決方框跳回(0,0)的異常，確保在使用者調整位置正確停留
- 🎨 視覺一致 - 所有邊框、角落、文字控制項即時更新，無延遲顯示
- ⚡ 性能優化 - 降低更新頻率至30FPS，加入插值算法，減少CPU使用
- 🌐 多語言支援 - 新增繁體中文和英文介面切換功能
- 偵測框需對準遊戲內判定區域才能正確運作
- 遊戲更新可能影響顏色判斷，需要調整設定
- 僅供個人娛樂用途，禁止商業用途與競賽作弊
AutoHotkey v2 tool for Brown Dust 2 music mini-game automation.
Features draggable & resizable detection overlays, color detection, multi-zone support, and INI-based settings.
Perfect for hitting perfect beats without finger fatigue.
- Draggable & Resizable Detection Boxes — Freely align with game detection areas
- Color Detection Auto-Click — Precise beat triggering with reduced error rates
- Multi-Zone Synchronous Operation — Support multiple detection boxes working simultaneously
- INI Settings Save/Load — Automatically save previous settings to INI file
- Admin Permission Check — Ensure proper game control permissions
- Multi-Language Interface — Support Traditional Chinese and English switching
- Windows 10 / 11
- AutoHotkey v2
- Brown Dust 2
- Install AutoHotkey v2
- Download and extract this project
- Run
src\BrownDust2 Beat Helper.ahk(recommended as administrator) - Adjust detection box position and size, then click to start
- Begin the music mini-game and enjoy stable performance
Press F3 to display detection boxes, then drag to adjust positions. Here's the recommended detection box configuration:
Detection Box Guide:
- 🔵 Left Button Box - Align with game left button area
- 🔴 Right Button Box - Align with game right button area
- ⚫ Rapid Hit Box - Align with game bottom rapid hit detection area
Adjustment Tips:
- Drag the center of red boxes to move position
- Drag the four yellow corners to resize
- Hold left mouse button to perform drag operations
- Settings are automatically saved to
Brown_Dust2_Settings.ini
- Direct download and run:
Download Latest Release - Or view source code:
BrownDust2 Beat Helper.ahk
Bug Fixes & i18n Enhancements
- 🐛 Language system rewrite - Fixed IniRead enumeration and space-stripping bugs in LoadLanguage
- 🐛 Overlay control mapping fix - Corrected UpdateOverlayControls ClassNN offsets; restored corner click zones
- 🐛 Tooltip timer leak fix - Old timers no longer prematurely clear new tooltips
- 🌐 Full i18n coverage - Status bar and tooltips now use GetText(); added 3 missing language keys
- 🔧 Build script - Added build.ps1 for one-click .exe compilation and .zip packaging
- 🔧 Error handling - Errors now written to error.log instead of overwriting clipboard
Drag Experience Major Optimization
- ✨ Smooth Dragging - Fixed severe jitter when dragging movement, achieving absolutely smooth visual effects
- 🎯 Precision Adjustment - Fixed jitter issues when resizing, red boxes perfectly follow black boxes
- 📍 Position Correction - Resolved anomaly of boxes jumping to (0,0), ensuring correct positioning after user adjustment
- 🎨 Visual Consistency - All borders, corners, and text controls update instantly without delay
- ⚡ Performance Optimization - Reduced update frequency to 30FPS, added interpolation algorithms, reduced CPU usage
- 🌐 Multi-Language Support - Added Traditional Chinese and English interface switching
- Detection boxes must align with game detection areas to function properly
- Game updates may affect color detection, requiring setting adjustments
- For personal entertainment use only, commercial use and competition cheating prohibited
This project is licensed under MIT License: Free to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the software.
See LICENSE file for details.
💚 Green Tech Sponsor (Support Author)
Thank you to every supporter! 💖
