扭蛋系統
插件

扭蛋系統

插件2025-12-14

🔮 Sun GachaBall - 專業級扭蛋抽獎系統

📖 插件概述

Sun GachaBall 是一款為 FiveM 伺服器深度打造的虛擬抽獎系統。基於 ESX 框架 開發,整合了現代遊戲流行的抽獎機制。玩家可以使用特定的扭蛋物品進行充滿驚喜的隨機抽獎,系統內建完整的保底與里程碑功能,能有效提升伺服器的玩家活躍度與經濟循環。


💰 販售資訊

📺 演示影片


點擊觀看實機演示:https://youtu.be/o1mGUhcutdk


✨ 功能介紹

  • 🎯 四層等級獎勵:內建「普通(灰)」、「稀有(綠)」、「傳說(金)」、「神話(紅)」四種稀有度,視覺效果層次分明。
  • 🛡️ 雙重保底系統
    • 軟保底:達到次數後,神話級大獎的機率會隨抽數遞增。
    • 硬保底:達到指定次數後,下次抽獎必中神話級大獎,保險機制讓玩家更願意投入。
  • 🏆 里程碑獎勵系統:累積抽獎次數可自動獲得額外獎勵,鼓勵玩家長期參與,所有里程碑階級皆可自由定義。
  • 🎬 流暢動畫效果:具備精美的旋轉動畫,支援自定義動畫速度、顯示數量與旋轉時長。


🚀 性能與規格

效能數據

  • 閒置狀態: 0.00 ms ~ 0.01 ms
  • 運作中: 0.01 ms ~ 0.04 ms

技術要求

  • 框架支援: ESX Legacy / ESX Extended
  • 必備依賴: es_extended, ox_inventory, oxmysql


🛠️ 常見問題 (FAQ)

Q: 如何新增自訂扭蛋類型?

A: 編輯 config.lua 中的 Config.Gachas 表格,複製現有的配置區塊並修改名稱與參數即可。

Q: 如何修改獎品清單?

A: 在對應的扭蛋配置中編輯 Rewards 區段,分別設定各個等級對應的物品代碼與數量。

Q: 保底系統重置機制?

A: 當玩家抽中「神話級」獎品(無論是運氣中獎還是硬保底觸發)後,該類別扭蛋的保底計數器將會自動重置。

Q: 介面動畫可以調整嗎?

A: 可以,在 config.lua 的 Config.Animation 中,可調整 SpinDuration (時長)、ItemsToShow (顯示個數) 等。


⚠️ 注意事項

  1. 物品定義:所有獎品物品必須先在 ox_inventorydata/items.lua 中定義完成。
  2. 機率計算:修改獎品機率後,請務必確認該類別總機率相加為 100%,否則可能導致邏輯異常。
  3. 定期維護:購買後享有專業技術團隊提供的售後諮詢與架設協助。