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

## 插件概述
Sun RealStock TW 是一個為 FiveM 伺服器設計的真實股票交易系統，基於 ESX 框架開發，支援台股即時數據（台灣證券交易所 API），玩家可以在遊戲中進行股票買賣、查看即時行情、內建專業的 K 線圖表，讓玩家在遊戲中也能進行技術分析，並透過排行榜系統，展現您的獲利實力！

# 販售價格

- 託管售價: 2000

# 功能介紹

- 📈 **台股即時數據** - 整合台灣證券交易所公開 API，提供真實台股行情
- 💰 **股票交易系統** - 完整的買賣機制，含手續費（0.1425%）與證交稅（0.3%）計算
- 📊 **投資組合管理** - 即時顯示持倉、損益、投資報酬率等資訊
- 📉 **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 秒（可自訂）

## 基本操作
- 前往遊戲內「股票交易所」地點按 `E` 鍵開啟介面
- 或使用指令 `/stocknow` 直接開啟（無需位置限制）
- 按 `ESC` 或介面上的關閉按鈕退出

## 預設股票清單
**台股（TWSE）:**
- 2330.TW - 台積電
- 2317.TW - 鴻海
- 2454.TW - 聯發科
- 2308.TW - 台達電
- 2412.TW - 中華電
- 2882.TW - 國泰金
- 2881.TW - 富邦金
- 2884.TW - 玉山金
- 2303.TW - 聯電
- 3711.TW - 日月光投控

**美股（可選）:**
- AAPL、GOOGL、MSFT、TSLA、NVDA

## 成就獎勵
- 🎯 首次交易 - 獎勵 $1,000
- 💵 賺取 $10,000 - 獎勵 $5,000
- 💰 賺取 $100,000 - 獎勵 $20,000
- 💎 賺取 $1,000,000 - 獎勵 $100,000
- 📊 完成 100 筆交易 - 獎勵 $10,000
- 🏦 持倉價值達 $500,000 - 獎勵 $25,000

## 技術規格

- 框架支援：ESX Legacy 框架
- 依賴需求：es_extended、mysql-async
- 資料庫：MySQL/MariaDB
- API 來源：台灣證券交易所（TWSE）、Yahoo Finance（備用）
- 語言支援：繁體中文、簡體中文、英文（可擴展）

## 常見問題

**Q: 如何新增自訂股票？**
A: 編輯 `config.lua` 中的 `Config.DefaultStocks` 陣列

**Q: Discord 通知沒有發送？**
A: 檢查 Webhook URL 是否正確，並確認 `Config.DiscordWebhook.Enabled = true`

**Q: 玩家餘額不足但顯示有錢？**
A: 確認使用的是現金（cash）而非銀行存款

**注意事項：**
- 建議定期備份資料庫中的交易記錄
- 系統支援多人同時使用，無需擔心效能問題