Sun RealStockTW - 真實股票交易系統

📈 Sun RealStockTW - 真實股票交易系統

📖 插件概述

Sun RealStock TW 是一款專為 FiveM 伺服器打造的高級股票交易插件。本插件基於 ESX 框架 開發，整合了 台股即時數據（台灣證券交易所 API）。玩家可以身歷其境地在遊戲中進行股票買賣、追蹤即時行情，並透過現代化的 Web UI 介面管理個人投資組合。

💰 販售資訊

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

📺 演示影片

展示影片：https://youtu.be/jx7QIZcFIKc

✨ 功能介紹

• 📈 台股即時數據：整合台灣證券交易所公開 API，同步真實市場行情。
• 💰 完善交易機制：包含買入、賣出，並自動計算手續費（0.1425%）與證交稅（0.3%）。
• 📊 資產管理中心：即時顯示持倉詳情、盈虧狀況及投資報酬率（ROI）。
• 📉 專業 K 線圖表：內建 Chart.js，支援技術分析視圖，掌握價格走勢。
• 🎯 智能限價單：支援設定目標價自動成交（每人最多 20 筆活躍訂單）。
• 📜 詳盡交易歷史：完整記錄每一筆交易行為，方便回溯損益。
• 🏆 成就獎勵系統：內建 6 種交易成就，解鎖後可自動獲得遊戲幣獎勵。
• 📊 財富排行榜：顯示伺服器獲利前 10 名的明星交易員。
• 🔔 Discord 整合：透過 Webhook 即時通知所有買賣活動。
• 🗺️ 實體交易所：地圖內建兩個實體交易地點，包含地圖標記（Blip）。
• 💻 現代化 Web UI：極簡精美的網頁式操作介面，提升遊戲沈浸感。
• 🌐 多語言支援：支援繁體中文、簡體中文、英文（可自行擴展）。

🚀 效能與規格

效能數據

• 閒置狀態： 0.00 ms ~ 0.01 ms
• 運作中： 0.01 ms ~ 0.03 ms
• API 更新間隔： 預設 60 秒（可於設定檔自訂）

技術要求

• 框架支援： ESX Legacy
• 依賴插件： es_extended, mysql-async (或 oxmysql)
• 資料庫： MySQL / MariaDB
• 數據來源： 台灣證券交易所 (TWSE)、Yahoo Finance (備用)

🎮 操作指南

• 地點觸發： 前往地圖上的「股票交易所」，靠近櫃檯按 E 鍵開啟。
• 遠端指令： 輸入 /stocknow 即可不受地點限制隨時開啟。
• 退出介面： 按下 ESC 或點擊介面右上角的關閉按鈕。

📂 預設股票清單

代碼

名稱

市場

2330.TW

台積電

TWSE

2317.TW

鴻海

TWSE

2454.TW

聯發科

TWSE

2308.TW

台達電

TWSE

2412.TW

中華電

TWSE

AAPL / TSLA

蘋果 / 特斯拉

美股 (選配)

🏆 成就獎勵一覽

1. 首次交易：獎勵 $1,000
2. **賺取 $10,000**：獎勵 $5,000\
3. **賺取 $100,000**：獎勵 $20,000\
4. **賺取 $1,000,000**：獎勵 $100,000\
5. 完成 100 筆交易：獎勵 $10,000
6. **持倉價值達 $500,000**：獎勵 $25,000\

🛠️ 常見問題 (FAQ)

Q: 如何新增自訂股票？

A: 請編輯 config.lua 中的 Config.DefaultStocks 列表，加入對應的 Yahoo Finance 代碼。

Q: Discord 通知沒有反應？

A: 請確認 Webhook URL 是否填寫正確，並檢查 Config.DiscordWebhook.Enabled 是否設定為 true。

Q: 系統判定餘額不足？

A: 本系統預設扣除玩家身上的現金（Cash），請確認玩家身上攜帶足夠現金而非僅有銀行存款。

⚠️ 注意事項：

• 建議定期備份資料庫中的交易記錄表。
• 系統經優化，支援多人同時操作，不會影響伺服器流暢度。