🧪 Sun Potion System - 藥水系統

📖 插件概述

這是一款專為 FiveM 伺服器打造的全新模組化藥水系統。內建 8 種具備獨特效果的藥水，從基礎的生命恢復到強大的超能力提升，應有盡有。透過先進的效果堆疊機制、現代化 UI 顯示以及完善的權限管理，為您的伺服器提供既平衡又豐富的 RPG 體驗。

💰 販售資訊

• 官方託管售價： 750 TWD
• 購買連結： 👉 點我前往商城購買

✨ 功能介紹

🧪 多樣化藥水系統 (支援自行添加)

• 8 種預設藥水：涵蓋回血、速度、力量、跳躍、游泳、飽食、補水與護甲。
• 持續性效果：基礎效果持續 5 分鐘，提供穩定的增益體驗。
• 智慧效果堆疊：支援同類藥水連續使用，效果最高可堆疊至 30 分鐘。
• 防濫用冷卻：內建 5 秒使用冷卻機制，確保伺服器戰鬥平衡。

🌐 完整多語言支援

• 雙語切換：預設支援繁體中文與英文。
• 獨立語言模組：不依賴框架的翻譯系統，修改更簡單。
• 自動回退機制：若遺失翻譯條目將自動使用預設語言，確保介面不異常。

🛠️ 進階管理功能

• 強大指令集：內建 8 個管理指令，包含批量發放與系統診斷。
• 系統自我診斷：使用 /superdiag 快速檢測系統運行狀態與 Webhook 連線。
• Discord 整合：支援 Webhook 通知，所有管理員的操作行為皆可即時回傳紀錄。

📱 頂級使用者介面 (UI)

• 現代化設計：漸變色調與平滑動畫，介面質感大幅提升。
• 即時狀態看板：螢幕即時顯示剩餘時間與堆疊層數，資訊透明。
• 響應式佈局：自動適應各種螢幕解析度，UI 永久保持最佳比例。

🧪 藥水效果清單

• ❤️ 回血藥水：每秒恢復 5 點生命值 | 最長可堆疊至 30 分鐘
• ⚡ 腎上腺素：移動速度 +49%，體力無限 | 最長可堆疊至 30 分鐘
• 💪 力量藥水：武器傷害 +50% | 最長可堆疊至 15 分鐘
• 🦘 跳躍藥水：開啟超級跳躍能力 | 最長可堆疊至 10 分鐘
• 🏊 游泳藥水：速度 +80% 且潛水時間延長 | 最長可堆疊至 20 分鐘
• 🍖 飽食藥水：持續補充飢餓值 | 最長可堆疊至 30 分鐘
• 💧 補水藥水：持續補充水分值 | 最長可堆疊至 30 分鐘
• 🛡️ 護甲藥水：每 2 秒恢復 5 點護甲值 | 最長可堆疊至 20 分鐘

⌨️ 管理指令列表

• /givepotion [ID] [類型] [數量]：給予指定玩家藥水 (管理員)。
• /giveallpotions [ID] [數量]：一次發放全套藥水 (管理員)。
• /clearpotion [ID]：強制清除玩家身上的所有效果 (管理員)。
• /testpotion [類型]：快速測試藥水功能 (管理員)。
• /reloadpotion：無損重新載入設定檔 (管理員)。
• /superdiag：執行系統完整診斷 (管理員)。
• /testwebhook：測試 Discord 通知連線 (管理員)。
• /potioninfo：玩家查看當前自身效果 (所有玩家)。

⚙️ 技術規格與安裝

系統需求

• 框架支援：ESX Legacy
• 依賴需求：esx_status（用於飢餓與水分恢復）
• 語言：繁體中文、英文（可於設定檔擴展）

安裝步驟

1. 將 sun_potion 資料夾放入伺服器 resources 目錄。
2. 在 server.cfg 中添加 ensure sun_potion。
3. 確認 esx_status 已正常啟動。
4. 根據需求修改 config.lua 中的倍率與時間參數。
5. 重啟伺服器或執行指令啟動系統。