🎣 FishingBot - 釣魚助手

📖 專案簡介

FishingBot 是一款專為特定遊戲設計的自動釣魚輔助工具。它結合了電腦視覺 (OpenCV) 與自動化控制 (PyAutoGUI)，能夠精準識別遊戲內的浮標動態與張力指針，實現全自動拋竿、偵測咬鉤與收桿流程。

✨ 核心功能

• 視覺辨識咬鉤：透過監控遊戲內「魚餌數量」或「特定圖示」的像素變化，實現毫秒級反應。
• 智慧張力控制：即時分析張力條指針角度與速度，自動判斷何時該收線、何時該放線，防止斷線。
• 背景執行緒運作：自動化邏輯獨立於 UI 執行緒，操作流暢不卡頓。
• 參數高度客製：所有延遲、閾值、熱鍵皆可透過 settings.ini 或 UI 介面即時調整。

🚀 安裝與啟動指南

由於本軟體經過加密保護，初次使用請務必依照以下步驟操作，以免被防毒軟體誤刪。

1. 下載與解壓縮

1. 前往 Releases 下載最新的 .zip 壓縮包。
2. 請勿直接在壓縮檔內執行！ 請將整個資料夾解壓縮到您的桌面或任意目錄。

2. 防毒軟體設定 (關鍵步驟 ⚠️)

由於程式經過加殼，Windows Defender 可能會將其誤判為未知威脅。
請將解壓縮後的 資料夾 加入防毒軟體的「排除項目 (白名單)」：

• Windows Defender: 設定 > 更新與安全性 > Windows 安全性 > 病毒與威脅防護 > 管理設定 > 排除項目 > 新增或移除排除項目 > 新增資料夾。

3. 啟動程式

1. 進入資料夾，雙擊執行 FishingBot.exe。
2. 初次啟動需要加載依賴庫，請耐心等待約 5-10 秒。
3. 在彈出的黑色驗證視窗中，輸入您的 授權金鑰 (License Key) 並點擊登入。

🎮 使用教學

第一步：定位偵測區域

程式會自動生成 settings.ini 記憶您的設定，只需設定一次。

1. 設定指針區域：
   • 點擊程式左側的「設定指針區域」。
   • 框選遊戲中 張力條 / 指針移動範圍。
   • 按下 Enter 確認。
2. 設定咬鉤區域 (重要)：
   • 點擊程式左側的「設定咬鉤區域」。
   • 精準框選遊戲中 會變動的魚餌數字 (或咬鉤時會出現的驚嘆號)。
   • 注意：框選範圍越小越好，避免包含背景雜訊。
   • 按下 Enter 確認。

第二步：開始掛機

1. 在遊戲中裝備釣竿，走到水邊。
2. 按下鍵盤熱鍵 Page Up (或點擊介面上的「開始釣魚」)。
3. 程式將接管滑鼠，自動進行拋竿 -> 等待 -> 收桿的循環。
4. 若要暫停，再次按下 Page Up 即可。

⚙️ 參數調校指南

覺得釣魚效率不夠高？您可以透過右側面板微調參數：

參數類別	參數名稱	建議值	說明
拋竿前	拋竿時長 (s)	2.0	拋竿時長按滑鼠左鍵的時間。若拋太遠/太近可調整。
	拋竿後等待 (s)	2.0	拋竿後等待水花平靜的時間，避免剛拋竿就誤判。
	按 A 時長 (s)	0.05	針對部分遊戲需要按 'A' 鍵調整角度的操作時間。
等上鉤時	上鉤等待 (s)	20.0	若超過此時間沒魚上鉤，自動收回重拋。
	差分閾值	5.0	關鍵參數。控制咬鉤靈敏度，數值越小越靈敏，越大越抗干擾。
	確認幀數	1.0	連續偵測到幾次變化才確認為咬鉤。設為 1.0 表示即刻反應。
收桿時	指針丟失 (s)	0.2	若偵測不到指針超過此時間，視為收桿完成（魚上岸）。
	鬆開角度	60.0	當指針角度小於此數值 (張力過大) 時，鬆開滑鼠。
	鬆開速度	8.0	當指針移動速度過快時，鬆開滑鼠以防暴衝。
	最長收桿 (s)	29.0	若收桿超過此時間還沒拉上來，強制放棄 (避免卡死)。
	失敗冷卻 (s)	4.0	若判定收桿失敗，等待幾秒再進行下一次拋竿。
收桿後	收桿等待 (s)	1.8	魚上岸後的動畫等待時間。
	短按時間 (s)	0.2	用於關閉結算視窗或確認漁獲的點擊時間。
	下一輪等待 (s)	2.0	完成一次釣魚後，休息幾秒再開始下一輪。

❓ 常見問題 (Q&A)

Q: 按下熱鍵 (PageUp) 沒反應？

A: 請檢查鍵盤右側的 Num Lock 燈號是否亮起。若熄滅，數字鍵區的功能鍵可能會失效。(或是綁定其他熱鍵)

Q: 魚上鉤了 (數字變了) 但程式沒反應？

A:

1. 請重新設定「咬鉤區域」，確保框選範圍精準。
2. 嘗試調低「差分閾值」。

💬 專屬客戶支援

如需技術協助、回報問題或進行授權續費，請前往我們的 Discord 伺服器建立工單 (Ticket)。